Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.pid0.cn/llms.txt

Use this file to discover all available pages before exploring further.

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。