限时 · 同款 GPT 0.5折、Claude 3折
博客
Guide

用 OmniaKey 跑 Claude Code

把 Claude Code 指向 OmniaKey 的 Anthropic 原生端点——两个环境变量,Claude 模型绝不被偷换,按 token 计费、没有月费。

4 分钟阅读OmniaKey
Claude CodeAnthropicsetupAPI gateway

Claude Code 只说一种协议:Anthropic 的 Messages API。这是有意为之——agent 循环、MCP server、工具调用全都构建在它之上。OmniaKey 原生提供这套协议,所以把 Claude Code 指过来只需两个环境变量,其他什么都不用动。你换来的是:一把 key、一份余额,跟你跑的所有工具共享;按 token 计费、没有月费;以及一个保证——你请求的 model id 就是实际在跑的那个。

接入

dashboard 创建一把 key,设两个变量,启动:

bash
export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude

streaming、工具调用、长上下文全部原样透传——Claude Code 仍以为自己在直连 Anthropic。

别在 base URL 后面加 /v1 Claude Code 会自己补 /v1/messages,所以 https://api.omniakey.com/v1 会变成 /v1/v1/messages 然后报 404。填裸域名,后面不带路径。

选模型

在会话里用 /model 切换:

text
/model claude-opus-4-8

OmniaKey 上的 Claude id 有 claude-opus-4-8(旗舰,1M 上下文)、claude-sonnet-4-6(均衡)、claude-haiku-4-5(快,200K)。你传哪个 id 就跑哪个——OmniaKey 绝不偷偷替换、量化或蒸馏。

GPT 和 Gemini:是协议边界,不是限制

Claude Code 只驱动 Claude。这是 Anthropic 协议本身决定的,不是 OmniaKey 的限制——没有任何网关能在不弄坏工具的前提下让 Claude Code 跑 GPT 或 Gemini。要在 agent 里用这两家,把一个 OpenAI 兼容工具(Cursor、Cline、aider、Codex、OpenClaw)指向 OmniaKey 的 OpenAI 兼容端点——也就是下面那个 /v1——只需换 model id:gpt-5.5gemini-3.1-pro-preview 跟 Claude id 一样跑。

OpenAI-compatible
https://api.omniakey.com/v1
Anthropic-native
https://api.omniakey.com
Gemini-native
https://api.omniakey.com/v1beta

OmniaKey 用一把 key 暴露全部三个 surface。编程工具走 OpenAI 兼容的 /v1;Gemini 原生的 /v1beta 是给 Google 自家 Gemini SDK 用的。编程 agent 指南 有每个工具的接法。

为什么 agent 里“可预测”很重要

有些网关会在高峰期把你的请求改道到“更便宜的等价模型”——这在编程 agent 里是真隐患:换个模型,工具调用的格式、对代码库的理解都会变,跑到一半被掉包,可能毁掉一次跨文件改动。OmniaKey 的规矩很简单——你请求的 provider 和模型,就是实际在跑的那个。上游不可用时,你会看到报错,然后自己显式换一个模型。