国内不翻墙部署 Claude Code：npm 镜像 + cc-switch 接入 DeepSeek V4 图文详解

你将学到

• 用 npm 淘宝镜像在国内直接安装 Claude Code（Mac 和 Windows 均适用，全程无需翻墙）
• 申请 DeepSeek API Key，用国内直连的 DeepSeek V4 替代每月 $20 的 Claude Pro 订阅
• 用 cc-switch 桌面工具一键切换 AI 提供商，以后添加新模型只需 30 秒

适合人群：国内没有翻墙条件，或不想将网络工具与 AI 工具混在一起的职场用户。

预计阅读：22 分钟

一、两道门槛，挡住了多少人

我知道有一类读者，你们在专栏前几讲读得很起劲，但到了第 5 讲的安装步骤，卡住了。

不是因为不懂操作。是因为你打开了文档，看到第一条命令：

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

然后……什么都没发生。转圈，超时，连接失败。

因为 claude.ai 在国内被墙了。安装脚本根本下载不下来。

好不容易找到了别的教程说“用 npm 安装”，装好之后登录，又发现：Claude Code 需要付费订阅才能用，最低 $20/月的 Claude Pro，而且要绑定境外信用卡。

两道门槛：翻墙 + 境外支付。这不是技术门槛，是现实门槛。

这篇加餐就是为了帮你绕开这两道门槛，让你今天就能把 Claude Code 跑起来。

路线很清晰，四步：

1. 装 Node.js（从国内镜像站下载）
2. 用 npm 淘宝镜像装 Claude Code（绕过 claude.ai 的封锁）
3. 申请 DeepSeek API Key（国内直连，支付宝/微信充值，按量计费）
4. 用 cc-switch 配置切换（图形界面，30 秒接入 DeepSeek V4）

对比标准安装路径和国内路径的区别：

两条路走到最后，你用的是同一个 Claude Code 程序，只是背后调用的 AI 模型从 Anthropic 的服务器变成了 DeepSeek 的服务器。使用体验几乎一样，费用差了十几倍。

好，我们开始。

二、第一步：装好 Node.js

Claude Code 通过 npm 安装时，需要 Node.js 18 或更高版本。Node.js 是一个 JavaScript 运行环境——你不需要了解它是什么，把它当成“跑 npm 命令所需的基础软件”就行。

从国内镜像站下载

Node.js 官网（nodejs.org）在国内可以访问，但有时候慢。国内专门有一个镜像站：nodejs.org.cn，下载速度快，还有中文界面。

打开 https://nodejs.org/en/download，找到 LTS 版本（Long Term Support，长期支持版），点击你的系统对应的下载按钮：

• Windows：下载 .msi 安装包，双击按向导安装，一路“下一步”即可
• macOS：下载 .pkg 安装包，双击按向导安装

安装完成后，验证一下是否装好了。

Mac 用户：打开终端（Terminal），输入：

node -v

Windows 用户：按 Win 键，搜索“命令提示符”或“PowerShell”，打开后输入：

node -v

如果看到类似 v22.x.x 或 v20.x.x 这样的版本号，说明 Node.js 已经装好了。

顺手再验证 npm 是否也在：

npm -v

正常输出类似 10.x.x。

如果 node 命令找不到（Windows 常见问题）

Windows 上有时候安装完 Node.js，在命令行里还是提示 'node' is not recognized。原因是系统 PATH 环境变量还没更新。解决方法：关掉命令提示符窗口，重新打开一个新的，再试一次。99% 的情况重开窗口就解决了。

三、第二步：用 npm 淘宝镜像装 Claude Code

Node.js 装好之后，就可以用 npm 来安装 Claude Code 了。

npm 是 Node.js 自带的包管理工具，默认从 npmjs.com 下载软件包。好消息是：npmjs.com 在国内可以直连，但网速有时候不稳定。更稳妥的做法是加上淘宝提供的 npm 镜像（npmmirror.com），让下载走国内服务器。

Mac 安装命令

打开终端，复制以下命令，粘贴后回车：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

Windows 安装命令

打开命令提示符（CMD）或 PowerShell，输入：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

两条命令完全一样，--registry 参数指定了使用淘宝的国内镜像源。

安装过程大约需要 1-3 分钟，你会看到进度条滚动。正常完成后输出类似：

added 1 package in Xs

安装完成后，验证 Claude Code 是否装好：

claude --version

能看到版本号就成功了。

关于“npm 方式是否还被支持”的说明

你可能在某些文章里看到说 npm 安装方式已经“过时了”。我专门查了 Claude Code 官方文档（截至 2026-05-12），npm 安装仍然被列在官方支持的安装方式里，位于「Advanced installation options」章节。

官方推荐用 curl 命令安装是因为更方便、自动更新。但那个 curl 命令国内打不开，所以 npm 这条路是国内用户目前唯一不需要翻墙的安装路径，而且是官方支持的。

💡 版本提醒：安装时的 --registry 参数只影响这一次的下载来源，不会永久改变你的 npm 配置。

后续升级 Claude Code 时重新带上这个参数就行：npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

