Claude Code保姆级安装教程：接入国产模型全流程

Claude Code被不少开发者称为当前最强的智能体工具之一，它的能力远不止写代码。这篇教程整理自B站UP主的实操分享，覆盖了从环境准备、安装、绕过登录验证到接入国产大模型的完整流程，尤其针对国内用户无法直接使用Claude Code的痛点给出了可行方案。

Claude Code能做什么

很多人对Claude Code的第一印象是「写代码的工具」，但它的适用范围要宽得多。除了编程，它在写PPT、写文案、生成图像等场景同样表现出色，本质上可以协助完成你在电脑上进行的绝大多数任务。UP主提到，一些爆火的AI应用背后的核心推力引擎，很可能也是这类智能体在支撑。

从定位上看，Claude Code是一个命令行驱动的AI Agent（智能体），而非传统意义上的代码补全插件。这意味着它能理解上下文、拆解任务、自主执行多步操作，这也是它被反复强调「最强」的原因所在。

AI Agent（智能体）与普通AI聊天工具的核心区别在于「自主行动能力」。传统的大模型对话工具只能输出文本，用户需要手动将建议转化为操作；而Agent能够直接调用工具、读写文件、执行终端命令、甚至控制浏览器。Claude Code作为命令行Agent，拥有对本地文件系统的直接访问权限，能在一次对话中完成「分析需求→拆解任务→写代码→运行测试→修复错误」的完整闭环，而无需人工介入每一步。这种「感知-规划-执行」的循环正是它被归类为智能体而非单纯编码助手的原因。

环境准备与安装步骤

安装Claude Code的第一步是配置Node.js运行环境。下载官方安装程序后，按照默认选项一路「下一步」完成安装即可，过程没有特殊配置要求。

装好Node.js后，通过一条命令行指令安装Claude Code。安装完成后，输入版本查询命令，如果终端正确返回版本号，就说明安装成功。

首次运行claude命令进入程序时，系统可能会提示需要额外安装一个依赖组件（Git等环境依赖）。选择对应的Windows版本下载安装包，双击安装后重新回到命令行，再次输入claude就能顺利进入。

绕过登录验证

进入Claude Code后会要求登录官方账号，这是国内用户遇到的第一个门槛。教程给出的方案是修改配置文件：进入用户目录找到claude.json文件，在其中增加一个配置参数（注意用英文逗号分隔并正确保存）。保存后重新运行claude命令，就能跳过官方登录验证直接进入界面。

Claude Code在启动时会读取用户目录下的claude.json配置文件来决定认证方式。官方流程要求通过Anthropic账号登录，但该账号在中国大陆无法正常注册或使用。通过在配置文件中添加特定参数（通常是将认证模式设置为跳过官方验证，或指定自定义API端点），程序会绕过对Anthropic服务器的登录请求，转而使用本地配置的模型接口。这本质上是利用了Claude Code支持自定义API Base URL的扩展能力，让它能够对接任何兼容OpenAI接口规范的第三方大模型服务。修改配置文件时务必注意JSON格式的合法性，多余或缺少的逗号、引号都会导致程序无法读取配置而报错。

接入国产大模型

绕过登录后，还需要为Claude Code配置可用的模型。由于官方账号在国内受限，接入国产模型是更现实的选择。教程提到两种配置方式：一是直接手动修改Claude Code的配置文件，二是借助CCSwitch这款工具实现自动化配置。此外，如果你有Google Pro账号，也可以把谷歌的Gemini系列模型反接到Claude Code中使用。

使用CCSwitch配置DeepSeek

对新手来说，CCSwitch是更省心的路径。下载对应版本（教程演示为v3.10.3 Windows版）并安装后，在软件内点击「添加供应商」，选择DeepSeek^广告。整个配置过程只需要填入一个API Key。

获取API Key的流程也很直接：前往DeepSeek官网的API开放平台，进入「API Keys」页面创建一个新的Key，命名后确定生成。

复制生成的Key，粘贴回CCSwitch对应输入框，点击添加即可启用模型。之后重新进入claude，通过/model命令切换模型，就能在列表中看到DeepSeek V3.2选项。选中后，Claude Code便成功接入了国产大模型，界面也不再提示登录。

Superpowers插件：让AI写出可靠代码

装好Claude Code后，教程强烈建议再安装Superpowers插件。它解决的是普通AI编程的一个典型痛点：为了追求速度，AI拿到需求就直接开写，结果逻辑漏洞频出，甚至陷入「改一个bug引入三个新bug」的恶性循环。

Superpowers通过测试驱动开发（TDD）来保证代码质量，其工作流程分为三步：

• 主动澄清需求：当你提出需求时，AI会先反向提问，理清细节、探索边缘情况，并生成设计文档；
• 任务拆解：把大任务拆分成一个个2到5分钟就能完成的小任务，确保执行过程不偏航；
• 先测试后实现：先写会报错的测试用例，再编写通过测试的代码，从而保证每一行代码都是可工作的。

这种流程把「快速交付」变成了「稳健交付」，对于追求代码可靠性的开发者尤其有价值。

测试驱动开发（TDD，Test-Driven Development）是软件工程中的一种经典实践，其核心规则是「红-绿-重构」循环：先写一个必然失败的测试（红灯），再写最少量的代码让测试通过（绿灯），最后在不破坏测试的前提下优化代码结构（重构）。这种方式的优势在于，测试用例本身就是对需求的精确表达，每一步实现都有明确的验收标准，从根本上杜绝了「写完才发现理解错需求」的问题。将TDD引入AI编程后，AI不再凭直觉一次性生成大段代码，而是被约束在可验证的小步骤中前进，每次提交的代码都有测试背书，这正是Superpowers插件试图解决的「AI代码可靠性」问题的底层逻辑。

小结

整套流程可以概括为：安装Node.js环境 → 安装Claude Code → 修改配置绕过登录 → 用CCSwitch接入DeepSeek等国产模型 → 安装Superpowers提升代码质量。对国内用户而言，最核心的两个障碍——官方登录限制和模型可用性——都通过配置文件修改和第三方工具得到了解决。

需要提醒的是，绕过官方登录验证和接入第三方模型属于非官方用法，实际使用中请注意合规与账号安全。如果条件允许，官方账号仍是最稳定的选择。