装一个 Claude Code（国内不翻墙完整路径）

📍 入门 3/5 · 上一篇：← 什么是 Claude Code · 下一篇：DeepSeek 配置详解 →

上周一个朋友问我

上周一个洁柔的朋友在群里发了一句:

“国内能装 Claude Code 吗?我刚在抖音看了个 99 元的『翻墙也能装』教程,要不要买?”

我(小牛)看到那条消息那一刻有点心疼——完全不用花这 99 块。也完全不用翻墙。

这一篇就是把那个朋友需要的所有东西,免费、详细、走完一遍。

先说现实

你看到很多英文教程教你跑这一行:

curl -fsSL https://claude.ai/install.sh | bash

在国内 99% 的几率会卡死——claude.ai 这个域名你大概率连不上。

更扎心一点:Anthropic(Claude 的开发公司)不支持中国大陆。账号注册不了、Max 订阅也买不到、官方安装脚本也下载不下来。

那是不是国内就没法用 Claude Code 了?

不是。

Claude Code 本质是一个跑在 Node.js 上的命令行工具。淘宝的 npm 镜像（registry.npmmirror.com）已经完整同步了 Anthropic 官方发布的 npm 包——主包 + 6 个平台的二进制全在，最新版本和所有历史版本都有。

我们换个入口装，全程国内直连。装完之后接 DeepSeek API 跑起来——既不用翻墙，也不用 Anthropic 账号，每月成本几十块。

这一篇手把手教你走完整流程。你不需要懂代码、不需要懂网络、不需要懂 Node.js。看完照着做，5 分钟就能跑出第一句对话。

装之前你要有什么

只要两样：

一台能上网的电脑：Mac、Windows、Linux 任意一台。8 年前的笔记本都能跑。

一个 DeepSeek 账号 + API Key：去 platform.deepseek.com 注册，手机号验证秒过。注册完充 10 元就能用很久——Claude Code 跑一整天大概也就花几毛钱。

DeepSeek 之外，通义千问 API、Kimi API 也都能接 Claude Code，原理一样。这篇拿 DeepSeek 举例——综合最强、价格最便宜。

---

Step 0 — 先认识「终端」

如果你之前只用过浏览器版的 ChatGPT、豆包这类网页 AI，下面这一段必须先看。

「终端」（Terminal，也叫「控制台」「命令行」）是一个看起来像黑色窗口的工具，不用鼠标点击，全部靠键盘输入命令、回车执行。

打开后大致长这样（Mac 上的示意图）：

左上角红黄绿三个小圆点是 macOS 窗口的关闭 / 最小化 / 最大化按钮；下面那行 gerald@MacBook-Pro ~ % 是「提示符」，告诉你「我准备好接命令了」。后面那个闪动的小方块是光标。

你在文章里看到的每一个带灰色背景的代码块，比如：

node --version

意思都是：「把这一行复制粘贴到终端，然后按回车」。

不用怕，看起来吓人，实际就是「输入 → 回车 → 看输出」三步循环。

怎么打开终端

Mac：按住 Cmd + 空格键，弹出搜索框，输入「终端」（Terminal），回车。出现一个白底（或黑底）的窗口，最上面有一行提示符（像 你的名字@MacBook-Pro ~ %）——这就是终端。

Windows 10/11：按 Win 键 + X，菜单里选「终端」（Windows Terminal）或「Windows PowerShell」。出现一个深蓝色或黑色窗口，提示符像 PS C:\Users\你的名字>，打开后大致长这样：

看提示符开头有没有 PS：有 PS 是 PowerShell，没有是老版 CMD。这篇教程用的命令都是 PowerShell 的，认准 PS 开头的窗口。

Linux (Ubuntu / Debian / Fedora 等)：按 Ctrl + Alt + T，出现终端窗口。

第一次试一下

打开终端后，复制下面这行粘贴进去，回车：

echo hello

看到输出 hello——你已经会用终端了。

复制粘贴小提示：Mac 终端用 Cmd+C / Cmd+V；Windows 终端用 Ctrl+C 复制、右键粘贴（注意不是 Ctrl+V，CMD 老版本不支持）。

接下来所有 Step 都在终端里完成，不需要再关掉。

---

Step 1 — 装 Node.js

Claude Code 跑在 Node.js 上，所以先装它。国内装 Node.js 没障碍。

Mac：去 nodejs.org/zh-cn 下载页面，选 LTS（长期支持版，更稳定）那个 .pkg 文件，下载完双击安装包，一路下一步。

Windows：去 nodejs.org/zh-cn 下载页。打开会长这样：

页面顶部默认会推一段 nvm / Docker 安装命令——先忽略它，那是给开发者的进阶选项。

往下滚到「或者获得适用于 Windows … 平台的 Node.js 构建」那一行，按顺序选：

