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

文章

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

作者：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 确保传输加密
  • 建议自行审查代理服务的代码确保安全