840 字
4 分钟

Claude Code 国内使用指南:代理、中转站与 Router 方案对比

Claude Code 默认连接 api.anthropic.com,该域名在中国大陆无法直连。有三种方式解决这个问题,各有适用场景和取舍。


三种方案对比#

方案配置难度费用安全性稳定性
官方 HTTPS_PROXY低(需梯子)按 API 用量计费高(流量不经第三方)取决于梯子质量
API 中转站按用量计费,含溢价中(代码经第三方服务器)较稳定
Claude Code Router按路由模型计费高(自建或官方服务)

如果你已有稳定代理,优先用方案一。如果没有梯子且对代码安全要求不高,用方案二。需要把请求路由到其他模型(如 DeepSeek)降低成本时,用方案三。


方案一:配置 HTTPS_PROXY#

让 Claude Code 的所有请求走你已有的 HTTP/HTTPS 代理。

Terminal window
# 临时生效(仅当前终端会话)
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
claude
Terminal window
# 永久生效:写入 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 代理端口,根据你的代理工具实际端口替换。

Warning

Claude Code 只支持 HTTP/HTTPS 代理,不支持 SOCKS5 代理。如果你的工具只提供 SOCKS5,需要在工具里额外开启 HTTP 代理端口。

验证代理是否生效:

Terminal window
curl -x http://127.0.0.1:7890 https://api.anthropic.com/v1/models
# 返回 JSON 而不是连接超时,说明代理正常

企业网络(SSL 证书拦截)#

如果公司网络会解包 HTTPS 流量(常见于企业防火墙),需要额外信任内部 CA:

Terminal window
export NODE_EXTRA_CA_CERTS=/path/to/company-ca.crt

方案二:API 中转站#

中转站在海外部署服务器代理 Anthropic API 请求,你只需修改 API 地址,不需要梯子。

Terminal window
# 以 Novita 为例
export ANTHROPIC_BASE_URL=https://novita.ai/v3/openai
export ANTHROPIC_API_KEY=你的中转站 Key
claude

常用中转站:

服务特点
Novita价格低,支持信用卡,按量计费
OpenRouter多模型聚合,支持信用卡
Camel API国内团队运营,中文支持好
Warning

使用中转站时,你的代码和对话内容会经过第三方服务器。涉及商业机密或敏感代码时,评估这一风险后再使用。

永久写入配置:

Terminal window
# 写入 ~/.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)。

安装:

Terminal window
npm install -g claude-code-router

启动 Router,然后让 Claude Code 指向它:

Terminal window
# 终端 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。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或赞助支持!

赞助
Claude Code 国内使用指南:代理、中转站与 Router 方案对比
https://www.yuntier.com/posts/claude-guide/claude-code-china-guide/
作者
瓦叔
发布于
2026-04-09
许可协议
CC BY-NC-SA 4.0
随机文章 随机推荐

评论区

评论已按需延迟加载

滚动到评论区附近或点击按钮后,再加载 Waline 脚本与请求。

评论尚未加载
Profile Image of the Author
瓦叔
准奶爸 / 10年后端+5年运维 / 建站防坑老司机
欢迎
建站笔记持续更新中,实测验证,防坑为主。欢迎收藏!
分类
标签
站点统计
文章
36
分类
4
标签
152
总字数
66,278
运行时长
0
最后活动
0 天前

目录