1. 平台：保持 Windows
2. 架构：选 x64（绝大多数 Windows 电脑都是这个，包括所有 Intel / AMD 处理器的笔记本和台式机）

不确定自己是 x64 还是 ARM64：右键桌面上的「此电脑」→「属性」，看「系统类型」那一行。写「64 位操作系统，基于 x64 的处理器」选 x64；写「ARM-based」才选 ARM64。新出的 Surface Pro X / 一些 Copilot+ PC 是 ARM64，其他基本都是 x64。

3. 下载按钮：点左边那个绿色的 Windows 安装程序(.msi)，不要点右边的 独立文件(.zip)——zip 是给开发者手动配置用的，普通人下 msi 双击装最省事。

下载完双击 .msi 文件，一路下一步即可。安装过程中勾上「Add to PATH」（默认是勾的，别取消）。装完关掉所有终端窗口，重新打开一个（这样新装的命令才能被找到）。

Linux (Ubuntu / Debian)：

sudo apt update && sudo apt install nodejs npm

Fedora / CentOS：

sudo dnf install nodejs npm

装完之后，在终端里跑这两条验证：

node --version
npm --version

应该各显示一个版本号（比如 v20.10.0 和 10.2.3）。Node 至少要 v18 以上。

如果显示 command not found: node，说明 PATH 没生效。最简单的修复：关掉这个终端窗口，重新开一个，再试一次。

---

Step 2 — 把 npm 切到淘宝镜像

这一步是国内能跑通的关键。一行命令：

npm config set registry https://registry.npmmirror.com

npm 是 Node.js 自带的「包管理工具」，负责从仓库下载各种 JS 工具。默认仓库是 npmjs.org（国外），国内下载又慢又会卡。这条命令把它切到 npmmirror.com（阿里巴巴维护，国内 CDN，秒下）。

验证：

npm config get registry

输出应该是：

https://registry.npmmirror.com/

这是一次性配置，配完以后这台电脑上所有 npm 操作都走淘宝镜像，不需要再切。

---

Step 3 — 装 Claude Code

一行命令：

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

-g 是「全局安装」，装完任何目录都能用 claude 命令。@anthropic-ai/claude-code 是官方在 npm 上发布的包名。

npm 会从淘宝镜像下载主包 + 自动判断你的平台、下载对应的二进制（约 70MB）。一两分钟搞定。

重要：Mac / Linux 上如果报 EACCES permission denied（权限不够）错误，不要加 sudo。加 sudo 反而会污染你的 npm 权限，以后所有全局包都得用 sudo。

正确做法是把全局目录改到自己的 home 目录（~/ 就是你的 home，比如 /Users/你的名字）：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

上面三行干了：建一个新目录给 npm 用 → 告诉 npm 用这个新目录 → 把这个新目录加到 PATH（让系统能找到 claude 命令）→ 让配置立即生效。

然后重新跑 npm install -g @anthropic-ai/claude-code。

装完验证：

claude --version

应该显示一个版本号（比如 2.1.143）。

---

Step 4 — 配 DeepSeek API（关键一步）

Claude Code 工具装好了，但它默认想连 Anthropic 的服务器——而 Anthropic 国内连不上。我们用「环境变量」告诉它「改去 DeepSeek」。

「环境变量」是写在你系统配置里、所有终端程序都能读到的一组键值对。这里我们设三个变量，告诉 Claude Code：API 服务器地址是 X、用我的 key Y、用模型 Z。

1. 拿 DeepSeek API Key

打开 platform.deepseek.com，看到登录页：

第一次来的话，点右下方「立即注册」用手机号注册（验证码秒到，无需邮箱验证），注册完会自动跳回登录页登入。

登入之后会进入 DeepSeek 开放平台后台。两步操作：

1. 充值（不充值的话 API 调用会被拒）：左侧菜单「充值」→ 选个金额（最低 10 元，普通人一个月用不完）→ 走微信 / 支付宝支付
2. 创建 API key：左侧菜单「API keys」→ 右上角「创建 API key」→ 起个名字（随便填，比如 claude-code）→ 确认

确认后弹出对话框显示新建的 key——以 sk- 开头的一长串字符。

立刻复制保存！关闭对话框就再也看不到这串 key 了。复制后存到密码管理器或者一个 txt 文件里。万一丢了，回到 API keys 页删掉再建一个就行。

2. 设环境变量

Mac：终端跑：

nano ~/.zshrc

~/.zshrc 是你 Mac 启动终端时自动加载的配置文件。nano 是个简单的命令行编辑器。

在文件最底下加这三行（把 sk-你刚才复制的那串 换成你真实的 Key）：

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-你刚才复制的那串"
export ANTHROPIC_MODEL="deepseek-chat"

按 Ctrl+O 然后回车保存，Ctrl+X 退出。

让配置立即生效：

source ~/.zshrc

source 的意思是「重新加载这个配置文件」。不跑这一行，配置要等你下次开新终端才生效。

