用自己的 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 登录。
shell
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.001,000,000
Claude Fable 5.1claude-fable-5.1Anthropic$6.00官方价 $10.00$2.00官方价 $0.25$30.00官方价 $50.001,000,000
Claude Opus 5.5claude-opus-5-5Anthropic$2.716官方价 $4.00$0.1455官方价 $0.20$9.70官方价 $20.001,000,000
Claude Sonnet 5.5claude-sonnet-5-5Anthropic$1.20官方价 $2.00$0.075官方价 $0.10$3.00官方价 $10.001,000,000
Claude Haiku 5.5claude-haiku-5-5Anthropic$0.0582官方价 $0.10$0.01官方价 $0.01$0.1455官方价 $0.501,000,000
Claude Fable 5claude-fable-5Anthropic$3.00官方价 $10.00$0.30官方价 $1.00$15.00官方价 $50.001,000,000
Claude Opus 5claude-opus-5Anthropic$1.80官方价 $5.00$0.16官方价 $0.50$7.50官方价 $25.001,000,000
Claude Sonnet 5claude-sonnet-5Anthropic$1.20官方价 $2.00$0.12官方价 $0.20$3.00官方价 $10.001,000,000
Claude Opus 4.8claude-opus-4-8Anthropic$1.80官方价 $5.00$0.16官方价 $0.50$7.50官方价 $25.001,000,000
Claude Opus 4.7claude-opus-4-7Anthropic$1.80官方价 $5.00$0.16官方价 $0.50$7.50官方价 $25.001,000,000
Claude Opus 4.6claude-opus-4-6Anthropic$1.80官方价 $5.00$0.16官方价 $0.50$7.50官方价 $25.001,000,000
Claude Sonnet 4.6claude-sonnet-4-6Anthropic$1.80官方价 $3.00$0.18官方价 $0.30$9.00官方价 $15.001,000,000
Claude Haiku 4.5claude-haiku-4-5Anthropic$0.60官方价 $1.00$0.06官方价 $0.10$3.00官方价 $5.00200,000

美元 / 百万 token

确认配置生效

发送一条简短的消息。加上 -i 后,curl 会打印响应头:x-uplink-request-id 是请求的标识,x-uplink-charge 是它的费用,以美元计。

然后运行 claude。请求会在几秒内出现在控制台里。在 Claude Code 中,/status 会显示一行 Anthropic base URL,内容是 UplinkSwitch 的地址,另有一行写明你设置的密钥变量。如果没有 base URL 这一行,说明变量没有传到会话里。

curl
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。

常见问题

能。这里的每个聊天模型都以 Anthropic 格式提供,所以 GPT、Gemini、DeepSeek 或无审查模型的 ID 都能填进模型变量,并以 Messages 响应返回,工具调用也包括在内。

能。缓存输入按缓存价计费。在请求记录里,缓存读取 token 数大于零就说明缓存生效了。

Remote Control 和语音听写需要 claude.ai 登录,所以设置了密钥变量时它们不可用。在非 Anthropic 的主机上 MCP 工具搜索是关闭的,设置 ENABLE_TOOL_SEARCH=true 可以打开。

取消设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN,如果写进了 settings.json,也一并删除。

控制台的“用量”页显示你实际支付的金额。单个请求可以按请求 ID 查询。记录里列出输入 token、缓存读取 token、输出 token 和以美元计的扣费,大约一分钟内写入日志。

在控制台预付充值,$10 起,支持微信支付、银行卡、Apple Pay、Google Pay 或加密货币,无订阅。每次充值后价格锁定 30 天。

获取用于 Claude Code 的密钥

两个变量,预付 $10 起,无订阅,每次充值后价格锁定 30 天。

获取密钥
Join on Telegram