Claude Code 安装完整指南:搭载 DeepSeek,零门槛上手 AI 编程

本文是一篇面向零基础用户的 Claude Code 安装教程，详细讲解如何用国产大模型 DeepSeek 替代 Claude 官方 API，实现无需科学上网、无需国外账号、成本降低 98% 的 AI 编程体验。

不用科学上网，不用国外信用卡，不用怕账号被封——这篇教程帮你把 Claude Code 安排得明明白白。

一、先搞清楚我们要做什么

简单说三句话：

•Claude Code 是一个 AI 编程助手，在终端里输入自然语言，它就能帮你写代码、修 Bug、做审查。•但它原生对接 Claude 大模型，需要国外账号、科学上网、美元付费——对国内用户很不友好。•我们的方案：用 CC-Switch 这个开源工具，把底层模型一键切换成 DeepSeek 国产大模型。

最终效果：

Claude Code（前端交互）→ CC-Switch（模型路由）→ DeepSeek（国产大模型）

无需科学上网 · 无需国外账号 · 成本仅为 Claude 官方的 2%

二、动手前的准备

你需要准备	说明
一台 Windows 电脑	Win10 / Win11 均可，macOS 也能参考
正常网络	能打开百度就行，不需要科学上网
10 块钱	DeepSeek API 按量计费，10 块能用好几个月
30 分钟	跟着教程一步步来，半小时搞定

三、第一步：安装 Node.js（运行环境）

Claude Code 依赖 Node.js，先把它装上。

下载安装：

访问 Node.js 官网：https://nodejs.org/zh-cn/download^[1]

选择 LTS 版本（长期支持版，稳定可靠），下载后双击一路 Next 即可。

验证是否装好：

按 Win + R，输入 cmd 回车，在黑窗口里敲：

node -v

如果出现版本号（比如 v20.11.0），说明装好了。

四、第二步：安装 Git（版本控制）

Git 是 Claude Code 的必需组件——不装会直接报错，必须安排上。

下载安装：

官网 https://git-scm.com/downloads，下载^[2] Windows 版，一路 Next。

验证：

git --version

出现版本号即可。

⚠️ 如果后续运行 claude 报错找不到 Git，多半是没勾选「Add Git to PATH」——重装一下 Git，安装时注意勾上这个选项就行。

五、第三步：安装 Claude Code CLI

用 PowerShell（右键管理员运行）或 cmd，执行：

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

💡 装得慢？先切国内镜像源：
npm config set registry https://registry.npmmirror.com

装完之后还不能直接用——需要改一个配置文件，绕过 Claude 的登录引导。

找到这个文件（路径里把"你的用户名"换成自己的）：

C:\Users\你的用户名\.claude\claude.json

在里面加上一行：

{  "hasCompletedOnboarding": true}

如果文件里本来就有内容，注意 JSON 格式——在最后一个配置项后面加逗号，再把上面这行放进去。

保存后，在 cmd 里敲 claude 试试——能跑起来了，但会提示登录。

别慌，下一步就解决这个问题。

六、第四步：接入 DeepSeek（最关键的步骤）

这才是整篇教程的精华。我们需要两个东西：

1.CC-Switch：一个开源工具，负责"调包"Claude Code 底层的模型2.DeepSeek API Key：国产大模型的调用凭证

6.1 认识 CC-Switch

特性	说明
开源免费	代码在 GitHub，随便用
一键切换	支持 DeepSeek、通义千问等国产模型
图形界面	填 API Key 就行，不用写一行代码
持续更新	社区活跃，兼容最新版 Claude Code

6.2 下载 CC-Switch

打开 https://github.com/farion1231/cc-switch^[3]

在右侧 Releases 里下载最新 .exe 安装包，双击运行。

6.3 获取 DeepSeek API Key

打开 https://platform.deepseek.com^[4]

•手机号注册 → 登录•左侧菜单找到「API Keys」•点击「创建 API Key」，起个名字比如 claude-code•⚠️ 立刻复制生成的密钥（格式：sk-xxxxxxxx）——关掉页面就再也看不到了！

6.4 实名认证与充值

•按照平台指引完成实名认证•进入充值页面，首次充 10 块钱 就够了

6.5 价格对比（这才是重点）

	DeepSeek-V3	Claude Sonnet 4
输入	¥1 / 百万 tokens	$3 ≈ ¥21 / 百万 tokens
输出	¥2 / 百万 tokens	$15 ≈ ¥105 / 百万 tokens
1 块钱能用	约 50 万字对话	约 700 字对话
额外成本	无	科学上网 + 国外信用卡

6.6 在 CC-Switch 中配置

1.打开 CC-Switch2.点击「添加模型」→ 选择「DeepSeek」3.粘贴刚才复制的 API Key → 保存

重新打开 cmd，敲 claude——不再提示登录，直接进入对话界面！

🎉 恭喜！Claude Code 已成功对接 DeepSeek。

七、第五步：VS Code 集成

虽然命令行能用，但在 VS Code 里运行才是完全体——可视化、可编辑、效率翻倍。

安装 Claude Code 插件

1.VS Code 里按 Ctrl + Shift + X2.搜索「Claude Code」3.找到 Anthropic 官方插件 → Install

在终端中运行

按 Ctrl + ` 打开 VS Code 内置终端，输入 claude 即可。

八、安装常见问题速查

Q1：npm install 报错？ → 切国内镜像 npm config set registry https://registry.npmmirror.com，或用管理员身份运行 PowerShell。

Q2：提示找不到 claude 命令？ → 关掉 cmd 重开，确认 npm 全局安装路径在 PATH 里。

Q3：提示找不到 Git？ → 装一下 Git，重装时记得勾选「Add Git to PATH」。

Q4：CC-Switch 配完还是提示登录？ → 检查 API Key 有没有多余空格，确认 DeepSeek 已完成实名认证和充值，重启 CC-Switch 和 cmd。

Q5：DeepSeek API 返回错误？ → 查余额、查 API Key 是否有效、查实名认证状态。

Q6：VS Code 终端里 claude 跑不起来？ → 可能需要改一下 PowerShell 执行策略。