Claude Code 中国大陆安装教程
不挂 VPN,把 Claude Code 的后端指向国内可直连的 DeepSeek 端点,即可正常使用。
代价
跑的是 DeepSeek 模型,不是真正的 Claude——代码能力接近但不完全等同 Opus/Sonnet。这是 DeepSeek 官方文档记录的接入方式,Anthropic 不主动支持也不阻止。
原理
Claude Code 默认连接 api.anthropic.com,该域名在大陆无法直连。DeepSeek 提供一个 Anthropic 兼容端点(api.deepseek.com/anthropic),国内可直接访问。把 Base URL 换掉即可。
第 1 步:安装 Node 和 Claude Code
bash
# 用 Homebrew 安装 Node
brew install node
# 把 npm 源切到国内镜像,避免超时
npm config set registry https://registry.npmmirror.com
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-codeTIP
不要用 curl … claude.ai/install.sh 安装脚本——claude.ai 在墙内不通。走 npm 最稳。
第 2 步:申请 DeepSeek API Key
- 打开 platform.deepseek.com,注册并登录。
- 充值(按量付费,很便宜)。
- 在「API Keys」页面新建一个 Key,形如
sk-xxxxxxxx。
第 3 步:写入环境变量
把下面这段贴到 ~/.zshrc 末尾,把占位符换成你的 Key:
bash
# Claude Code → DeepSeek V4(中国大陆直连,无需 VPN)
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek-Key"
export ANTHROPIC_MODEL="deepseek-v4-pro" # 主模型(opus 档)
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-v4-flash" # 后台/轻量任务(haiku 档)保存后让配置生效:
bash
source ~/.zshrc第 4 步:运行
bash
cd 你的项目目录
claudeClaude Code 会跳过 Anthropic 官方登录,直接用 DeepSeek Key 连境内端点。
排错
| 问题 | 处理方式 |
|---|---|
| 改了不生效 | 每次改完 .zshrc 都要 source ~/.zshrc 或重开终端 |
| 验证变量 | echo $ANTHROPIC_BASE_URL 应输出 DeepSeek 地址 |
| 想换回真 Claude | 注释掉四行 export 再 reload(仍需 VPN + 官方账号) |
模型名
使用 deepseek-v4-pro / deepseek-v4-flash。旧别名 deepseek-chat、deepseek-reasoner 在 2026-07-24 后停用。
其他可选端点
| 厂商 | ANTHROPIC_BASE_URL |
|---|---|
| DeepSeek | https://api.deepseek.com/anthropic |
| 智谱 GLM | https://open.bigmodel.cn/api/anthropic |
| Moonshot Kimi | https://api.moonshot.cn/anthropic |

