Claude Code 保姆级入门教程：环境搭建与国产模型对接全攻略

很多人第一次用 AI 编程助手时都有类似体验：开始特别爽，但只要项目逻辑稍微复杂，对话就开始「鬼打墙」——它能写出七八个功能重复的文件，修一个 bug 却引入三个新 bug。不少人因此觉得 AI 编程就是个玩具。但问题可能不在 AI 本身，而在于我们使用的工具和方法。

本文根据一位 B 站 UP 主的实操教程整理，聚焦 Claude Code 从零开始的环境搭建、安装配置，以及国内用户绕不开的「国产模型对接」问题，帮你迈过第一道门槛。

为什么选择 Claude Code

Claude Code 是一款基于命令行的 AI 编程工具，本质上是一个用 JavaScript 编写的软件包。相比在普通聊天窗口里反复复制粘贴代码，它能直接操作本地文件、创建目录、执行任务，更适合处理有一定复杂度的工程项目。

对于经历过「AI 写代码越写越乱」阶段的开发者来说，工具链的规范化往往比单纯换模型更能解决问题。这也是这份教程强调「先把环境和配置做对」的原因。

搭建运行环境：Node.js 与 Git Bash

运行 Claude Code 之前，需要先准备两个基础软件。

Node.js：JavaScript 的运行环境

由于 Claude Code 使用 JavaScript 编写，运行它必须先安装 Node.js。到 Node.js 官网下载安装包，双击后一路点击「next」即可完成傻瓜式安装。

我们先装这个Node.js

安装完成后需要验证是否成功：打开命令行，输入 node 回车，如果能看到版本信息，说明安装无误。按 Ctrl + C 即可退出。

需要提醒的是，Node.js 官方服务器部署在美国，国内下载速度可能较慢，建议有加速工具的用户使用，或寻找可靠的国内镜像。

Node.js 是一个让 JavaScript 能在浏览器之外独立运行的开源运行时环境，底层基于 Google V8 引擎。在它出现之前，JavaScript 只能在浏览器内执行，无法直接访问文件系统或网络套接字。Node.js 打破了这一限制，让开发者可以用 JavaScript 编写命令行工具、服务器程序等桌面级应用。Claude Code 正是利用这一能力，在本地以命令行形式运行并直接读写项目文件。npm（Node Package Manager）随 Node.js 一同安装，是目前全球最大的软件包仓库，托管了超过 200 万个开源包，npm install -g 中的 -g 标志表示全局安装，安装后可在系统任意目录调用该工具。

Git Bash：版本控制与 Linux 指令支持

第二个软件 Git Bash 有两个作用：一是提供 Git 版本控制能力；二是让你能用 Linux 指令操作 Windows 系统。Claude Code 对 Linux 风格的指令更「熟悉」，因此 Git Bash 是一个重要的兼容层。

然后我们再来看这个右上角

到 Git 官网的 Windows 下载页，选择第一个 Intel 平台版本下载安装。安装同样是点击「下一步」即可。验证方法：在命令行输入 git，若出现大量帮助信息，说明安装成功。

Git Bash 是 Git for Windows 安装包内附带的一个终端模拟器，它将 MinGW（Minimalist GNU for Windows）工具链打包进来，使 Windows 用户无需安装完整的 Linux 子系统，就能使用 ls、cp、grep 等 Unix/Linux 常用命令。大量开发工具（包括 Claude Code）在设计时默认运行于 Linux/macOS 环境，其内部路径处理、脚本调用均遵循 POSIX 风格，在原生 Windows 命令提示符（CMD）或 PowerShell 中直接运行可能遇到路径格式不兼容、命令缺失等问题。Git Bash 作为兼容层可有效规避这些摩擦。与 Windows 10/11 内置的 WSL（Windows Subsystem for Linux）相比，Git Bash 更轻量、安装更快，对初学者而言是更低门槛的选择。

安装 Claude Code

两个基础软件就绪后，就可以安装 Claude Code 本体了。它作为一个 JavaScript 包，通过 npm 安装最为方便。npm 是 JavaScript 的包管理工具，可以极大简化安装流程。

在命令行中执行官方提供的 npm 安装指令（形如 npm install -g @anthropic-ai/claude-code），回车等待安装完成。安装后输入 claude 相关指令即可查看版本信息，确认安装成功。

对接国产模型：绕开访问限制的关键一步

这是国内用户最容易卡住的环节。Claude Code 默认接入的是官方 Claude 模型，但该服务已屏蔽中国大陆 IP，普通用户无法直接使用。即便通过「魔法」注册账户，也存在账号被封的风险，稳妥性不足。

更实际的方案是对接国产大模型。本教程以 DeepSeek^广告为例（原视频中口播为「tipsig」，实为 DeepSeek），演示如何替换默认模型。

第一步：获取 API Key

首先我们得到这个我们这里面使用DeepSeek

特别注意：API Key 只在创建时显示一次，必须立即复制保存。一旦关闭窗口，就无法再次查看，只能重新创建。

第二步：配置三个环境变量

对接模型的核心是配置三个环境变量：

API 地址：DeepSeek 的服务端点 URL
Token：即上一步获取的 API Key
模型名称：指定要使用的具体模型

打开 Windows 的「环境变量」设置界面，点击「新建」，在弹出窗口中分别填写变量名和变量值，三个变量依次配置完成后点击「确定」保存。

好那么这个呢作为变量的值哈

配置完成后，Claude Code 就会使用国产模型进行推理，彻底解决无法访问的问题。

环境变量是操作系统级别的键值对配置，程序启动时可以读取这些值来改变自身行为，而无需修改程序源码。Claude Code 通过读取特定名称的环境变量来决定将请求发往哪个 API 端点、携带哪个密钥、调用哪个模型。在 Windows 中，可通过「系统属性 → 高级 → 环境变量」界面进行图形化配置；配置后需要重新打开终端窗口才能使新变量生效，因为终端在启动时只读取一次环境变量。对于 DeepSeek，三个变量通常对应的是：ANTHROPIC_BASE_URL（指向 DeepSeek 的 OpenAI 兼容端点，如 https://api.deepseek.com）、ANTHROPIC_API_KEY（填写 DeepSeek API Key）以及 CLAUDE_MODEL 或类似变量（填写模型名称如 deepseek-chat）。具体变量名称以 Claude Code 官方文档或视频教程为准。

实测：让 AI 生成一个待办软件

配置完成后即可上手。教程中的演示是让 Claude Code「用 HTML 做一个待办事项软件」。回车后，它开始思考并将代码写入剪贴板对应的目录，过程中会询问是否创建文件，选择「yes」确认即可。

生成完成后打开成品，可以正常添加待办事项、标记完成状态、区分进行中与已完成的任务。对于一个简单需求来说，完成度相当不错，说明整套环境已经跑通。

小结

这份教程最大的价值在于把国内用户最容易踩的坑说清楚了：Claude Code 本身安装并不难，难的是官方模型的访问限制。通过 Node.js + Git Bash 搭建环境、npm 安装本体、再配置三个环境变量对接国产模型，普通人也能在本地跑起一套可用的 AI 编程工作流。

掌握配置只是起点，真正让效率翻倍的核心技巧——如何管理上下文、拆解复杂任务、避免「越改越乱」——才是后续值得深入研究的方向。