国内安装 Claude Code 完整教程 - CLI、镜像、平替方案对比
Claude Code 国内能用吗？本文详解国内安装 Claude Code CLI 的完整步骤、镜像源、国内平替方案、网络配置与常见报错排查。
“国内安装 Claude Code 教程” 是过去半年搜索量飙升最快的关键词之一。Claude Code 是 Anthropic 推出的命令行编程助手，但因为 Anthropic 没有在中国大陆开通服务，国内安装 Claude Code CLI 比国外多一些额外步骤。本文系统讲清楚国内安装 ClaudeCode 的三步流程、可选镜像源、国内平替方案以及常见报错。无论你是想用官方 Claude 模型，还是想换成国产模型，ClaudeCode 国内怎么使用 这一篇都能给你完整答案。
需要先把一件事说清楚：本文只讲技术配置和工具使用，不推荐任何具体的非官方中转服务商，也不替你做合规判断。所有方案都各有取舍，请结合自己的身份和场景做选择。
Claude Code 国内能用吗：分两层回答
“ClaudeCode 国内能用吗” 这个问题要拆成两层：
| 层次 | 答案 |
|---|---|
| 客户端本身 | 能装。Claude Code 是一个 Node.js 包，npm 安装即可，没有地域限制 |
| 后端模型 | 默认连接 api.anthropic.com，国内 IP 默认被拒，需要解决网络或换后端 |
也就是说，ClaudeCode 国内安装教程 主要解决两件事：把 CLI 装到本地（这部分没那么难），以及给它配一个国内能正常调用的模型后端（这部分才是关键）。
Claude Code 是国内还是国外的
经常有人问 “ClaudeCode 是国内还是国外”。结论：
- 开发方：Anthropic，美国旧金山公司，纯海外产品
- 代码托管：GitHub，开源（npm 包托管在 npm 官方仓库）
- 服务器：默认调用 Anthropic 在美国的 API 服务器
- 国内服务器：截至本文撰写时，Anthropic 没有在中国大陆部署任何官方服务器
所以你看到的”国内 ClaudeCode 镜像网站”，本质上要么是 npm 包的镜像（合法且推荐），要么是 API 中转商（要自己判断风险）。
国内安装 Claude Code 三步骤总览
| 步骤 | 大致工作 | 国内特别提示 |
|---|---|---|
| 1. 装 Node.js | 18+ 或 LTS 版本 | 用国内镜像下载快 |
| 2. 装 Claude Code CLI | npm install -g @anthropic-ai/claude-code | 走淘宝 npm 镜像 |
| 3. 配置网络/后端 | 让 CLI 能调到模型 | 三选一：代理 / 中转 / 国产模型 |
后面三节按步骤详细展开。
步骤 1：安装 Node.js（国内镜像加速）
Claude Code 是 Node.js CLI，对应需要 Node.js 运行时。
最稳的方式：
- 去 nodejs.org 下载 LTS 版本，国内下载有时慢，但官方可信
- 或者用 nvm / fnm 这类版本管理器装
国内加速 Node 安装包下载，可以用淘宝镜像（截至撰写时为 https://registry.npmmirror.com）：
# 永久切到淘宝镜像
npm config set registry https://registry.npmmirror.com
# 验证
npm config get registry
或者用 nrm 工具一键切镜像：
npm install -g nrm
nrm ls
nrm use taobao
如果你装了 cnpm：
npm install -g cnpm --registry=https://registry.npmmirror.com
但 不推荐 用 cnpm 装 Claude Code，部分包的 binary 链接可能受影响，建议老老实实用 npm，只是把 registry 指向国内镜像。
步骤 2：用 npm 镜像源安装 Claude Code
切好镜像后，安装命令和国外一样：
npm install -g @anthropic-ai/claude-code
验证安装：
claude --version
如果上面命令报 “command not found”，说明 npm 的全局 bin 目录不在 PATH 里。Windows PowerShell 用户可以：
$env:Path -split ';'
看看 npm-global\ 或类似目录是否在里面，缺了就加进 PATH。
关于”ClaudeCode 国内镜像”： 官方 npm 包 @anthropic-ai/claude-code 在淘宝镜像有同步缓存，所以国内安装本身是顺畅的。所谓”ClaudeCode 国内镜像网站” 准确说是 npm 包的镜像，不是 Anthropic 服务器的镜像。Anthropic 模型服务在国内没有官方镜像。
步骤 3：国内首次登录的网络方案
装完 claude 命令，第一次启动一般会要求登录或配置 API。这一步是 国内如何使用 Claude Code 的真正分歧点。
可选方案有三类：
| 方案 | 适合谁 | 简要说明 |
|---|---|---|
| A. 国际网络 + Anthropic 账号 | 个人深度使用者 | 全程走 anthropic.com，需要稳定海外网络 |
| B. API 中转 | 不想折腾网络 | 改 ANTHROPIC_BASE_URL 指向中转地址 |
| C. 国产模型后端 | 合规优先 | 改 ANTHROPIC_BASE_URL 指向国产兼容接口 |
方案 A：走代理直连官方
如果你有稳定的海外代理，可以直接给终端配代理：
# macOS / Linux
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
claude
# Windows PowerShell
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:HTTP_PROXY = "http://127.0.0.1:7890"
claude
端口要换成你本机代理客户端实际监听的端口。
方案 B：API 中转
中转方案让 Claude Code 客户端连到第三方服务器，由对方代为请求 Anthropic API：
export ANTHROPIC_BASE_URL="https://your-relay.example.com"
export ANTHROPIC_API_KEY="sk-xxxxxx"
claude
ClaudeCode 国内中转站 的本质就是替你完成”海外注册 + 信用卡支付”的角色，但数据要过中转方的服务器，敏感场景请谨慎评估。
方案 C：换成国产模型后端
部分国产模型平台提供 Anthropic 兼容接口，把 ANTHROPIC_BASE_URL 指过去即可使用国产模型，全程国内网络。详见后文”用国产模型替代官方 Claude”一节。
国内访问 Claude 官方服务的方法
国内能使用 Claude 模型吗 这个问题，如果指的是直接连官方：截至本文撰写时不能。Anthropic 对中国大陆 IP 返回 unsupported region。你必须用以下之一：
- 通过稳定的国际网络访问 anthropic.com
- 通过第三方中转 API
- 通过 AWS Bedrock / GCP Vertex AI 海外区域（企业方案）
注意 Claude 国内能用吗 在 ToS 层面属于灰色地带，个人学习研究和企业商用风险等级完全不同，建议读官方 ToS 后再行动。
用国产模型替代官方 Claude
如果你的目标是 用上 Claude Code 这种工程化能力，但模型可以接受替换，那 不需要任何国际网络。Claude Code 客户端只是 CLI，它的协议是开放的 Anthropic Messages API，任何提供兼容接口的模型都能接进来。
主流可选：
| 国产模型 | 兼容方式 | 大致水平 |
|---|---|---|
| DeepSeek V3 / Coder | LiteLLM 转协议 / 部分平台直接兼容 | 编程能力强，价格便宜 |
| 智谱 GLM 4.6 | 部分版本提供 Anthropic 兼容端点 | 中文沟通好，工具调用稳 |
| 通义 Qwen 系列 | LiteLLM 或 DashScope 适配 | 长文档场景强 |
| 文心 / 豆包 | 多数走 OpenAI 协议，需中间层 | 国内合规友好 |
接入步骤参见本站 “Claude Code 切换模型完整教程”。ClaudeCode 国内平替 在 95% 的日常任务上已经够用。
国内平替方案 - 编辑器/工具维度
把视野再拉大一点。如果你的目标只是”AI 写代码”，不必非要用 Claude Code 这一个 CLI。国内有几类成熟的平替形态：
- Cursor：编辑器+AI，可以在国内通过自带的中转或者用户自定义后端接 Claude 系列模型
- Trae：字节跳动出品的 AI IDE
- 百度 Comate：百度的代码助手，深度集成文心模型
- 通义灵码：阿里出的代码助手，主力是 Qwen Coder 系列
这些工具的共同特点：国内直接装、直接用，不用代理。它们各自的 AI 后端基本是国产模型，整个数据链路在国内，对企业合规非常友好。
ClaudeCode 国内平替对比表
| 工具 | 形态 | 默认模型 | 国内可直装 | 适合场景 |
|---|---|---|---|---|
| Claude Code（官方） | CLI | Claude | 需配代理或换后端 | 终端原生开发流 |
| Cursor | IDE | 可选 GPT / Claude | 安装可直接，模型需要海外 | 编辑器一体化体验 |
| Trae | IDE | 国产模型 | 是 | 国内合规优先 |
| 百度 Comate | IDE 插件 | 文心 | 是 | 百度生态用户 |
| 通义灵码 | IDE 插件 | Qwen Coder | 是 | 阿里云用户、Qwen 党 |
| Aider + 国产模型 | CLI | 自选 | 是 | 终端党 + 国产模型 |
国内 Cursor 能使用 Claude 模型吗 这个问题：Cursor 客户端本身可以装到国内电脑，登录和某些 AI 调用依赖海外服务器，所以默认状态下国内体验会受影响。如果想让 Cursor 用 Claude 模型，要么用 Cursor 自带的代理设置，要么用海外网络。
国内中转站方案 vs 自建对比
ClaudeCode 国内中转站 和 Claude Code 国内中转 是同一种东西。从架构上看：
| 维度 | 第三方中转 | 自建中转 |
|---|---|---|
| 上手时间 | 几分钟 | 几小时到几天 |
| 成本 | 按用量付费 | 服务器固定成本 |
| 稳定性 | 看运营方 | 自己负责 |
| 数据安全 | 中转方能看到 | 自己控制 |
| 账号风险 | 共用账号被封 | 自己账号 |
| 法律合规 | 看运营方资质 | 自己评估 |
Claude Code 国内中转收费 这一块普遍按 token 用量计费，价格大致接近官方 API 的 0.7–1.5 倍。极个别”免费”的中转站要警惕，可能是共用账号、可能跑路、可能记录你的 prompt 拿去训练。
自建中转的最小方案：在海外 VPS 上跑一个 Nginx 反向代理 anthropic.com，再加一层鉴权。如果走 Cloudflare Workers，几行代码就能搭起来。
国内使用 ClaudeCode 官方界面
不少人搜 “国内使用 ClaudeCode 官方界面”。澄清一下：Claude Code 本身只有终端界面，没有所谓”网页官方界面”。可能是把以下几个东西混了：
- claude.ai 网页对话：这是 Claude 网页版，国内访问需要海外网络
- Claude Code CLI：终端工具，国内能装
- Anthropic Console：开发者后台 console.anthropic.com，国内访问也需要海外网络
如果你想 在国内用上接近官方体验，最完整路径是：稳定海外网络 + 海外账号 + 海外信用卡 + Claude Pro 订阅 + 在本地装 Claude Code。任何一环不通，就要降级到中转或国产模型方案。
常见报错排查
下面是 国内安装 ClaudeCode 时最常踩到的几个坑。
npm install 卡住或失败
npm ERR! network request to https://registry.npmjs.org/...
原因是默认 npm 仓库国内访问慢。换成淘宝镜像：
npm config set registry https://registry.npmmirror.com
npm cache clean --force
npm install -g @anthropic-ai/claude-code
登录卡住 / 弹不出浏览器
Claude Code 首次启动会尝试调 Anthropic 服务做 OAuth。国内直连 anthropic.com 失败，会卡住。解决：
- 启动前先配置好 HTTPS_PROXY / HTTP_PROXY
- 或者直接走
ANTHROPIC_API_KEY模式，跳过 OAuth
ECONNREFUSED / ETIMEDOUT
Error: connect ECONNREFUSED 1.2.3.4:443
代理客户端没起来，或者监听端口写错了。先 curl https://www.google.com -x http://127.0.0.1:7890 验证代理本身通不通。
401 / 403 from anthropic.com
API key 错或者地域被拒。检查：
echo $ANTHROPIC_API_KEY看 key 是否完整- 通过代理走的话，确认代理出口 IP 不在中国大陆
Windows PATH 找不到 claude 命令
npm 全局安装目录没加到 PATH。解决：
npm config get prefix
把输出路径下的 node_modules\.bin 或者直接 npm prefix 加进系统 PATH。
中转返回乱码或返回 GPT 内容
部分 国内中转站 把 Claude 偷偷换成了便宜模型。验证方法：让 Claude Code 回答”你是哪家公司训练的”，如果答非 Anthropic，就是套壳。
FAQ
Q：国内安装 Claude Code 必须要代理吗？ 不一定。装 CLI 本身用国内 npm 镜像就够。用模型 这一步才看后端：接 Anthropic 必须代理，接国产模型不用代理。
Q：企业内网装不了 Node.js 怎么办？
让运维拿离线 LTS 安装包，npm 走内网私服（Nexus、Verdaccio 等），把 @anthropic-ai/claude-code 镜像到内网。
Q：能用 GitHub Copilot 替代 Claude Code 吗？ 能在”补全代码”这点上替代，但 Claude Code 是 agent 形态（会改文件、跑命令、规划任务），Copilot 偏补全。ClaudeCode 国内平替 中更接近的是国产 agent 类工具（Trae、Comate、通义灵码）。
Q：免费版的 Claude Code 能用吗？ Claude Code 工具本身免费。但调模型的钱要么走你的订阅，要么走 API key，要么走中转。完全免费想长期用，多半得接国产模型免费 quota 或本地 Ollama。
Q：国内 ClaudeCode 镜像网站靠谱吗？ npm 包镜像（淘宝镜像）100% 靠谱。API 中转镜像要自己看资质，跑路是常事。
Q：国内安装 Claude 4.6 还是 Claude Code？ “Claude 4.6” 是模型版本号，不是软件。你装的永远是 Claude Code 这个工具，它在运行时调具体型号的 Claude（4.6 / 4.7 / Opus / Sonnet 等）。
小结
国内安装 Claude Code 教程 拆成两段更好理解：
- 客户端：npm + 淘宝镜像，三分钟搞定，跟国外没差别
- 模型后端：三选一，国际网络直连 / API 中转 / 国产模型平替
如果你刚入门、只是想试一下，建议先用国产模型后端，0 网络成本跑通整个流程，再决定要不要折腾官方账号。本文所有命令、配置都按截至撰写时通用方式给出，具体语法以官方文档为准。