Claude Code 安装本身不需要梯子——用 npm 加国内镜像源可以顺利完成安装。但安装完成后,Claude Code 默认需要连接 claude.ai 和 Anthropic API 才能登录和使用,这一步在国内直连不通。以下详解安装环节、登录环节各自对网络的要求,以及国内可用的三种替代方案。 结论先行:安装不需要,登录使用需要
把问题拆成两段来看:
| | |
|---|
| | 用 npm 指定国内镜像源即可完成,无需访问 claude.ai |
| | 浏览器打开 claude.ai 登录页面,国内直连不通 |
| | Anthropic API 端点在国内不可直接访问 |
Claude Code 官方文档(code.claude.com)也明确承认了这一点:
「默认配置下,Claude Code 需要能够访问 claude.ai 和 Anthropic API 等端点才能完成安装、登录和正常使用。在中国大陆的网络环境中,这些端点可能无法直接访问。」
安装步骤(国内全程不需要梯子)
前置条件
需要已安装 Node.js(18 及以上版本)。国内可从 npmmirror.com 下载 Node.js 安装包。
安装命令
使用 npm 安装并指定国内镜像源:
验证安装是否成功:
正常输出版本号(如 2.1.x (Claude Code))即为安装成功。
Windows PowerShell 用户注意
执行命令时确保在 PowerShell 窗口中(提示符以 PS C:\ 开头),而非 CMD(提示符为 C:\)。两者命令格式不同,若提示「不是内部或外部命令」请先确认终端类型。
登录与使用:三条路径对比
安装完成后,根据网络情况选择以下三条路径之一:
| | | | |
|---|
| | | Claude Sonnet 4.6 / Opus 4.6(真品) | |
| | 按用量付费(调用成本通常低于 Anthropic 官方定价) | | |
| | | deepseek-coder-v2 / deepseek-chat | |
路径A:官方账号 + 梯子(推荐有代理的用户)
如果你有稳定的代理工具,按以下步骤使用官方 Claude:
- 在终端配置代理环境变量(根据实际端口调整):
export https_proxy=http://127.0.0.1:7890 export http_proxy=http://127.0.0.1:7890
- 运行
claude 启动,浏览器会自动打开 claude.ai 登录页面
官方订阅价格:Pro $20/月、Max 5x $100/月、Max 20x $200/月。需要国际支付方式(外币信用卡、PayPal 等)。
路径B:火山引擎 Ark Coding Plan(国内直连,无需梯子)
- 访问 volcengine.com,搜索「Ark Coding Plan」并订阅
- 配置环境变量:export ANTHROPIC_API_KEY="your-ark-api-key" export ANTHROPIC_BASE_URL="https://ark.cn-beijing.volces.com/api/coding"
可用模型包括豆包 seed-code-preview(代码能力接近 Claude Sonnet 4.5)、DeepSeek-V3.2、GLM-4.7 等。官方每日赠送 500K tokens 免费额度。
路径C:DeepSeek 兼容接口(免费,无需梯子)
- 注册 DeepSeek 账号(platform.deepseek.com),获取 API Key
- 配置环境变量:
export ANTHROPIC_API_KEY="your-deepseek-api-key" export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
DeepSeek 提供 Anthropic 协议兼容接口,国内直连无障碍。新用户注册即送免费 tokens,可用于体验基础功能。
配置多模型切换(进阶)
国内用户推荐在用户目录下创建配置文件,统一管理多模型切换:
配置文件示例(DeepSeek 接口):
Claude Code 国内使用注意事项
- npm 弃用警告:自 v2.1.15 起官方推荐使用原生安装脚本而非 npm,但国内用户无法访问 claude.ai 安装脚本时,npm + 国内镜像仍是唯一可行方式,安装后可正常使用
- 代理封号风险:使用官方 Claude 账号 + 代理时,Claude Code 会检测系统时区,封号事件偶有发生,建议通过环境变量
ANTHROPIC_API_KEY 直接配置 API Key 而非走 OAuth
- PATH 问题:Windows 上若提示「claude 不是内部或外部命令」,关闭终端后重新打开(或手动将
%USERPROFILE%\.local\bin 加入 PATH)
- Windows 终端类型区分:PowerShell 提示符为
PS C:\,CMD 为 C:\;原生安装脚本 irm 命令仅在 PowerShell 中有效
- 国内镜像不是梯子:使用 npmmirror.com 镜像加速 npm 下载,仅解决安装包下载问题,不代表能访问 claude.ai
- DeepSeek 接口为兼容层:DeepSeek 兼容接口体验的是 DeepSeek 模型(非真正 Claude),对于纯代码补全场景足够,但复杂推理任务表现与 Claude 有差距
- 火山引擎按量计费:Ark Coding Plan 费用按实际用量扣除,建议设置用量预警,避免意外超支
- 数据安全提示:所有 AI 生成或修改的代码,必须经人工校验和功能测试后再上线使用,不可直接部署
以上信息综合自 Claude Code 官方文档(code.claude.com)、Anthropic 官方快速开始指南及火山引擎、DeepSeek 官方平台。具体功能、价格与网络政策可能随版本更新调整,以各平台官方实时显示为准。