Asuka109
国内稳定使用 Claude Code 的完整指南

Essay

国内稳定使用 Claude Code 的完整指南#

By Asuka
ClaudeAIProxyTutorial

由于网络环境的限制，在中国直接使用 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，该项目提供了一键部署功能。

部署步骤：

  1. 访问 api-cf 项目页面
  2. 点击 README 中的 "Deploy to Cloudflare" 按钮
  3. 按引导授权、创建仓库、绑定项目并完成部署

绑定自有域名#

Cloudflare Worker 默认分配的 *.workers.dev 域名在国内可能无法直接访问，因此需要绑定自有域名。

在 Cloudflare 购买域名：

  1. 登录 Cloudflare Dashboard
  2. 进入 "Domain Registration" > "Register Domains"
  3. 搜索并购买一个域名（.com、.dev 等）
  4. 完成支付后域名会自动添加到你的账户

将域名绑定到 Worker：

  1. 在 Cloudflare Dashboard 中进入你的域名设置
  2. 选择 "Workers Routes" 或在 Worker 设置中添加 "Custom Domains"
  3. 添加类似 api.yourdomain.com 的子域名
  4. 保存后等待 DNS 生效（通常几分钟）

详细操作可参考 Cloudflare Workers 自定义域名文档。

三、安装和配置 Claude Code#

完成前两步后，就可以安装并配置 Claude Code 了。

安装 Claude Code#

Claude Code 支持多种安装方式，详细说明请参考官方文档：

Claude Code 官方安装指南

简要步骤：

Bash
# 使用 npm 全局安装
npm install -g @anthropic-ai/claude-code

# 或使用其他包管理器

配置代理地址#

编辑 Claude Code 的配置文件 ~/.claude/settings.json，添加以下内容：

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 禁用非必要的网络请求，减少被检测的风险

启动并登录#

配置完成后，在终端运行：

Bash
claude

首次运行会引导你完成登录流程：

  1. 按提示在浏览器中打开授权页面
  2. 使用你的 Claude 账号（已订阅）登录
  3. 授权 Claude Code 访问
  4. 返回终端，确认登录成功

登录成功后，你就可以在中国稳定使用 Claude Code 了。

常见问题#

Q: 订阅 Claude Pro 后还需要单独付费使用 Claude Code 吗？#

Claude Code 包含在 Claude Pro/Max 订阅中，用量额度内不需要额外付费。

Q: Worker 有免费额度限制吗？#

Cloudflare Workers 免费版每天有 10 万次请求限制，对于个人使用完全足够。如果超出，可以考虑升级到付费版。

Q: 代理会影响使用速度吗？#

Cloudflare 的全球 CDN 网络通常能提供稳定的连接，实际体验中延迟增加不明显。

Q: 这种方式安全吗？#

  • 代理服务只转发请求，不存储你的数据
  • 使用自有域名和 HTTPS 确保传输加密
  • 建议自行审查代理服务的代码确保安全