用自己的 API 密钥运行 Claude Code
设置两个环境变量,Claude Code 就运行在你的 UplinkSwitch 密钥上。同样的工具,同样的模型,实时价格。
核对于 2026-11-13
准备工作
- 已安装 Claude Code,并且
claude在你的 PATH 中。 - 从控制台获取的 UplinkSwitch 密钥,并且账户已有余额。额度预付,$10 起,支持微信支付、银行卡、Apple Pay、Google Pay 或加密货币。
两个变量
ANTHROPIC_BASE_URL让 Claude Code 指向 UplinkSwitch。粘贴时带上/v1。网关接受 Claude Code 由它拼出的路径。ANTHROPIC_AUTH_TOKEN以Authorization: Bearer发送密钥。也可以改用ANTHROPIC_API_KEY,它以x-api-key发送密钥。二选一,不要同时设置。- 同时带有两个不同密钥的请求会被拒绝,返回
400。 - 只设 base URL 不够。没有任一密钥变量时,Claude Code 会继续使用已保存的 claude.ai 登录。
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claude写进 settings.json 长期生效
把两个变量加到 ~/.claude/settings.json 的 env 下,它们对所有项目生效。.claude/settings.local.json 只对单个项目生效。
- 另有三个变量指定各别名背后的模型:
ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL和ANTHROPIC_DEFAULT_HAIKU_MODEL。把它们设为claude-opus-5-5、claude-sonnet-5-5、claude-haiku-5-5这样的 ID。 - 不要把密钥写进项目的
.claude/settings.json。这个文件本来就是要提交并共享的。 - shell 的 export 和设置文件设了同一个变量时,以设置文件为准。
- VS Code 扩展从它自己的设置项
claudeCode.environmentVariables读取凭据,该项位于 VS Code 的用户设置中。
选择模型
opus、sonnet 和 haiku 三个别名解析为上述三个模型变量指定的模型。设置 Haiku 变量后,生成会话标题等后台任务也会改用该模型。在会话中用 /model 切换,启动时用 claude --model claude-opus-5-5 指定,或用 ANTHROPIC_MODEL 为单次会话指定。
Claude Code 使用 Anthropic 的 API 格式,这里的每个聊天模型都以该格式提供,包括 GPT、Gemini、DeepSeek、Kimi 和无审查版本。模型列表里的任意聊天模型 ID 都能填进同样的变量,并以 Messages 响应返回,工具调用也包括在内。
用这个密钥跑 Claude Code 的费用
表格列出各 Claude 模型每百万 token 的价格,实时取自目录,旁边是 Anthropic 公布的官方价。密钥可用的全部 Claude 模型见 Claude API 价格页。
Claude Code 每一轮都会发送整段对话,并为 prompt cache 做标记。从缓存读取的 token 按缓存价计费,只是输入价的一小部分。缓存默认保留五分钟,所以间隔更久之后的那一轮,会对整个上下文按输入价计费一次。
Claude Code 显示的费用是它自己按 Anthropic 官方价做的估算。你实际支付的金额见控制台的“用量”页。
| 模型 | 输入 | 缓存输入 | 输出 | 上下文 |
|---|---|---|---|---|
| Claude Fable 5.2claude-fable-5.2Anthropic | $4.00官方价 $8.00 | $0.10官方价 $0.20 | $20.00官方价 $40.00 | 1,000,000 |
| Claude Fable 5.1claude-fable-5.1Anthropic | $6.00官方价 $10.00 | $2.00官方价 $0.25 | $30.00官方价 $50.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5Anthropic | $2.716官方价 $4.00 | $0.1455官方价 $0.20 | $9.70官方价 $20.00 | 1,000,000 |
| Claude Sonnet 5.5claude-sonnet-5-5Anthropic | $1.20官方价 $2.00 | $0.075官方价 $0.10 | $3.00官方价 $10.00 | 1,000,000 |
| Claude Haiku 5.5claude-haiku-5-5Anthropic | $0.0582官方价 $0.10 | $0.01官方价 $0.01 | $0.1455官方价 $0.50 | 1,000,000 |
| Claude Fable 5claude-fable-5Anthropic | $3.00官方价 $10.00 | $0.30官方价 $1.00 | $15.00官方价 $50.00 | 1,000,000 |
| Claude Opus 5claude-opus-5Anthropic | $1.80官方价 $5.00 | $0.16官方价 $0.50 | $7.50官方价 $25.00 | 1,000,000 |
| Claude Sonnet 5claude-sonnet-5Anthropic | $1.20官方价 $2.00 | $0.12官方价 $0.20 | $3.00官方价 $10.00 | 1,000,000 |
| Claude Opus 4.8claude-opus-4-8Anthropic | $1.80官方价 $5.00 | $0.16官方价 $0.50 | $7.50官方价 $25.00 | 1,000,000 |
| Claude Opus 4.7claude-opus-4-7Anthropic | $1.80官方价 $5.00 | $0.16官方价 $0.50 | $7.50官方价 $25.00 | 1,000,000 |
| Claude Opus 4.6claude-opus-4-6Anthropic | $1.80官方价 $5.00 | $0.16官方价 $0.50 | $7.50官方价 $25.00 | 1,000,000 |
| Claude Sonnet 4.6claude-sonnet-4-6Anthropic | $1.80官方价 $3.00 | $0.18官方价 $0.30 | $9.00官方价 $15.00 | 1,000,000 |
| Claude Haiku 4.5claude-haiku-4-5Anthropic | $0.60官方价 $1.00 | $0.06官方价 $0.10 | $3.00官方价 $5.00 | 200,000 |
美元 / 百万 token
确认配置生效
发送一条简短的消息。加上 -i 后,curl 会打印响应头:x-uplink-request-id 是请求的标识,x-uplink-charge 是它的费用,以美元计。
然后运行 claude。请求会在几秒内出现在控制台里。在 Claude Code 中,/status 会显示一行 Anthropic base URL,内容是 UplinkSwitch 的地址,另有一行写明你设置的密钥变量。如果没有 base URL 这一行,说明变量没有传到会话里。
curl -i https://api.uplinkswitch.com/v1/messages \
-H "Authorization: Bearer sk-uplink-live-..." \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "claude-fable-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'错误与解决办法
invalid_api_key(401):密钥错误或已吊销,或者密钥放在了 Claude Code 没有读取的变量里。用/status检查。insufficient_balance(402):在控制台充值。monthly_limit_reached(402)表示该密钥达到了为它设置的月度消费上限。model_not_found(404):这个 ID 不在模型列表里。检查模型变量有没有拼写错误。- curl 测试正常,Claude Code 却要求登录:在 shell 的 export 或
~/.claude/settings.json里设置密钥。项目设置文件要在首次运行设置和信任确认之后才生效。 - 启动时的警告提到两个凭据来源:已保存的登录和变量同时生效。运行
/logout,只保留密钥。 - 设置了
ANTHROPIC_API_KEY却被忽略:它需要一次性批准。在/config下打开 Use custom API key,或者改用ANTHROPIC_AUTH_TOKEN。