这套配置解决什么问题

  • Solopreneur 在国内,直连 api.anthropic.com 不稳
  • 没办海外卡,官方账号注册卡住
  • 想用 Claude Opus 4.7 跑代码,但月预算想压在 200 美金以内
  • 团队 2-5 人,需要统一 key 管理

准备工作

你需要

  • Claude Code CLI 最新版(2026 年版本)
  • 一家中转方的 key + baseURL(选「支持 Claude Opus 4.7 / Sonnet 4.6」的中转)
  • 一台开发机(Mac / Linux / WSL)

不需要

  • 海外信用卡(中转方一般支持国内支付)
  • 海外公司主体
  • VPN(走中转后国内可直连)

步骤一:拿到中转方 key 与 baseURL

注册中转方账号

选一家「主推 GPT-5.5 / Claude 4.7」、明确写支持 Anthropic API 协议兼容的中转。注册账号,充值少量额度(50-100 美金)做测试。

在管理后台拿 key

测试 key 可用

curl https://你的中转域名/v1/messages \
  -H "x-api-key: 你的key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-7",
    "max_tokens": 100,
    "messages": [{"role":"user","content":"hi"}]
  }'

正常返回 JSON 带 content 字段即配置 OK。报 401 检查 key、报 404 检查 baseURL 路径。

步骤二:配置 ANTHROPIC_BASE_URL 与 API_KEY

在 shell 配置文件加环境变量

编辑 ~/.zshrc(Mac 默认)或 ~/.bashrc(Linux 默认),末尾加:

export ANTHROPIC_BASE_URL=https://你的中转域名/v1
export ANTHROPIC_API_KEY=sk-ant-你的key

生效

source ~/.zshrc

或新开一个终端窗口。

验证环境变量

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY | head -c 12

确认输出符合预期。

步骤三:启动 Claude Code

启动并测试

在项目目录跑:

claude

进入对话界面,试一句简单问题。如果返回正常,说明走中转的链路通了。

验证流量真的走中转

启动时加 —verbose 或在中转方后台看请求日志。确认请求计数真的增加,而不是悄悄回退到默认 api.anthropic.com。

模型切换

Claude Code 默认走 claude-opus-4-7。在配置里可以指定 sonnet 或 haiku:

claude --model claude-sonnet-4-6

Solopreneur 日常推荐 Sonnet 4.6 主路,只在复杂任务切 Opus 4.7。

步骤四:模型分级与月预算

Solopreneur 三档分级

任务类型推荐模型
简单修复、加 log、加 typingHaiku 4.5
普通功能开发、bug 定位Sonnet 4.6
复杂重构、Agent 模式Opus 4.7

月预算控制

  • 中转方后台设月预算上限,触顶停服(避免超支)
  • 单日 token 告警(超过 P95 三倍的日用量发邮件)
  • 每周 review 一次大头消耗,看是否值得切档

估算样例

Solopreneur 重度用户日均 6 小时 Claude Code,月 token 50-100M。中转加价 15% 下月预算估算:

模型档占比月预算估算
Haiku 4.520%≈ 10-20 美金
Sonnet 4.650%≈ 80-150 美金
Opus 4.730%≈ 150-300 美金
月总计100%≈ 240-470 美金

步骤五:团队协作小坑

多人共用一个 key 的坑

  • 用量看板分不清谁用多少
  • 某个人滥用整个团队额度被烧
  • 限额触发后所有人被卡住

推荐方案

3-5 人团队建议:

  • 中转方主账号统一充值
  • 给每人开独立子 key
  • 中转方后台单 key 设限额
  • 月底对账,识别异常用户

进阶:自托管 OneAPI 做内部网关

  • 内部发布内部 key(可任意吊销)
  • 真正中转 key 不下发到开发机
  • 用量统一统计,审计干净

跨地区使用与环境检查

跨设备搬配置

Claude Code 配置主要是 ANTHROPIC_BASE_URL 与 API_KEY 两个环境变量,搬迁简单。推荐方法:

  • 把 shell 配置(.zshrc / .bashrc)放进 git 私库 dotfiles
  • 新设备 git clone 后 source 一下即可
  • API_KEY 单独管理(可用 1Password CLI / pass 注入)

出差 / 海外切换

Solopreneur 出海时,有时需要换中转方(国内中转方在海外可能延迟高)。可以在 ~/.zshrc 里准备两套环境变量,出差时切换:

# 国内
export ANTHROPIC_BASE_URL=https://国内中转域名/v1
# 海外切换
# export ANTHROPIC_BASE_URL=https://海外中转域名/v1

或者用一条Cursor / Claude Code 国内可用的 API 中转,既兼顾国内主路,又能在海外切换不同节点,不用为不同环境维护多套配置。

排错清单

  • baseURL 末尾 /v1 后缀对不对
  • key 是否被中转方风控(检查后台)
  • 模型名映射(claude-opus-4-7 还是 opus-4.7)
  • Claude Code 版本是否过旧(老版本可能不支持 ANTHROPIC_BASE_URL)
  • 系统代理是否劫持请求(系统层 VPN 可能影响)

常见报错

Error: invalid API key

  • 检查 key 是否复制完整
  • 检查 key 是否在中转方后台启用
  • 检查 ANTHROPIC_API_KEY 环境变量是否真的被 export

Error: model not found

  • 中转方模型名映射跟官方不一致,改用中转方支持的全名
  • 中转方未启用 Opus 4.7,联系客服开通

Error: timeout

  • 网络延迟高,换近的中转节点
  • 中转方限流,降低并发或换更高档套餐

相关阅读