Claude Code 国内能用吗,官方怎么说
这件事官方没有含糊,Anthropic暂不支持中国大陆用户访问,三处表述值得逐字读一遍:
第一处是支持地区列表。Anthropic 在官网单开一页列出支持的国家和地区,分成「商业 API 访问」和「Claude.ai 访问」两张清单。中国大陆不在其中,中国香港和中国澳门同样不在,列表中包含中国台湾地区。页面还附了一句保留声明:对「多数直接或间接股权归属于列表外国家」的实体,官方保留不提供产品与服务的权利。
第二处是Claude Code 系统要求里的「位置」一栏。官方把「Anthropic 支持的国家/地区」直接列为运行条件之一,与操作系统、内存、Shell 并列。也就是说地区不匹配不是「可能有问题」,而是官方认定的不满足运行条件。
第三处最直接,来自官方简体中文文档的提示框,原文是:「默认配置下,Claude Code 需要能够访问 claude.ai 和 Anthropic API 等端点才能完成安装、登录和正常使用。在中国大陆的网络环境中,这些端点可能无法直接访问。开始前,请先确认所在网络能够连通这些服务。」 按官方给出的网络要求清单,需要连通的域名包括 api.anthropic.com(模型请求与遥测)、claude.ai(账号认证)、claude.com(登录跳转)、platform.claude.com(Console 账号认证与令牌交换)、mcp-proxy.anthropic.com、downloads.claude.ai;走 npm 安装的话还依赖 registry.npmjs.org。
还要先纠正一个流传很广的误解:Claude Code 不是开源软件。它的许可文件全文只有一句话,版权归 Anthropic PBC 所有,使用受 Anthropic 商业服务条款约束。商业条款里有一条「使用限制」,明确禁止用服务去构建竞品或转售、禁止逆向工程,以及禁止协助第三方做这些事。
那官方渠道之外有没有正路?官方文档自己列了几条:Amazon Bedrock、Google Cloud 的 Agent Platform(原名 Vertex AI)、Microsoft Foundry,以及在自有基础设施上搭 LLM 网关,用 ANTHROPIC_BASE_URL 把客户端指过去。前三条的前提是你在这些云的支持地区使用。
同时,官方对第三方网关划了一条明确的界线,原文是:「Anthropic 不认可、维护或审计第三方网关产品,也不支持通过任何网关将 Claude Code 路由到非 Claude 模型。」这句话是理解后面所有方案的钥匙,建议先记住。
客户端安装与官方中文文档入口
好消息是文档和安装这两件事在国内没有障碍。Claude Code 官方文档站有简体中文版,地址是 code.claude.com/docs/zh-CN,共 196 篇;另有繁体中文版 195 篇。整个文档站支持 12 种语言,中文是其中完整度最高的两套之一。文档站还提供 llms.txt(约 47KB)与每页的 .md 版本,方便直接抓取。
安装方式官方给了五种,按系统挑一种即可:
| | |
|---|
| | curl -fsSL https://claude.ai/install.sh | bash |
| | PowerShell:irm https://claude.ai/install.ps1 | iex;CMD:curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| | brew install --cask claude-code(稳定渠道);claude-code@latest 为最新渠道 |
| | winget install Anthropic.ClaudeCode |
| | npm install -g @anthropic-ai/claude-code |
系统要求:macOS 13.0 以上、Windows 10 1809 以上、Ubuntu 20.04 以上、Debian 10 以上、Alpine Linux 3.19 以上;内存 4GB 起步,x64 或 ARM64;Shell 支持 Bash、Zsh、PowerShell 或 CMD。Windows 上建议补装 Git for Windows,否则 Claude Code 只能用 PowerShell 当 Shell 工具,部分依赖 Bash 的能力用不了。
Node 版本有个要留意的地方:不少厂商文档写「Node.js 18 以上」,但 npm 包当前声明的是 Node 22.0.0 以上。按高的一档准备更稳妥。
客户端形态有四种:终端 CLI、IDE 扩展(VS Code 与 JetBrains)、桌面应用(macOS、Windows、Linux),以及网页版。
国内 4 家厂商的兼容端点对照
国内厂商的做法是提供一套 Anthropic 兼容端点(对应 Anthropic 的 Messages API 格式),Claude Code 把请求发给厂商而不是 Anthropic,模型由厂商提供。这条路径的特点是:客户端用官方的,模型和计费都走国内厂商,网络上也只需要连通国内的服务。
下面四家都有公开的官方接入文档,端点在核查时逐个实测过:不带鉴权请求会返回各平台特有的 401 错误体,说明路径真实存在。
| | | |
|---|
| 按量计费:https://dashscope.aliyuncs.com/apps/anthropic
Coding Plan:https://coding.dashscope.aliyuncs.com/apps/anthropic | qwen3.7-max、qwen3.7-plus、qwen3.6-flash | docs.modelstudio.console.alibabacloud.com/zh/model-studio/claude-code |
| https://api.deepseek.com/anthropic | deepseek-flash[1m]、deepseek-flash | api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code |
| https://open.bigmodel.cn/api/anthropic | | docs.bigmodel.cn/cn/guide/develop/claude |
| https://api.moonshot.cn/anthropic | kimi-k3[1m]、kimi-k2.7-code | platform.kimi.com/docs/guide/claude-code-kimi |
阿里云百炼的端点按计费方式分了三套,用错组合会直接报鉴权失败。按量计费配 Model Studio 的 sk- 开头通用 Key,Coding Plan 配套餐专用 Key,两套不能混用。这是官方文档里排在第一位的常见故障。
配置步骤与官方报错对照
四家厂商的配置思路一致,具体命令以各自官方文档为准。核心流程是这五步:
- 装 Node.js(按上文建议备到 22 以上),Windows 用户补装 Git for Windows;
- 用官方方式装客户端,例如 npm install -g @anthropic-ai/claude-code;Kimi 官方文档还建议加 --registry=https://registry.npmmirror.com 走国内镜像;
- 去对应厂商平台注册并创建 API Key,注意 Coding 套餐要拿套餐专用 Key,不是平台通用 Key;
- 编辑 ~/.claude/settings.json(Windows 为 用户目录\.claude\settings.json),在 env 字段里写两个关键变量:ANTHROPIC_BASE_URL 指向厂商端点,ANTHROPIC_AUTH_TOKEN 填厂商 API Key。厂商文档通常还会给模型档位映射(主模型、子 Agent 模型分别用哪个);
- 厂商文档里都包含一项:把 ~/.claude.json 的 hasCompletedOnboarding 设为 true。这一步的作用是让客户端不再弹出 Anthropic 账号登录引导,因为你用的是厂商端点,本来就没有 Anthropic 账号可登。改完新开一个终端窗口再执行 claude,用 /status 核对 Base URL 与 Token 是否指向厂商。
几个高频报错,官方文档里都有对应排查:
| | |
|---|
| API Key 类型与 Base URL 不匹配(最典型:用通用 Key 配了套餐端点) | |
提示无法连接 Anthropic 服务(ERR_BAD_REQUEST) | 环境变量没生效,客户端仍在连官方端点;hasCompletedOnboarding 未设 | 用 /status 核对两个变量,改完新开终端窗口重试 |
| ANTHROPIC_MODEL 等模型名拼错,或多了空格、引号 | 照厂商文档的模型名逐字核对,包括 [1m] 这类后缀 |
| ~/.claude/settings.json 里的残留配置会覆盖终端里 export 的同名环境变量 | 先清理残留的 ANTHROPIC_* 变量;同时配过 ANTHROPIC_API_KEY 的要删掉,避免与 ANTHROPIC_AUTH_TOKEN 冲突 |
| Anthropic 兼容端点通常只提供 /v1/messages,不提供模型列表接口 | 官方说明这条提示不影响正常使用,模型由配置里的映射指定 |
| | |
套餐额度与官方成本对照
国内这条路线的成本取决于厂商套餐。以智谱 GLM Coding Plan 为例,官方文档公开的是积分档位,按 5 小时和每周两个窗口双重限制:
刷新规则官方也写清了:5 小时积分采用动态刷新,在请求消耗满 5 小时后重置;周积分从下单时起以 7 天为一个周期。额度耗尽后要等下一个 5 小时周期恢复,系统不会自动去扣你账户里的其他余额。
作为参照,Anthropic 官方文档给出的企业侧成本口径是:平均每个开发者每个活跃日约 13 美元,每人每月 150 至 250 美元,90% 的用户每个活跃日控制在 30 美元以下。两边的计量单位不同,不能直接换算成倍数,但量级差异是明显的,这也是国内开发者选厂商端点的主要动因。
各家套餐的具体金额与权益会随活动调整,官方没有在文档站公示,需要到各自控制台的套餐页确认当期标准。
国产原生 CLI 替代方案
如果你要的只是「一个能在国内顺畅跑起来的 AI 编程 CLI」,其实还有一条完全绕开上述所有限制的路:用国产厂商自研的命令行工具。这类工具从模型到客户端到计费都在国内体系内,不涉及 Anthropic 的软件与条款,也就没有那层边界问题。
以阿里云的 Qwen Code 为例,它是官方出品的终端 AI 编程工具,安装走国内 CDN:
- Linux / macOS:curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash;
- Windows:irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex;
- 首次启动会引导选择模型提供方,可选阿里云百炼(Coding Plan、Token Plan 或标准 API Key),也可选内置的第三方提供方(DeepSeek、MiniMax、Z.AI、Kimi、OpenRouter),还支持指向本地服务或代理的自定义提供方。
各家对比起来是这样:
| | | |
|---|
| | | |
| | | 已习惯 Claude Code 工作流、看重它的 Skills 与子 Agent 机制 |
| | | |
使用前必须注意的几点
- Claude Code 是专有软件,许可绑定 Anthropic 商业条款。它的许可文件不是开源协议,全文只有「版权归 Anthropic PBC 所有,使用受商业服务条款约束」这一句。商业条款里含使用限制条款,禁止用于构建竞品、转售、逆向工程。选方案前先把这一点纳入考虑。
- 厂商端点这条路,厂商侧支持,Anthropic 侧明确不支持。官方原文是「Anthropic 不认可、维护或审计第三方网关产品,也不支持通过任何网关将 Claude Code 路由到非 Claude 模型」。这意味着一旦出问题,Anthropic 既不提供支持也不承担任何责任,风险自担。第四家之后的厂商如果宣传「官方支持」,指的是它自己官方的文档,不是 Anthropic 的认可。
- 套餐额度有适用范围限制,不是充了钱就能随处调用。智谱官方写明:套餐仅限在官方支持的指定工具与产品环境中使用,在除规定工具外调用 API 不可享用套餐额度。买套餐前先确认你用的客户端在厂商的支持清单里。
- 不要用第三方「中转站」或个人转售的 Key。这类渠道的常见问题是密钥来源不明、随时失效、计费口径不透明,而编程 Agent 的上下文里往往带着你的完整代码库。要省钱就在厂商官方渠道选套餐,没有更安全的捷径。
- Windows 上先装 Git for Windows。不装的话 Claude Code 会退化成用 PowerShell 当 Shell 工具,部分依赖 Bash 的能力用不了。
- 旧配置一定要清干净。官方文档专门提醒:~/.claude/settings.json 里残留的旧配置会覆盖终端里 export 的同名环境变量,导致新配置静默失效或请求被改写。同时存在 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 时也会冲突,留一个即可。
- API Key 别硬编码、别进仓库。四家厂商的文档都在同一处提醒:妥善保管密钥,不要泄露给他人,也不要直接写死在代码里。建议用环境变量或系统的密钥工具管理,并定期轮换。
- 企业团队走采购流程,别让员工各自摸索。官方文档给出的是 Teams 与 Enterprise 两条企业路径,支持集中计费、SSO 和用量归集。个人零散拼凑的方案在合规审计时通常过不了关。
Claude Code 常见问题解答
Q:Claude Code 在国内能直接注册使用吗?
A:不能。中国大陆不在 Anthropic 的支持地区列表里,官方中文文档也明说这些端点在中国大陆的网络环境中可能无法直接访问。注册与登录环节走不通,这与客户端装不装得上无关。
Q:官方文档有中文版吗?
A:有,而且是完整的。code.claude.com/docs/zh-CN 下有 196 篇简体中文文档,另有 195 篇繁体中文版,覆盖安装、配置、子 Agent、钩子、MCP、Agent SDK 等全部主题。注意路径必须带连字符和大小写写对,写成 /docs/zh 或 /docs/cn 都会是 404。
Q:在国内怎么让 Claude Code 跑起来?
A:把客户端指向国内厂商的 Anthropic 兼容端点,也就是上文的配置方式。四家可选:阿里云百炼、DeepSeek、智谱 GLM、Kimi,各自都有官方接入文档和现成的配置示例。前提是你接受这块 Anthropic 侧不提供支持。
Q:走厂商端点要不要海外网络或者代理?
A:不需要,这正是这条路径的价值所在。请求发往的是国内厂商的端点,客户端安装可以走国内 npm 镜像,全程不用接触 Anthropic 的服务。反过来说,如果你的方案里出现了需要额外网络工具才能连通 Anthropic 的环节,那说明配置没生效。
Q:Claude Code 是开源的吗?
A:不是。它的许可文件全文只有一句版权声明,并规定使用受 Anthropic 商业服务条款约束。这一点常被误解,网上不少文章把它当成开源工具介绍,实际并非如此。
Q:一个月大概要花多少钱?
A:看选的路径。走国产厂商套餐的话,各家按订阅或积分计费,具体金额在厂商控制台的套餐页,本文核查时官方文档站未公示;作为对照,Anthropic 官方给出的企业侧口径是平均每人每活跃日约 13 美元、每月 150 至 250 美元。
Q:用厂商端点会被封号吗?
A:账号侧的风险主要看厂商,用官方渠道买的套餐和官方文档给的配置方式,属于厂商明确支持的产品形态。需要留意的是 Anthropic 侧的态度,官方明确不支持通过网关把 Claude Code 路由到非 Claude 模型,也就是说这条路 Anthropic 不背书、不提供支持,责任边界要自己划清。
Q:企业团队该怎么选?
A:有海外主体、要走合规采购的,官方路径是 Claude for Teams 或 Enterprise,通过 claude.com 的销售渠道,支持按座位分配额度和集中计费;也可以用 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 在对应云的支持地区部署。纯国内团队建议直接评估国产厂商的企业方案或国产原生 CLI。
Q:只想要个能用的 AI 编程 CLI,最省事的选择是什么?
A:装 Qwen Code。它是阿里云官方出品,安装包走国内 CDN,首次启动会引导你选模型提供方,可以直接选百炼套餐,也能接 DeepSeek、MiniMax、Kimi 等第三方。它不依赖也不涉及 Anthropic 的任何东西,是本文列出的方案里边界最干净的一条。
支持地区清单、各厂商套餐与模型在架情况都会随官方更新调整,动手前在官方页面确认当期状态即可。想持续跟进 Claude Code 的可用性变化与国内 AI 编程工具的版本动态,可以关注本站的 AI 工具栏目,有新的接入方案我们会同步更新。