“你将学到用 npm 淘宝镜像在国内直接安装 Claude CodeMac 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 跑起来。路线很清晰四步国内无翻墙安装路径4步全流程装 Node.js从国内镜像站下载用 npm 淘宝镜像装 Claude Code绕过 claude.ai 的封锁申请 DeepSeek API Key国内直连支付宝/微信充值按量计费用 cc-switch 配置切换图形界面30 秒接入 DeepSeek V4对比标准安装路径和国内路径的区别标准安装路径 vs 国内路径对比两条路走到最后你用的是同一个 Claude Code 程序只是背后调用的 AI 模型从 Anthropic 的服务器变成了 DeepSeek 的服务器。使用体验几乎一样费用差了十几倍。好我们开始。二、第一步装好 Node.jsClaude 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 -vWindows 用户按 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 CodeNode.js 装好之后就可以用 npm 来安装 Claude Code 了。npm 是 Node.js 自带的包管理工具默认从 npmjs.com 下载软件包。好消息是npmjs.com 在国内可以直连但网速有时候不稳定。更稳妥的做法是加上淘宝提供的 npm 镜像npmmirror.com让下载走国内服务器。Mac 安装命令打开终端复制以下命令粘贴后回车npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.comWindows 安装命令打开命令提示符CMD或 PowerShell输入npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com两条命令完全一样--registry参数指定了使用淘宝的国内镜像源。安装过程大约需要 1-3 分钟你会看到进度条滚动。正常完成后输出类似added 1 package in Xs安装完成后验证 Claude Code 是否装好claude --version能看到版本号就成功了。image-20260512212344951关于npm 方式是否还被支持的说明你可能在某些文章里看到说 npm 安装方式已经过时了。我专门查了 Claude Code 官方文档截至 2026-05-12npm 安装仍然被列在官方支持的安装方式里位于「Advanced installation options」章节。官方推荐用curl命令安装是因为更方便、自动更新。但那个curl命令国内打不开所以 npm 这条路是国内用户目前唯一不需要翻墙的安装路径而且是官方支持的。“版本提醒安装时的--registry参数只影响这一次的下载来源不会永久改变你的 npm 配置。后续升级 Claude Code 时重新带上这个参数就行npm install -g anthropic-ai/claude-codelatest --registryhttps://registry.npmmirror.com四、第三步申请 DeepSeek API KeyClaude Code 装好了但现在还不能直接用——因为用 claude.ai 账号登录需要翻墙而且还要 Claude Pro 订阅。我们换一条路用DeepSeek V4替代 Claude 原生模型。DeepSeek 是国内深圳深度求索公司的开源大模型最新的 V4 版本在 2026 年 4 月底发布性能已经和 Claude Sonnet 相当。更重要的是API 国内直连支付宝/微信充值按实际用量计费。成本对比Claude Pro $20/月 vs DeepSeek V4 按量计费成本对比DeepSeek V4 Pro 当前定价截至 2026-05-12输入百万享1.74/百万折扣有效期至 2026-05-31输出百万3.48/百万人民币定价参考约 ¥1/百万 token 输入Claude Pro $20/月是固定费用不管你用多少。DeepSeek 是按量付费如果你只是每天用一两个小时实际花费可能每月不到 ¥20。“ 如果你加上[1m]后缀如deepseek-v4-pro[1m]模型会启用完整的 100 万 token 上下文窗口不加则默认 20 万 token。日常用 20 万就够了。注册并获取 API Key打开https://platform.deepseek.com国内直连不需要翻墙注册账号支持手机号注册登录后点击左侧菜单的「API Keys」点击「创建 API Key」给它起个名字比如「claude-code」点击确认复制生成的 Key妥善保存这个 Key 只显示一次image-20260512212621282新用户注册通常有一定的免费额度可以先用免费额度试用感觉好再充值。充值支持微信、支付宝最低充 ¥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-switchcc-switch 的 GitHub 仓库https://github.com/farion1231/cc-switchGitHub 国内一般可以访问偶尔慢多刷几次。macOS最简单的方式是用 Homebrewbrew install --cask cc-switch也可以从 Releases 页面下载.dmg文件双击安装。Windows从 Releases 页面下载.msi安装包双击按向导安装。image-20260512212853017当前最新版本是v3.14.12026-04-23 发布。在 cc-switch 里添加 DeepSeek V4安装完成后打开 cc-switch主界面会展示当前已配置的提供商列表。image-20260512213033202找到内置的 DeepSeek 预设搜索DeepSeek即可或者点击「Add Provider」→「DeepSeek V4」。填入你在上一步获取的 API Key保存。image-20260512213125959image-20260512213205834image-20260512213226692如果你想手动配置或者 cc-switch 里的预设有变化以下是完整参数字段值Provider NameDeepSeek V4Base URLhttps://api.deepseek.com/anthropicAPI Key你的 DeepSeek API Key主力模型Opus/Sonnetdeepseek-v4-pro轻量模型Haiku/子任务deepseek-v4-flash切换到 DeepSeek配置保存后你会在 cc-switch 的托盘菜单系统托盘右键看到「DeepSeek V4」出现在列表里。点击它cc-switch 就会自动把以下环境变量写入配置ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic ANTHROPIC_AUTH_TOKEN你的DeepSeek API Key ANTHROPIC_MODELdeepseek-v4-pro ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash这些环境变量的作用是告诉 Claude Code「所有本来要发给 Anthropic 的请求改发去 DeepSeek 的 API 地址用我提供的 Key 认证。」切换完成后不需要重启 Claude Code如果 Claude Code 当前没有在运行直接启动即可。六、常见问题 FAQ在群里帮读者解决这套流程的问题时有几个高频问题值得单独说一下。Qnpm 安装时报错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。再重新运行安装命令就好了。QClaude Code 能用但跑起来之后提示authentication failed怎么回事这说明 Claude Code 在尝试用 claude.ai 账号登录而不是走 DeepSeek 路线。原因通常是 cc-switch 的配置没有生效——环境变量没有被 Claude Code 读到。解决方法确认 cc-switch 显示「DeepSeek V4 已激活」然后重新打开一个终端窗口再运行claude。cc-switch 修改的环境变量需要新终端会话才能生效。QDeepSeek 的 API 和真正的 Claude 有多大差距对于日常使用改文档、写周报、整理资料、查信息基本感觉不到差别。DeepSeek V4 Pro 的中文理解和中文输出质量非常好比早期版本有明显提升。如果你是程序员拿 DeepSeek V4 跑复杂的代码生成任务某些场景下会发现它稍逊于 Claude Sonnet。但对非程序员用户来说这个差距几乎不影响实际使用体验。Q以后 Claude Code 出了新版本用 npm 还能更新吗可以。运行这条命令就行npm install -g anthropic-ai/claude-codelatest --registryhttps://registry.npmmirror.com建议每隔一两周跑一次更新Claude Code 迭代很快新版经常有很有用的功能。七、验证 实际费用参考验证是否真的在用 DeepSeek切换到 DeepSeek 之后打开终端运行claude启动 Claude Code。输入一个简单的问题比如你是什么模型或者/modelimage-20260512213603426如果 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 的两大拦路虎如果你只能记住三件事npm 是国内用户装 Claude Code 的唯一无翻墙路径——官方支持加--registryhttps://registry.npmmirror.com参数走国内镜像DeepSeek V4 的 API 完全兼容 Claude Code 的调用格式——改几个环境变量Claude Code 就能无缝切换到国内直连的 DeepSeek**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你还能从列表里找到哪些你熟悉的国内模型通义千问、豆包、Kimi 等试着也配置一个进去然后在 cc-switch 里来回切换看两个模型对同一个问题的回答有什么不同。往期推荐185000 星的 Superpowers 插件90% 的人只用了它 10% 的功能腾讯云架构师同盟专家用 Claude Code 跑通工作流后整理成了系列专栏Spring Boot 4.1发布这项特性超强但大多数升级教程都没提这个不兼容变更