エッセイ
国内稳定使用 Claude Code 的完整指南#
由于网络环境的限制,在中国直接使用 Claude Code 会遇到诸多障碍。本文将介绍一套经过验证的稳定方案。
一、使用外区 Google 账号订阅 Claude#
Claude 的风控机制会检测账号所在区域,国区账号无法使用 Claude 应用——Google Play 商店的 Claude 应用对中国区不可用,网页版登录也可能触发风控。因此,第一步是获取一个外区 Google 账号。
国区账号转外区并不现实。Google 要求首次设置地区后等待 90 天才能更改,且每次更改后需再等 90 天,还需要目标地区的有效付款方式,已购内容和余额也可能丢失。详见 Google Play 帮助文档。
新注册 Google 账号同样困难。近年 Google 加强了实人验证,注册时需要手机发送验证码,国内号码基本无法通过。
推荐方案是直接购买成品外区账号,优先选择美区或日区。购买后及时修改密码和辅助邮箱。外区账号可以绑定国内 Visa/Mastercard 信用卡进行支付,订阅 Claude Pro 后即可使用 Claude Code。
二、搭建 Cloudflare Worker 代理服务#
即使有了外区账号,直接访问 Claude API 仍然可能因为 IP 问题导致连接失败或账号被风控。搭建一个稳定的代理服务是必要的。
为什么需要代理?#
- IP 区域问题:Claude 会检测请求来源 IP,某些地区的 IP 可能被限制
- IP 质量问题:共享 VPN 的 IP 可能因滥用被标记
- 连接稳定性:直连可能因网络波动导致请求失败
- 风控风险:频繁更换 IP 或使用低质量 IP 可能触发账号风控甚至封禁
使用 Cloudflare Worker 搭建代理#
Cloudflare Worker 提供免费的边缘计算服务,非常适合搭建轻量级 API 代理。
推荐方案:使用开源项目 dogchild/api-cf,该项目提供了一键部署功能。
部署步骤:
- 访问 api-cf 项目页面
- 点击 README 中的 "Deploy to Cloudflare" 按钮
- 按引导授权、创建仓库、绑定项目并完成部署
绑定自有域名#
Cloudflare Worker 默认分配的 *.workers.dev 域名在国内可能无法直接访问,因此需要绑定自有域名。
在 Cloudflare 购买域名:
- 登录 Cloudflare Dashboard
- 进入 "Domain Registration" > "Register Domains"
- 搜索并购买一个域名(
.com、.dev等) - 完成支付后域名会自动添加到你的账户
将域名绑定到 Worker:
- 在 Cloudflare Dashboard 中进入你的域名设置
- 选择 "Workers Routes" 或在 Worker 设置中添加 "Custom Domains"
- 添加类似
api.yourdomain.com的子域名 - 保存后等待 DNS 生效(通常几分钟)
详细操作可参考 Cloudflare Workers 自定义域名文档。
三、安装和配置 Claude Code#
完成前两步后,就可以安装并配置 Claude Code 了。
安装 Claude Code#
Claude Code 支持多种安装方式,详细说明请参考官方文档:
简要步骤:
# 使用 npm 全局安装
npm install -g @anthropic-ai/claude-code
# 或使用其他包管理器
配置代理地址#
编辑 Claude Code 的配置文件 ~/.claude/settings.json,添加以下内容:
{
"env": {
"ANTHROPIC_BASE_URL": "https://<YOUR_WORKER_DOMAIN>/claude",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
}
}
配置说明:
| 配置项 | 说明 |
|---|---|
ANTHROPIC_BASE_URL |
替换为你的 Worker 域名,如 https://api.example.com/claude |
API_TIMEOUT_MS |
API 超时时间,设置较大值以适应复杂任务 |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC |
禁用非必要的网络请求,减少被检测的风险 |
启动并登录#
配置完成后,在终端运行:
claude
首次运行会引导你完成登录流程:
- 按提示在浏览器中打开授权页面
- 使用你的 Claude 账号(已订阅)登录
- 授权 Claude Code 访问
- 返回终端,确认登录成功
登录成功后,你就可以在中国稳定使用 Claude Code 了。
常见问题#
Q: 订阅 Claude Pro 后还需要单独付费使用 Claude Code 吗?#
Claude Code 包含在 Claude Pro/Max 订阅中,用量额度内不需要额外付费。
Q: Worker 有免费额度限制吗?#
Cloudflare Workers 免费版每天有 10 万次请求限制,对于个人使用完全足够。如果超出,可以考虑升级到付费版。
Q: 代理会影响使用速度吗?#
Cloudflare 的全球 CDN 网络通常能提供稳定的连接,实际体验中延迟增加不明显。
Q: 这种方式安全吗?#
- 代理服务只转发请求,不存储你的数据
- 使用自有域名和 HTTPS 确保传输加密
- 建议自行审查代理服务的代码确保安全