Linux：跟 Mac 一样，但文件名是 ~/.bashrc（默认 shell 是 bash）。把上面命令里的 .zshrc 都换成 .bashrc 即可。

Windows PowerShell：

notepad $PROFILE

$PROFILE 是 PowerShell 启动时自动加载的脚本文件的路径，notepad 是 Windows 自带的记事本——这条命令的意思是「用记事本打开 PowerShell 的启动配置文件」。

如果提示文件不存在，PowerShell 会问你要不要创建，选是。

在记事本里粘上：

$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你刚才复制的那串"
$env:ANTHROPIC_MODEL = "deepseek-chat"

保存，关掉所有 PowerShell 窗口，重新开一个让配置生效。

详细的 DeepSeek 配置玩法（怎么省钱、怎么切其他国内模型、怎么开 R1 推理模式），看下一篇：Claude Code + DeepSeek 配置详解。

---

Step 5 — 第一次跑

在终端里随便进一个目录（桌面就行）：

cd ~/Desktop

cd 是 change directory（切换目录）的缩写。~/Desktop 就是你的桌面文件夹。

然后启动 Claude Code：

claude

不需要浏览器登录——你已经配了 API key，不走 Anthropic 官方鉴权。

启动后看到 Claude Code 的交互界面，大致长这样：

最下面那个 > 就是输入框，光标在闪——你可以打字了。试一句：

列出当前目录的所有文件，告诉我哪个文件最大

如果它真的列出了文件、还告诉了你最大的那个——装完了 ✓

恭喜。从这一刻起，你电脑上有一个 24 小时待命的 AI 助理，能读你的文件、跑你的命令、改你的代码。

---

Step 6 — 装失败 / 跑不起来：6 个常见坑

国内用户最容易踩到的，按出现频率排：

1. 终端里跑 node --version 报 command not found: node

Node.js 没装上，或者装完 PATH 还没生效。

修：关掉这个终端窗口，重新打开一个，再试一次。还不行就重装 Node.js（Windows 上要确认勾了「Add to PATH」）。

2. npm install 时报 npm ERR! EACCES permission denied

你用了 sudo npm install -g，或者 npm 全局目录权限不对。

修：不要 sudo。按 Step 3 那个黑框框里的四行命令把全局目录改到 ~/.npm-global，然后重装。

3. 装完跑 claude 还是报 command not found: claude

npm 装好了但你的系统找不到 claude 在哪。

修：在终端跑 npm config get prefix，记下输出的路径（比如 /Users/你/.npm-global），然后跑：

echo 'export PATH="/Users/你/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

（把 /Users/你 换成你刚才记下的路径）

4. 启动后报 401 Unauthorized 或 API key 无效

DeepSeek API Key 填错，或账户没充钱，或环境变量没正确导出。

修：

• 检查 API Key 是不是完整复制（前缀是 sk-，后面一长串字母数字）
• 去 DeepSeek 平台看账户余额，至少充 1 块
• 在终端跑 echo $ANTHROPIC_AUTH_TOKEN（Windows 是 echo $env:ANTHROPIC_AUTH_TOKEN），看输出是不是你的 Key

5. 启动后报 connection refused 或网络错误

ANTHROPIC_BASE_URL 填错了。

修：确认这一行一字不差——

ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

是 /anthropic 不是 /v1，是 api.deepseek.com 不是 api.deepseek.ai。

6. Windows 上输出中文乱码

终端默认字符集不是 UTF-8。

修：每次启动 Claude Code 前先在 PowerShell 里跑一下：

chcp 65001

或者一劳永逸：Windows 设置 → 时间和语言 → 语言 → 管理语言设置 → 更改系统区域设置 → 勾选「Beta: 使用 UTF-8 提供全球语言支持」→ 重启电脑。

---

装好了，下一步看什么

你现在有了一个本地的 AI 助理，但还没真正用它干活。接下来：

• 想详细调 DeepSeek（省钱 / 换模型 / 开推理模式）→ Claude Code + DeepSeek 配置详解
• 第一次跟它说话该怎么开口 → 第一次跟 Claude Code 说话
• 让它读你的文件、改你的文件 → 让 Claude 读和改你的文件

---

海外用户怎么办

如果你能稳定上海外网 + 持有海外手机号 / 信用卡：

去 claude.ai 注册账号，订阅 Claude Max（$100/月）或走 Anthropic API 按量付费。然后按官方文档跑 curl claude.ai/install.sh | bash 装。或者继续走这一篇的 npm 路径装工具壳子，但跳过 Step 4 的环境变量配置——启动 claude 后浏览器会自动弹出登录页，登录你的 Anthropic 账号就行。

详细官方安装文档：code.claude.com/docs/en/setup。

---

装的过程中卡在哪一步，发邮箱 [email protected]，我们会精选最常见的坑加进 troubleshooting 速查表。