Claude Code 国内怎么用：镜像、订阅与实战配置

云上的幻象2026-09-187 分钟阅读2,745 字00

100%

一句话结论

Claude Code 国内怎么用？核心就两步：用国内镜像把 CLI 装好，再把认证指向官方订阅或第三方兼容平台（如智谱、DeepSeek 的 Anthropic 兼容接口）。全程无需翻墙，也能跑通终端里的智能体编程。

为什么国内用 Claude Code 总卡在第一步

Claude Code 是 Anthropic 出的终端智能体编程工具，官方安装脚本和 API 默认走 Anthropic 服务器。国内网络直连常被区域限制拦下，于是「装不上」「连不上」成了两大劝退点。但这两个问题都有干净的解法，本质是把安装源和认证源都换成国内可达的镜像与兼容平台。

国内直连官方 API 常被拦截，推荐走第三方兼容平台。只要把 ANTHROPIC_BASE_URL 指向其 /api/anthropic 端点，Claude Code 全套协议都能复用，无需改任何命令。

三条可行路径，按省心程度排序

方案一：官方订阅（最正统）

如果你已有 Claude Pro / Max 订阅且网络环境可达官方服务，登录后 Claude Code 自动读取凭证，直接使用。优势是模型最新、协议最稳；劣势是国内网络波动时容易掉线。

方案二：第三方兼容平台（最省心，推荐）

智谱、DeepSeek、LongCat、阿里云百炼等都提供了兼容 Anthropic 协议的接口。注册拿到 API Key，填进配置即可。价格通常比官方订阅低，支付也方便。以智谱为例，其兼容端点为 https://open.bigmodel.cn/api/anthropic。

方案三：国内安装镜像（解决装不上）

安装阶段卡住，多半是 npm 拉不到包。把 npm 源切到国内镜像即可：--registry=https://registry.npmmirror.com。也有社区维护的安装脚本镜像（如 c.zstring.cn），一行命令替代官方 claude.ai/install.sh。

settings.json 实战配置

所有认证与模型选择写在用户目录的 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json）。一份可直接复制的模板：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的第三方Key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_MODEL": "glm-4.5-flash",
    "DISABLE_AUTOUPDATER": "1"
  }
}

ANTHROPIC_MODEL 指定默认模型；DISABLE_AUTOUPDATER 关掉后台自动更新，避免无网络时反复报错。

国内安装五步走

装 Node.js 18+；Windows 额外装 Git for Windows（Claude Code 依赖 Git Bash 执行命令）。

国内镜像安装 CLI：npm install -g @anthropic-ai/claude-code –registry=https://registry.npmmirror.com

终端执行 claude –version，能输出版本号即安装成功。

编辑 ~/.claude/settings.json，填入第三方平台 Key 与 BASE_URL。

输入 claude 启动，用自然语言让它「分析这个项目」「跑测试并出报告」。

避坑清单

为什么一定要关掉自动更新？

Claude Code 装完会在后台静默连接 Anthropic 服务器下载新版本。没有网络环境时它连不上更新服务器，会反复报错甚至卡住启动。在 settings.json 的 env 里加 “DISABLE_AUTOUPDATER”:”1″，需要时再手动 npm install -g 更新即可，全程走国内镜像、可控。

Windows 常见报错：command not found / git 相关

基本都是缺 Git for Windows 或没重开终端。装好 Git 后关闭并重新打开终端，再跑 claude –version 验证。