《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 nodeWindows:
# 方法一：从官网下载安装包
# 访问 https://nodejs.org/ 下载 LTS 版本安装包
# 方法二：使用 winget（Windows 包管理器）
winget install OpenJS.NodeJS.LTSLinux/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.json(这个文件要和和.claude在同一目录下)，添加以下配置以跳过首次引导、禁用非必要网络请求和 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-codenpm：
bash
npm uninstall -g @anthropic-ai/claude-code六、免责声明与参考资料
-
官方 npm 包：
@anthropic-ai/claude-code
本文提供的第三方脚本和 DeepSeek 配置方案仅供技术参考，使用非官方 API 端点所产生的任何安全、账户、法律问题，本文作者及发布平台不承担责任。建议优先使用官方 Anthropic API。
759
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
