Claude Code 默认连接 api.anthropic.com,该域名在中国大陆无法直连。有三种方式解决这个问题,各有适用场景和取舍。
三种方案对比
| 方案 | 配置难度 | 费用 | 安全性 | 稳定性 |
|---|
| 官方 HTTPS_PROXY | 低(需梯子) | 按 API 用量计费 | 高(流量不经第三方) | 取决于梯子质量 |
| API 中转站 | 低 | 按用量计费,含溢价 | 中(代码经第三方服务器) | 较稳定 |
| Claude Code Router | 中 | 按路由模型计费 | 高(自建或官方服务) | 高 |
如果你已有稳定代理,优先用方案一。如果没有梯子且对代码安全要求不高,用方案二。需要把请求路由到其他模型(如 DeepSeek)降低成本时,用方案三。
方案一:配置 HTTPS_PROXY
让 Claude Code 的所有请求走你已有的 HTTP/HTTPS 代理。
# 临时生效(仅当前终端会话)
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
claude
# 永久生效:写入 shell 配置文件
echo 'export HTTPS_PROXY=http://127.0.0.1:7890' >> ~/.zshrc
echo 'export HTTP_PROXY=http://127.0.0.1:7890' >> ~/.zshrc
source ~/.zshrc
端口 7890 是 Clash 的默认 HTTP 代理端口,根据你的代理工具实际端口替换。
Claude Code 只支持 HTTP/HTTPS 代理,不支持 SOCKS5 代理。如果你的工具只提供 SOCKS5,需要在工具里额外开启 HTTP 代理端口。
验证代理是否生效:
curl -x http://127.0.0.1:7890 https://api.anthropic.com/v1/models
# 返回 JSON 而不是连接超时,说明代理正常
企业网络(SSL 证书拦截)
如果公司网络会解包 HTTPS 流量(常见于企业防火墙),需要额外信任内部 CA:
export NODE_EXTRA_CA_CERTS=/path/to/company-ca.crt
方案二:API 中转站
中转站在海外部署服务器代理 Anthropic API 请求,你只需修改 API 地址,不需要梯子。
# 以 Novita 为例
export ANTHROPIC_BASE_URL=https://novita.ai/v3/openai
export ANTHROPIC_API_KEY=你的中转站 Key
claude
常用中转站:
| 服务 | 特点 |
|---|
| Novita | 价格低,支持信用卡,按量计费 |
| OpenRouter | 多模型聚合,支持信用卡 |
| Camel API | 国内团队运营,中文支持好 |
使用中转站时,你的代码和对话内容会经过第三方服务器。涉及商业机密或敏感代码时,评估这一风险后再使用。
永久写入配置:
# 写入 ~/.claude/.env(Claude Code 会自动加载)
cat >> ~/.claude/.env << 'EOF'
ANTHROPIC_BASE_URL=https://novita.ai/v3/openai
ANTHROPIC_API_KEY=你的中转站 Key
EOF
方案三:Claude Code Router
Claude Code Router 是一个本地代理层,可以把 Claude Code 的请求路由到不同模型(如将复杂任务发给 Claude Opus,简单任务发给 DeepSeek)。
安装:
npm install -g claude-code-router
启动 Router,然后让 Claude Code 指向它:
# 终端 1:启动 Router(默认监听 8080)
ccr start
# 终端 2:配置 Claude Code 指向 Router
export ANTHROPIC_BASE_URL=http://localhost:8080
claude
Router 的配置文件 ~/.claude-code-router/config.json 控制路由规则,详细配置参考项目文档。
常见连接问题
超时(connect ETIMEDOUT):代理未生效或代理本身不稳定。先用 curl 验证代理可访问 api.anthropic.com。
SSL 证书错误(CERT_UNTRUSTED):企业网络拦截了 HTTPS,参考上方企业网络配置。
地区限制提示(App unavailable in region):这是安装时的地区检测,不影响 API 使用。用方案一或二配置后即可正常调用。
SOCKS5 代理不生效:Claude Code 不支持 SOCKS5,需要在代理工具里开启 HTTP 代理端口。
更多安装问题见 Claude Code 报错速查手册。Claude Code 功能与工作流说明见 Claude Code 使用指南。
本文最后更新于 2026-04。