四、第三步：申请 DeepSeek API Key

Claude Code 装好了，但现在还不能直接用——因为用 claude.ai 账号登录需要翻墙，而且还要 Claude Pro 订阅。

我们换一条路：用 DeepSeek V4 替代 Claude 原生模型。

DeepSeek 是国内深圳深度求索公司的开源大模型，最新的 V4 版本在 2026 年 4 月底发布，性能已经和 Claude Sonnet 相当。更重要的是：API 国内直连，支付宝/微信充值，按实际用量计费。

成本对比：

DeepSeek V4 Pro 当前定价（截至 2026-05-12）：

• 输入：$0.435/百万 token，折扣有效期至 2026-05-31
• 输出：$1.74/百万 token
• 人民币定价参考：约 ¥1/百万 token 输入

Claude Pro $20/月是固定费用，不管你用多少。DeepSeek 是按量付费，如果你只是每天用一两个小时，实际花费可能每月不到 ¥20。

💡 如果你加上 [1m] 后缀（如 deepseek-v4-pro[1m]），模型会启用完整的 100 万 token 上下文窗口，不加则默认 20 万 token。日常用 20 万就够了。

注册并获取 API Key

1. 打开 https://platform.deepseek.com（国内直连，不需要翻墙）
2. 注册账号（支持手机号注册）
3. 登录后，点击左侧菜单的「API Keys」
4. 点击「创建 API Key」，给它起个名字（比如「claude-code」），点击确认
5. 复制生成的 Key，妥善保存（这个 Key 只显示一次）

新用户注册通常有一定的免费额度，可以先用免费额度试用，感觉好再充值。充值支持微信、支付宝，最低充 ¥10 起，很方便。

API Key 的格式是 sk- 开头的一长串字母数字，先复制保存好，下一步要用。

五、第四步：安装 cc-switch，接入 DeepSeek V4

现在我们有了两件东西：装好的 Claude Code + DeepSeek 的 API Key。

剩下的问题是：怎么告诉 Claude Code “去用 DeepSeek 而不是 Anthropic”？

本质上是设置几个环境变量。你可以手动在终端里 export，但每次重启终端就消失了，很麻烦。

这里推荐一个更优雅的工具：cc-switch。

cc-switch 是什么

cc-switch 是一个跨平台桌面 App（基于 Tauri 2.8 开发），专门用来管理 Claude Code、Codex、Gemini CLI 等 AI 命令行工具的「模型提供商配置」。

类比一下：你手机上可能装了多个地图 App，平时用高德，出国换谷歌地图。cc-switch 就是那个「一键切换导航 App」的工具，只不过切换的是 AI 模型提供商。

它内置了 50+ 家主流提供商的预设配置，也支持自定义任意 API 地址。DeepSeek 已经在内置列表里，添加只需要填入你的 API Key。

安装 cc-switch

cc-switch 的 GitHub 仓库：https://github.com/farion1231/cc-switch

GitHub 国内一般可以访问（偶尔慢，多刷几次）。

macOS：

最简单的方式是用 Homebrew：

brew install --cask cc-switch

也可以从 Releases 页面下载 .dmg 文件，双击安装。

Windows：

从 Releases 页面下载 .msi 安装包，双击按向导安装。

当前最新版本是 v3.14.1（2026-04-23 发布）。

在 cc-switch 里添加 DeepSeek V4

安装完成后打开 cc-switch，主界面会展示当前已配置的提供商列表。

找到内置的 DeepSeek 预设（搜索“DeepSeek”即可），或者点击「Add Provider」→「DeepSeek V4」。

填入你在上一步获取的 API Key，保存。

如果你想手动配置（或者 cc-switch 里的预设有变化），以下是完整参数：

字段	值
Provider Name	DeepSeek V4
Base URL	https://api.deepseek.com/anthropic
API Key	你的 DeepSeek API Key
主力模型（Opus/Sonnet）	deepseek-v4-pro
轻量模型（Haiku/子任务）	deepseek-v4-flash

切换到 DeepSeek

配置保存后，你会在 cc-switch 的托盘菜单（系统托盘右键）看到「DeepSeek V4」出现在列表里。点击它，cc-switch 就会自动把以下环境变量写入配置：

ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
ANTHROPIC_AUTH_TOKEN=<你的DeepSeek API Key>
ANTHROPIC_MODEL=deepseek-v4-pro
ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash

这些环境变量的作用是告诉 Claude Code：“所有本来要发给 Anthropic 的请求，改发去 DeepSeek 的 API 地址，用我提供的 Key 认证。”

切换完成后，不需要重启 Claude Code（如果 Claude Code 当前没有在运行，直接启动即可）。

六、常见问题 FAQ

在群里帮读者解决这套流程的问题时，有几个高频问题值得单独说一下。

Q：npm 安装时报错 EACCES permission denied，怎么处理？

这是 npm 全局安装的权限问题，在 Mac 上偶尔出现。不要用 sudo npm install 解决（官方文档明确不推荐，会带来安全风险）。正确处理方式是修改 npm 全局目录的权限：

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'

