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

- **HTML:** <https://blog.asuk.app/zh/p/claude-code-in-china>
- **Language:** `zh`
- **Author:** Asuka
- **Published:** `2026-01-08T00:00:00.000Z`
- **Updated:** `2026-10-13T10:41:43.000Z`
- **Tags:** Claude, AI, Proxy, Tutorial

> 从 Google Play 订阅、Cloudflare Worker 代理搭建到本地配置，一站式解决在中国使用 Claude Code 的网络问题。

## Content

由于网络环境的限制，在中国直接使用 Claude Code 会遇到诸多障碍。本文将介绍一套经过验证的稳定方案。


## 一、使用外区 Google 账号订阅 Claude

Claude 的风控机制会检测账号所在区域，国区账号无法使用 Claude 应用——Google Play 商店的 Claude 应用对中国区不可用，网页版登录也可能触发风控。因此，第一步是获取一个外区 Google 账号。

国区账号转外区并不现实。Google 要求首次设置地区后等待 90 天才能更改，且每次更改后需再等 90 天，还需要目标地区的有效付款方式，已购内容和余额也可能丢失。详见 [Google Play 帮助文档](https://support.google.com/googleplay/answer/7431675)。

新注册 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](https://github.com/dogchild/api-cf)，该项目提供了一键部署功能。

部署步骤：

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


### 绑定自有域名

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

**在 Cloudflare 购买域名**：

1. 登录 [Cloudflare Dashboard](https://dash.cloudflare.com/)
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 自定义域名文档](https://developers.cloudflare.com/workers/configuration/routing/custom-domains/)。


## 三、安装和配置 Claude Code

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


### 安装 Claude Code

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

**[Claude Code 官方安装指南](https://code.claude.com/docs/en/overview)**

简要步骤：

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