Claude Code 国内使用指南（2026）
第三方 API 怎么配、模型 ID 怎么填、账单为什么比预期高、报错怎么查，按顺序讲清楚。所有配置对任何支持 Anthropic 原生协议的平台通用。
一句话答案
装好 Node.js 22+ 和 Claude Code，把 ANTHROPIC_BASE_URL 指向一个支持 Anthropic 原生协议的 API 平台，Key 填进 ANTHROPIC_AUTH_TOKEN，就能用。真正决定体验和账单的是另外两件事：钉住模型 ID，别让缓存断掉。
npm i -g @anthropic-ai/claude-code # 需要 Node.js 22+
export ANTHROPIC_BASE_URL=https://api.teamorouter.com # 换成你的平台地址，不要带 /v1
export ANTHROPIC_AUTH_TOKEN=你的Key
export ANTHROPIC_MODEL=claude-opus-5-5
claude上面只在当前终端生效。永久生效、Windows 和 settings.json 写法见下一节，或直接用 配置生成器。
5 分钟配置
-
安装 Claude Code
装 Node.js 22 或更新版本（Windows 另装 Git for Windows），然后：
npm i -g @anthropic-ai/claude-code # npm 慢的话临时用国内镜像 npm i -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.comclaude --version确认版本。Sonnet 5.5 需要 2.1.284 以上，旧版本先claude update。 -
写配置（推荐 settings.json，三平台通用）
文件在
~/.claude/settings.json（Windows：C:\Users\<用户名>\.claude\settings.json）。已有文件时只合并env里这几项，不要整个覆盖。想用 shell 环境变量或 Windows{ "env": { "ANTHROPIC_BASE_URL": "https://api.teamorouter.com", "ANTHROPIC_AUTH_TOKEN": "你的Key", "ANTHROPIC_MODEL": "claude-opus-5-5", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5" } }setx，用 配置生成器 选系统，一键生成可复制的配置。 -
验证
新开终端运行
claude：不再要求登录 Anthropic 账号，说明 Key 已被读到；输入/status看 base URL 是不是你填的地址，/model看 opus / sonnet / haiku 是否指向钉住的 ID。
三个最常见的坑
ANTHROPIC_BASE_URL不带/v1，Claude Code 会自己拼/v1/messages，多写了会 404。ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY只留一个，推荐前者；机器上留着旧的ANTHROPIC_API_KEY容易「填了新 Key 用的却是旧 Key」。- 模型 ID 用短横线：
claude-opus-5-5，不是claude-opus-5.5。
同一个变量既在系统 / 终端环境变量里、又在 settings.json 的 env 里时，环境变量优先（Claude Code 2.1.284 实测）。改了 settings.json 不生效，多半是 ~/.zshrc 或 Windows 用户环境变量里还留着旧值。
钉住模型别名
Claude Code 里的 opus、sonnet、haiku 是别名。不钉住时，它按自己版本内置的默认 ID 去请求；平台没有这个 ID 就报 400 / 404，或者落到旧模型上。
| 变量 | 作用 | 建议值 |
|---|---|---|
ANTHROPIC_MODEL | 启动时默认用的模型 | claude-opus-5-5 |
ANTHROPIC_DEFAULT_OPUS_MODEL | /model 里 opus 指向的 ID | claude-opus-5-5 |
ANTHROPIC_DEFAULT_SONNET_MODEL | sonnet 指向的 ID | claude-sonnet-5-5 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | haiku 指向的 ID，用于会话标题、摘要等后台小任务，最容易被忽略 | claude-haiku-4-5 |
CLAUDE_CODE_SUBAGENT_MODEL | 子代理用的模型 | claude-sonnet-5-5 |
官方价：Opus 5.5 输入 / 输出 $4 / $20、缓存读 $0.20；Sonnet 5.5 输入 / 输出 $2 / $10（美元 / 每百万 token）。其他模型和最新价格见 账单计算器，价格数据每日同步，以官网价格页为准。不同平台的 ID 可能有差异，以平台模型列表为准。
省钱要点：账单主要看缓存
数据来源：TeamoRouter 平台 2026 年 10 月 7 日至 13 日，Claude Code 客户端调用 Opus 5.5 的约 20.6 万次成功请求（399 位用户）。金额按 Anthropic 官方价折算，与任何平台的实际售价无关。
Claude Code 每一轮都会把系统提示、CLAUDE.md、工具定义和历史对话整段重发。这 24 万 token 如果全按 Opus 5.5 输入价 $4 / 百万计，光输入就是 $0.96，是实际平均每次 $0.179 的五倍多。缓存命中率决定账单。
- 会话中途别改 CLAUDE.md，别增删 MCP 工具。重发内容的开头一变，下一轮整段都按全价算。
- 一个会话只用一个模型。缓存按模型分开，
/model来回切，每次切完的第一轮都是全价。 - haiku 别名钉一个便宜的小模型，不设的话后台小任务会请求平台可能没有的 ID。
- 子代理用 Sonnet 5.5，主线程用 Opus 5.5。
CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-5-5，单价只有 Opus 5.5 的一半。 - 思考档按任务调，不要常驻最高档。思考 token 按输出价计费，小活用 low / medium。
- 及时
/compact，做完就/clear或开新会话。上下文越长，每轮重发越多。 - 长时间、多轮的编码任务放在走 Anthropic 原生协议的工具里做。OpenAI 兼容协议接入通常吃不到缓存。
常见报错
| 现象 | 常见原因 | 怎么办 |
|---|---|---|
| 启动后仍要求登录 | 环境变量没被读到 | 新开终端；VS Code 内置终端要重启整个 VS Code；或改用 settings.json |
| 401 / Invalid API key | Key 复制不全；机器上还留着旧的 ANTHROPIC_API_KEY | 重新复制 Key；删掉 ANTHROPIC_API_KEY，只保留 ANTHROPIC_AUTH_TOKEN |
| 404 | ANTHROPIC_BASE_URL 多写了 /v1 | 只写到域名 |
| 400 / 模型不存在 | ID 写成了点号；客户端太旧；平台没有这个 ID | 用短横线 ID；claude update；对照平台模型列表 |
| 会话标题、摘要偶发失败 | haiku 别名没钉住 | 设置 ANTHROPIC_DEFAULT_HAIKU_MODEL |
| 长任务转很久后断开 | 高思考档首字前要想很久，某一层超时 | 调大 API_TIMEOUT_MS；放宽代理读超时；或调低思考档 |
| 账单比预期高很多 | 缓存断了 | 见上面的省钱要点，用 计算器 解析本地会话看命中率 |
报错原文对不上？看 报错速查：Unable to connect、403、401、529、thinking 签名 400、模型不存在等 9 类，逐条给原因和排查步骤。
完整报错表、cc-switch / WorkBuddy / CodeBuddy / OpenCode 接入和验货清单见 GitHub 上的完整指南。
两个小工具
推荐的 API 来源
利益相关：本站由 TeamoRouter 团队维护，下面的 TeamoRouter 是我们自己的产品。排序按合规程度和官方程度，不按利益。
- 能用官方就用官方。有支持地区的账号和付款方式，Claude 订阅或官方 API 最省心。
- 企业已有海外云账号：AWS Bedrock 或 Google Vertex AI，合规和发票最好处理。
- TeamoRouter（利益相关）：Anthropic 原生协议地址
https://api.teamorouter.com，按量计费，不是 Anthropic 官方渠道。 - 其他第三方平台：按完整指南里的验货清单自己测，先小额充值。
第三方平台都不是 Anthropic 官方渠道，你发给 Claude Code 的代码和对话会经过平台方的服务器。敏感代码先看清平台的数据政策。