然后把 ~/.npm-global/bin 加入你的 PATH（在 ~/.zshrc 或 ~/.bash_profile 末尾添加 export PATH=~/.npm-global/bin:$PATH），最后 source ~/.zshrc。

再重新运行安装命令就好了。

Q：Claude Code 能用，但跑起来之后提示“authentication failed”，怎么回事？

这说明 Claude Code 在尝试用 claude.ai 账号登录，而不是走 DeepSeek 路线。原因通常是 cc-switch 的配置没有生效——环境变量没有被 Claude Code 读到。

解决方法：确认 cc-switch 显示「DeepSeek V4 已激活」，然后重新打开一个终端窗口再运行 claude。cc-switch 修改的环境变量需要新终端会话才能生效。

Q：DeepSeek 的 API 和真正的 Claude 有多大差距？

对于日常使用（改文档、写周报、整理资料、查信息），基本感觉不到差别。DeepSeek V4 Pro 的中文理解和中文输出质量非常好，比早期版本有明显提升。

如果你是程序员，拿 DeepSeek V4 跑复杂的代码生成任务，某些场景下会发现它稍逊于 Claude Sonnet。但对非程序员用户来说，这个差距几乎不影响实际使用体验。

Q：以后 Claude Code 出了新版本，用 npm 还能更新吗？

可以。运行这条命令就行：

npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

建议每隔一两周跑一次更新，Claude Code 迭代很快，新版经常有很有用的功能。

七、验证 + 实际费用参考

验证是否真的在用 DeepSeek

切换到 DeepSeek 之后，打开终端，运行 claude，启动 Claude Code。

输入一个简单的问题，比如：

你是什么模型？

或者：

/model

如果 Claude Code 的回答里提到 DeepSeek，或者你在 platform.deepseek.com 的「API 调用记录」里看到了请求，就说明接入成功了。

实际费用怎么算

很多人不知道自己用 Claude Code 大概会花多少钱。这里给一个参考：

一次普通的对话（问一个问题 + 得到回答）大概消耗 1000-3000 token。

用 DeepSeek V4 Pro，每次对话费用大约是：

• 输入约 1000 token：$0.000435（约 ¥0.003）
• 输出约 2000 token：$0.00174（约 ¥0.013）
• 合计约 ¥0.016 / 次对话

就算你每天跟 Claude Code 聊 50 次，一个月下来也就 ¥24 左右。

正常上班族用 Claude Code 帮忙改文档、写周报、查资料，一个月实际消耗大概在 ¥5-20 之间。和 Claude Pro 的 $20/月（约 ¥145）相比，节省了 7-29 倍。

💡 实际上 DeepSeek V4 Pro 当前还在 75% 折扣期（到 2026-05-31），折扣期内费用更低。折扣结束后的正常价格大约是折扣价的 4 倍，但仍然比 Claude Pro 便宜很多。随时可以在 platform.deepseek.com 的「用量」页面看到实际消耗。

八、总结

今天这一讲，我们用四步绕开了国内安装 Claude Code 的两大拦路虎：

如果你只能记住三件事：

1. npm 是国内用户装 Claude Code 的唯一无翻墙路径——官方支持，加 --registry=https://registry.npmmirror.com 参数走国内镜像
2. DeepSeek V4 的 API 完全兼容 Claude Code 的调用格式——改几个环境变量，Claude Code 就能无缝切换到国内直连的 DeepSeek
3. cc-switch 让切换从“手动改配置文件”变成“点一下鼠标”——以后想试其他国产模型，30 秒就能接进来

马上可以做的一件事：打开 https://platform.deepseek.com，花 5 分钟注册账号、申请 API Key，先免费试用看看效果。

接下来，我会讲解「第一次上手——用 Claude Code 完成你的第一个真实任务」，那一讲会教你怎么跟 Claude Code 说话才高效，方法是通用的，不管背后是 Claude 还是 DeepSeek。

说到这，如果你在操作过程中遇到了什么奇怪的报错，或者想看看别人是怎么配置的，不妨到 云栈社区 里搜一搜、问一问。那里聚集了一大批热爱折腾各种开发工具的程序员，你的问题，很可能早就有人踩过坑了。

九、答疑解惑

题 1（动手题）：按照本讲的步骤，装好 Node.js 和 Claude Code 之后，运行 claude --version 和 node -v，把输出结果截图，发到评论区。如果遇到了问题，把报错信息也一起贴出来——你遇到的问题，可能也是其他读者正在面对的。

题 2（判断题）：DeepSeek 的 API 之所以能接入 Claude Code，是因为它提供了「Anthropic 兼容格式」的 API 接口（ANTHROPIC_BASE_URL 指向的那个地址）。你能想到这个设计的优势是什么？如果 OpenAI 也提供一个 Anthropic 兼容格式的 API 接口，你觉得能不能同样用 cc-switch 接入 Claude Code？

题 3（进阶挑战）：cc-switch 内置了 50+ 家提供商预设。除了 DeepSeek，你还能从列表里找到哪些你熟悉的国内模型？试着也配置一个进去，然后在 cc-switch 里来回切换，看两个模型对同一个问题的回答有什么不同。