Claude Code 中国使用完整指南

Anthropic 在中国不开放服务，Claude Code 直接启动就连不上 api.anthropic.com。 本文先对比三种可行方案的优劣，再给出 5 分钟内跑通的最省心做法， 最后把中国开发者最常踩的坑一次性列清楚。

为什么 Claude Code 在中国用不了

Claude Code 是 Anthropic 官方出的 CLI 编程助手，默认访问 api.anthropic.com。Anthropic 官方在支持国家列表里明确排除了中国大陆、香港（部分限制）等地区，同时 anthropic.com 的 IP 在国内网络环境下也普遍不稳定。直接现象是：启动 Claude Code 后报Failed to connect to api.anthropic.com，或卡在 OAuth 登录步骤。

这不是签证、付款、节点选择能单独解决的问题——Anthropic 在注册、付费、API 调用三个环节都做了区域校验，任何一环失败整条链路都走不通。 所以中国开发者要用 Claude Code，必须**绕开直连官方 API**。

三种可行方案对比

方案 A：VPN + 海外信用卡自注册

最传统的做法：搞 VPN，用海外手机号注册 Anthropic 账号，用 Visa / Mastercard 绑卡，然后全局代理跑 Claude Code。

• ✅ 官方体验，模型权重无任何中间层
• ❌ 需要海外手机号 + 海外信用卡
• ❌ VPN 对 Claude Code 的 streaming 经常断流、超时
• ❌ 批量调用容易触发风控封号
• ❌ 人民币付款要走第三方换汇，额外费率 3–5%

方案 B：在美国服务器自建 Anthropic 代理

买一台 AWS / Vultr 美国实例，跑 nginx 或 LiteLLM 代理，把 api.anthropic.com 转发到你自己的域名，中国侧连你的域名即可。

• ✅ 链路可控，可以自己做限流 / 缓存 / 日志
• ❌ 账号问题没解决——你还是要海外手机号 + 海外信用卡
• ❌ 服务器 + 域名 + 证书自己维护，出问题没有 SLA
• ❌ 大部分时间花在运维上，不是开发上

方案 C：用第三方 API 聚合服务（推荐）

用 ModelServer 这类部署在海外但面向中国开发者的 AI 网关。它们已经完成账号、付款、 服务器、稳定性的全部工作，你只需要改两个环境变量。

• ✅ 无需海外账号，支付宝 / 微信直接充值
• ✅ 按 token 用量计费，不用再用 $ 换汇
• ✅ 同一把 key 还能调 GPT / Gemini / DeepSeek 等 40+ 模型
• ✅ 国内直连延迟一般在 200–400ms，支持 streaming SSE
• ⚠️ 上游仍是 Anthropic，用量大时有一层聚合代理的额外费率（ModelServer 为 5.5%）

5 分钟配置步骤

1. 注册并充值

打开 modelserver.dev，用邮箱登录后在 Billing 页面通过支付宝或微信充值（最低 10 元起）。

2. 创建 API Key

进 API Keys 页面点「Create Key」，复制生成的 sk-...密钥（只显示一次，记得存好）。

3. 安装 Claude Code

需要 Node.js ≥ 18：

npm install -g @anthropic-ai/claude-code
claude --version

4. 配置环境变量

把下面三行写进 shell 配置（macOS/Linux 默认 ~/.zshrc或 ~/.bashrc）：

export ANTHROPIC_BASE_URL="https://modelserver.dev"
export ANTHROPIC_AUTH_TOKEN="sk-你的key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

Windows (PowerShell) 走用户环境变量：

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL','https://modelserver.dev','User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN','sk-你的key','User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL','claude-sonnet-4-6','User')

5. 验证

开新终端跑 claude，看到交互界面即成功。随便问一句：

> 解释一下什么是 OpenAI-compatible API

常见排错

Failed to connect / ETIMEDOUT

99% 是 ANTHROPIC_BASE_URL 末尾多带了 /v1。Claude Code 会自动拼/v1/messages，你多写一个 /v1 会变成 /v1/v1/messages，直接 404。 查一下：

echo $ANTHROPIC_BASE_URL
# 必须正好是 https://modelserver.dev，后面不能带 /v1

Auth conflict: Both a token and an API key are set

同时设过 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN。把前者清掉：

unset ANTHROPIC_API_KEY
# 同时去 ~/.zshrc 或 ~/.bashrc 删掉 export ANTHROPIC_API_KEY 这一行

There's an issue with the selected model

Claude Code 默认尝试的模型 ID 你的账号没开通。两种解法：(1) 设 ANTHROPIC_MODEL=claude-sonnet-4-6 或你确定能用的 ID；(2) 在 Claude Code 里输入 /model 从列表选。控制台 Models 页列出你账号支持的全部 ID。

终端卡在 dquote>

中文全角引号 “ ” bash / zsh 不认， 以为引号没闭合。按 Ctrl+C 取消，输入法切英文，换成英文半角 " 重新输入。

Windows 变量设了但不生效

环境变量不会注入到已经打开的窗口。 设完把所有 PowerShell / CMD / Windows Terminal 全关掉再打开， 新窗口里跑 echo $env:ANTHROPIC_BASE_URL 应看到 modelserver.dev。

下一步

跑通之后建议看：

• Claude Code Integration 完整文档 — 全系统详细环境变量、FAQ
• Quickstart — 用同一把 key 通过 OpenAI SDK 调 GPT / Gemini / DeepSeek
• Pricing — 按 token 计费的完整价格表