Claude Code 国内使用完整教程

为什么 Claude Code 在国内不能直接用

Claude Code 是 Anthropic 推出的命令行 AI 编程工具。Claude Code 本身的下载和安装并不挑环境——但要让它实际工作起来，需要调用 Anthropic 的 Claude 模型 API，而 Anthropic 的 API 服务、账号系统和支付系统对国内访问并不友好：

• API 接口（api.anthropic.com）在国内访问不稳定，请求经常超时
• 注册 Claude 账号需要海外手机号验证，国内 +86 号码无法通过
• 订阅 Claude Pro / Max 需要海外信用卡，国内银行卡大多被拒

这三道门槛，是国内开发者直接使用 Claude Code 的核心障碍。下面这套教程的目的就是绕开它们。

国内使用 Claude Code 的三种方案

目前国内开发者跑通 Claude Code 的主流路径有三条，覆盖不同预算和折腾程度：

本教程主体走方案 B（中转站）——这是 2026 年国内 Claude Code 使用者的事实标准，因为它解决了"网络 + 账号 + 支付"三个问题，且配置只要改两行环境变量。

第一步：安装 Claude Code（国内 npm 加速）

Claude Code 通过 npm 安装。国内直接走 npm 官方源会很慢（甚至超时），所以先把 npm 源切到国内镜像：

npm config set registry https://registry.npmmirror.com

然后全局安装 Claude Code：

npm install -g @anthropic-ai/claude-code

或者一行命令直接指定镜像源：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

装完后用 claude --version 看到版本号，说明 Claude Code 命令行已经就位。如果提示 command not found，检查 npm 全局目录是否在你的 PATH 里。

第二步：注册中转站，拿到 API Key 和 Base URL

中转站的本质是一个"代理服务"——它在海外部署服务器，转发你的请求到 Anthropic 官方，再把响应返回给你。你和中转站之间走国内网络（直连），中转站和 Anthropic 之间走海外网络（稳定）。

注册流程通常这样：

1. 1打开中转站官网，邮箱注册账号
2. 2充值（一般支持微信、支付宝、USDT），按 token 计费
3. 3在控制台「API Keys」页面创建一个 Key（以 sk- 开头的长字符串）
4. 4从首页或文档里抄下 Base URL（形如 https://api.example.com）

这两个值——API Key 和 Base URL——就是连接 Claude Code 到 Anthropic 模型的钥匙。

第三步：把中转配置写进 Claude Code

Claude Code 通过两个环境变量识别中转站：

• ANTHROPIC_BASE_URL — 中转站的 API 地址
• ANTHROPIC_AUTH_TOKEN — 你在中转站申请的 Key

有三种写法，挑你顺手的：

写法 A：环境变量（最快，适合临时测试）

在你的 shell 里直接 export，本次会话有效：

# macOS / Linux
export ANTHROPIC_BASE_URL="https://api.your-relay.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-key-here"

# Windows PowerShell
$env:ANTHROPIC_BASE_URL = "https://api.your-relay.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key-here"

要让配置持久化，把 export 行写进 ~/.zshrc 或 ~/.bashrc。

写法 B：settings.json（推荐，跨终端持久）

编辑 ~/.claude/settings.json（没有这个文件就新建），把中转配置写进 env 块：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.your-relay.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key-here"
  }
}

Claude Code 每次启动都会自动读取这个文件。这是最稳的写法——配置跟着 Claude Code 走，换 shell、换终端都不影响。

写法 C：claude config 命令（不用手编辑文件）

用 Claude Code 自带的 config 命令直接写入全局配置：

claude config set -g env.ANTHROPIC_BASE_URL "https://api.your-relay.com"
claude config set -g env.ANTHROPIC_AUTH_TOKEN "sk-your-key-here"

底层效果和写法 B 完全等价，只是省了你打开编辑器的步骤。

第四步：验证连接，开始使用

配置完成后，到任何一个项目目录运行：

cd ~/your-project
claude

能看到欢迎提示符 >，就说明 Claude Code 已经通过中转站连上了 Anthropic 的模型。试一句简单指令验证：

> 帮我列出当前目录的所有文件

如果它正常返回结果，Claude Code 整条链路就通了。剩下的就是日常使用——读代码、改代码、跑命令、做 git，全部和官方版本完全一致。

模型选择与省钱建议

Claude Code 支持 Anthropic 三个模型——它们成本差异很大，国内中转站按 token 计费，挑对模型能省一半以上的钱：

Sonnet 4.6 · 日常首选

性价比最高的选择，也是 Claude Code 日常用得最多的模型。大部分编程任务都用它就够了——修 bug、写功能、重构小文件。中转站价格通常是 Opus 的 1/5。

Opus 4.7 · 大任务用

百万上下文，能"吞下整个项目再分析"。适合：整库重构、跨多文件追踪复杂 bug、读懂遗留代码。贵，但活儿干得透。一次只在真需要的时候切到 Opus。

Haiku 4.5 · 闲聊用

响应最快、最便宜。适合简单提问、生成 commit message、改个变量名这类轻活。在 Claude Code 里用 /model haiku 切换。

怎么省钱

三个习惯能显著降低 Claude Code 在中转站的开销：

• 默认挂 Sonnet，只在 Sonnet 解决不了时切 Opus
• 在 CLAUDE.md 里写清楚项目规矩，省得每次对话重复说一遍
• 把无关目录（node_modules、dist 等）加进 settings 屏蔽，少传无用上下文

国内使用 Claude Code 常见问题

用中转站会被 Anthropic 封号吗

中转站持有的是商业级账号，不是个人账号。你的请求经过中转站转发到 Anthropic，对官方而言看到的是中转站的账号在调用，和你个人的身份无关。所以「封你的号」这件事不成立——你根本没有 Anthropic 个人号。

中转站会不会偷看我的代码

理论上中转站能看到经过的请求内容。所以选靠谱的服务商很重要——成立时间久、有口碑、有明确的隐私政策。涉密代码不建议用任何 AI 工具（不只是 Claude Code）。日常项目代码的风险，和你用 GitHub Copilot 类似。

中转站价格和官方比起来怎么样

主流中转站对 Anthropic 模型的加价通常在 10%-30% 之间——比起省下来的海外信用卡、海外手机号、海外服务器费用，这个溢价是合算的。如果你高频使用 Claude Code，月消费 100 元以内 Sonnet 完全够用。

能不能不用中转站，自己搭代理

能。你需要一台海外 VPS + Cloudflare Worker / Vercel 部署一个 Anthropic API 反向代理，自己拿官方 API Key。技术折腾成本高，且仍要解决海外账号和支付问题。除非你团队级使用，否则不如直接用中转站。

Windows 用户安装 Claude Code 要注意什么

Windows 原生支持 Claude Code，但更推荐用 WSL2（Windows Subsystem for Linux）运行——很多终端工具在 WSL 下体验更好。安装 WSL2 + Ubuntu，然后在 Ubuntu 里跑前面的安装步骤，体验和 Mac 几乎一致。

Claude Code 国内使用速度怎么样

用对中转站的话，国内访问中转站节点的延迟通常在 50-150ms 之间，加上中转站到 Anthropic 的 50-200ms，整体响应速度和直接在海外用差不太多。流式输出几乎感觉不出延迟。

看完这篇就可以动手——第一步去注册中转站拿 Key，然后回来按教程往下走。整个过程 5 分钟，国内直连无障碍。

开通中转站 →