Claude Code 国内使用指南（2026）：两个环境变量完成 API 接入
Claude Code 是 Anthropic 官方的终端 AI 编程工具，但在国内直接使用会卡在两件事上：官方 API 的开通与支付门槛，以及网络可达性。本文给出目前最省事的一条路径——通过 OpenAI / Anthropic / Gemini 三协议兼容的多模型网关汕拓智算接入，只需要设置两个环境变量，Claude Code 本体零改动。
接入原理：Claude Code 是怎么找到服务端的
Claude Code 和 Anthropic 官方 SDK 一样，遵循两个约定俗成的环境变量：
ANTHROPIC_BASE_URL：API 的基础地址。客户端会在它后面自动补上/v1/messages请求路径。ANTHROPIC_AUTH_TOKEN：鉴权令牌。
也就是说，任何实现了 Anthropic Messages 协议的兼容端点，都可以无缝承接 Claude Code 的全部请求——工具本身不需要任何补丁或魔改。汕拓智算的 Anthropic 兼容面就是为此设计的：同一个域名按密钥分组自动路由到对应协议，请求与响应格式与官方完全一致。
三步接入
第一步：创建一个 Anthropic 分组的 API 密钥
在控制台注册并登录后，创建 API 密钥。关键点：密钥所属分组的平台必须是 Anthropic——分组平台决定这把密钥走哪套协议面，用错分组是后面 401/404 报错的头号原因。
密钥形如 sk-...，创建后妥善保存。
第二步：设置两个环境变量
bash
export ANTHROPIC_BASE_URL="https://swato.ai"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"注意 ANTHROPIC_BASE_URL 只填域名本身。客户端会自动追加 /v1/messages，如果你手动带上这个后缀，反而会拼出错误的路径。
想让配置长期生效，把这两行写进 ~/.zshrc 或 ~/.bashrc。
第三步：启动并验证
bash
claude先跑一个只读的小任务，例如让它总结当前项目的目录结构。然后做一次完整的链路验证：
- 客户端：Claude Code 正常启动、能读到项目内容。
- 网关：请求确实打到了兼容端点，而不是走了系统里残留的旧代理配置。
- 账本：到控制台的用量台账里确认这次调用有记录——能看到模型、输入/输出 token、费用和 trace id，就说明整条链路是通的。
第三步很重要。每一笔调用都留痕、都能对账，是判断一个 API 服务是否值得长期使用的基本信号；接入时顺手养成看台账的习惯，后面账单出现任何异常都能逐笔定位。
常见报错速查
| 现象 | 原因 | 处理 |
|---|---|---|
401 Unauthorized | 密钥无效，或环境变量没在当前 shell 生效 | 确认密钥是本站签发的；echo $ANTHROPIC_AUTH_TOKEN 检查变量 |
404 | 密钥分组的平台不是 Anthropic | 到控制台用 Anthropic 分组重新创建密钥 |
429 | 触发限流 | 按指数退避重试；限额与套餐相关，详见控制台 |
| 连接超时 / 反复重连 | 系统代理或旧配置劫持了请求 | 直连方案不需要代理，清理终端里的 HTTP(S)_PROXY 残留变量 |
| 模型报不存在 | model ID 凭记忆填写 | 调用 GET /v1/models，以返回的确切 ID 为准 |
成本怎么算
汕拓智算按调用计费，规则很简单：
- 按官方定价结算，不加价：费用对齐模型方官方价格，中间不加 markup。
- 失败 / 超时不计费：上游报错的请求不产生费用。
- 输入与输出分开计量：单次费用 = 输入 token × 输入单价 + 输出 token × 输出单价。
在售的 Claude 系列（Opus、Sonnet 等）与 GPT、Gemini、DeepSeek 等 50+ 模型共用同一个入口，确切型号与单价以模型价格页为准。这也意味着你可以在 Claude Code 之外，用同一把账号体系接入 Codex、Cursor 等其它工具，账单合并在同一本账里。
相关阅读
常见问题
Claude Code 国内使用需要梯子吗？
走国内网关直连时不需要。把 ANTHROPIC_BASE_URL 指向国内可达的兼容端点（如 https://swato.ai），流量全程走常规 HTTPS，不依赖系统代理。反而要注意关闭残留的代理配置，避免请求被旧代理劫持导致超时。
为什么我的密钥调用 Claude 模型返回 401 或 404？
最常见原因是密钥分组的平台不是 Anthropic。汕拓智算的每个密钥都属于一个分组，分组平台决定协议面；用 OpenAI 分组的密钥调 /v1/messages 会被拒绝。到控制台确认分组平台后重新创建密钥即可。
用网关接入 Claude Code 比官方贵吗？
汕拓智算按模型官方定价结算，不加价、无隐藏费用，失败和超时的请求不计费。确切单价以控制台定价页为准，每一笔调用都能在用量台账里核对。
model 参数应该填什么？
不要凭记忆填写模型 ID。调用 GET /v1/models 或查看控制台模型价格页，以服务端返回的确切 ID 为准，模型 ID 会随版本更新变化。
Claude Code 和 Anthropic SDK 的接法一样吗？
一样。两者都读取 ANTHROPIC_BASE_URL，客户端会在其后自动追加 /v1/messages 请求路径，所以 Base URL 只填域名本身，不要带 /v1/messages 后缀。