《Claude Code 中国区完整安装指南（含 DeepSeek API 接入）》

---

一、安装前的硬性检查

1. 操作系统版本

系统要求

• 操作系统: macOS 10.15+、Windows 10/11、Linux (Ubuntu 20.04+/Debian 10+)
• Node.js: 18.0 或更高版本
• 内存: 建议 4GB 以上
• 本地git仓库

如果你还在用 Windows 7 / 8 或 macOS 10.13 及更早，无法安装。

2. 网络要求(如果使用官网的安装必须要魔法,如果不会魔法直接跳到安装方式二)

• 需要能正常访问 claude.ai 及 anthropic.com 相关域名。(如果在国内大陆地区的话直接pass了)

• 需要提前准备好 稳定的代理环境（系统代理或透明代理均可）。

3. 付费账户

Claude Code 本身的套餐如下（Claude Code 本身是免费的命令行工具，但它需要调用大语言模型 API 才能工作。）

账户类型	费用	说明
Claude Pro	$20/月	最推荐，个人开发者首选
Claude Max	按量或订阅	高用量用户
Anthropic API 额度	预付费	适合开发团队，按 token 计费

CC的大模型非常好用，但是CC的大模型不支持国区加上价格略贵，所以一般推荐用其他大模型替代

安装过程会触发浏览器 OAuth 登录，届时会校验你的账户权限。

---

二、安装方式

如果想最完整的可以看千问的claude code接入,已经十分详细了https://help.aliyun.com/zh/model-studio/claude-code#8ab558818fv3f

方式一：原生脚本安装（最适合新手宝宝的一键式安装）

中文站地址:https://claude-zh.cn/guide/getting-started

这是安装脚本，安装前必须要仔细审查，推荐去中文站对比无误后再使用

macOS / Linux / WSL:

source <(curl -fsSL https://claude-zh.cn/scripts/install.sh)

Windows (PowerShell):

& ([scriptblock]::Create((New-Object Net.WebClient).DownloadString("https://claude-zh.cn/scripts/install.ps1")))

这个安装方式的优势在于:

注意:必须将claude配置到PATH中,否则无法正常运行(一般下载的时候会自动配置)

没有自动配置PATH的解决方法:

系统	自动配置失败时的手动方法
Windows	1. where claude 找到路径 2. 系统属性 → 环境变量 → Path 添加该目录 3. 重启终端
macOS/Linux	echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

注意事项

•  或者直接 关闭当前终端，重新打开一个新终端。否则 claude 命令会提示“找不到”。

• 普通 PowerShell 窗口可能因执行策略报错。如果报错，先运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force，再重新执行安装命令。

• 安装后需要重启你的终端（不是刷新，是关闭重开）。

---

方式二：npm（Node.js 环境）

前提：Node.js 版本 ≥ 18.0.0

检查 Node 版本

node --version   # 必须 v18.x 或更高

如果没有按下面步骤安装

macOS:

brew install node

Windows:

# 方法一：从官网下载安装包
# 访问 https://nodejs.org/ 下载 LTS 版本安装包

# 方法二：使用 winget（Windows 包管理器）
winget install OpenJS.NodeJS.LTS

Linux/WSL:

# 适用于 Ubuntu/Debian 以及 Windows 的 WSL 环境
# WSL 是 Windows 上的 Linux 子系统，安装方式与 Linux 相同
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

安装claude code

# 设置国内镜像源（推荐，加速下载）
npm config set registry https://registry.npmmirror.com

# 安装最新版本
npm install -g @anthropic-ai/claude-code

如果报错,可能是权限不够,claude code官网给出的解决办法

验证安装是否成功（所有系统通用）

bash

claude --version

如果输出版本号如

2.1.92 (Claude Code)

说明安装成功。

---

三、安装后必须做的四项检查

1. 确认命令可用

bash

which claude   # macOS/Linux: 应输出路径如 /Users/你的名字/.claude/bin/claude
where claude   # Windows: 应输出完整路径

如果提示“找不到命令”，说明 PATH 未生效。请重启终端，或者手动执行：

• macOS/Linux: export PATH="$HOME/.claude/bin:$PATH"

• Windows: 在系统环境变量中手动添加 %USERPROFILE%\.claude\bin

2. 运行健康检查

bash

claude doctor

这条命令会检查：

• 二进制文件完整性

• 自动更新服务是否运行

• 网络连通性（会尝试连接 claude.ai）

如果有红色报错，根据提示修复。最常见的错误是网络不通，见下一节。

3.配置 Claude Code 设置(只有进行了这个才能跳过登陆)

创建或编辑 ~/.claude/settings.json，添加以下配置以跳过首次引导、禁用非必要网络请求和 co-authored-by 标记：

{
  "hasCompletedOnboarding": true,
  "env": {
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "includeCoAuthoredBy": false
}

4.接入API

claude code原生大模型在中国区内无法使用,因此需要接入其他大模型做替代,在这里仅选择最好接入的deepseek做演示（deepseek非CC原生大模型，接入时可能会出现工具调用不了，无法读写上下文的情况，故以下演示仅供参考，但绝大多数时候是能够够正常使用的）

访问deepseek官网https://www.deepseek.com/

选择API开放平台,选择API keys,点击创建API keys,复制key

在自己的C盘的用户目录下找到.claude文件中的setting.json文件

把下面的key改成你复制的粘贴进去

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "复制的key放这",
    "ANTHROPIC_MODEL": "deepseek-reasoner",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
    "ANTHROPIC_MAX_TOKENS": "6000",
    "ANTHROPIC_TEMPERATURE": "0.2",
    "API_TIMEOUT_MS": "600000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

其中的ANTHROPIC_TEMPERATURE如果用于代码数学推理可以调低,如果进行文学创作就可以调到0.8以上.保存之后就可以启动打开了
 

---

最后一步：验证可以启动

不需要执行任何任务，只需运行：

bash

claude

如果出现类似 Welcome to Claude Code 的提示，并显示一个交互式提示符 >，说明安装完全成功。此时按 Ctrl+C 退出即可。

打开方式终端输入claude或者claude code

点击YES信任文件夹,就会出现这样的界面

随便问一个如果没有出bug,那么恭喜你,你已经把上手难度最高,世界上最好用的ai编程工具安装成功了

---

四、常见安装错误及解决

错误现象	可能原因	解决方案
curl: command not found	系统没有 curl	安装 curl（Linux: apt install curl，macOS: 自带，Windows 10+ 自带）
Permission denied (publickey)	安装脚本试图从 GitHub 拉取但 SSH 密钥未配置	改用 HTTPS 方式，原生脚本会自动 fallback，不用管
brew: command not found	没有安装 Homebrew	去 brew.sh 安装 Homebrew 后再试
npm ERR! code EACCES	npm 全局权限不足	执行官方给出的解决方法,在上面提到了
claude: command not found 但安装成功	PATH 未更新	重启终端；或手动添加 PATH（见第七节）
Authentication failed	账户权限不足	一般是没钱了,你个有tokens的API就好了

---

 五、卸载方法（如果你需要重装）

TIP

重新安装后,环境变量配置和 ~/.claude/settings.json 会保留,无需重新配置。

原生安装：

• macOS/Linux: rm -rf ~/.claude 并删除自动更新配置文件（launchctl 或 systemctl 停用服务）

• Windows: 删除 %USERPROFILE%\.claude 目录

Homebrew：

bash

brew uninstall --cask claude-code

npm：

bash

npm uninstall -g @anthropic-ai/claude-code

六、免责声明与参考资料

• 官方文档：https://docs.anthropic.com/en/docs/claude-code

• 官方 npm 包：@anthropic-ai/claude-code

• GitHub 仓库：https://github.com/anthropics/claude-code

本文提供的第三方脚本和 DeepSeek 配置方案仅供技术参考，使用非官方 API 端点所产生的任何安全、账户、法律问题，本文作者及发布平台不承担责任。建议优先使用官方 Anthropic API。