准备工作
Last updated on
想顺利用上 Claude Code，先把 API Key 和本地依赖准备好。先不用科学上网，确认这些基础条件后再继续。
先知道这一页要做什么
这一页只做两件事：
- 把电脑里 Claude Code 需要的基础依赖装好
- 准备好后面要用的 API Key
做完这两部分，你就可以继续下一页，不用先处理科学上网。
先装好本地运行依赖
安装node 下载官方msi文件，安装的时候 勾选Automatically install the necessary tools 顺便能把基础的python3 和其他基础项一起安装
Upgraded:
- chocolatey-compatibility.extension v1.0.0
- chocolatey-core.extension v1.4.0
- chocolatey-dotnetfx.extension v1.0.1
- chocolatey-visualstudio.extension v1.13.0
- chocolatey-windowsupdate.extension v1.0.5
- dotnetfx v4.8.0.20220524
- KB2919355 v1.0.20160915
- KB2919442 v1.0.20160915
- KB2999226 v1.0.20181019
- KB3033929 v1.0.5
- KB3035131 v1.0.3
- python v3.14.4
- python3 v3.14.4
- python314 v3.14.4
- vcredist140 v14.50.35719
- vcredist2015 v14.0.24215.20170201
- visualstudio2026buildtools v118.4.3
- visualstudio2026-workload-vctools v1.0.0
- visualstudio-installer v2.0.7 Type ENTER to exit: 全家桶安装完成。
claude.json 添加 免登录 "hasCompletedOnboarding": true
如果你是 Windows 用户，下面这些命令用什么终端运行？
对小白来说，最简单的是直接打开 Windows Terminal、PowerShell 或 CMD 命令提示符。
如果你不知道自己该用哪个，就优先用 Windows Terminal；如果电脑里没有它，用 PowerShell 或 CMD 也可以。
1. 安装 Node.js 和 npm
Claude Code 运行时要依赖 Node.js。
你可以直接去 Node.js 官网 下载。
对大多数小白用户，建议这样选：
- 优先选择 LTS 版本
- 不要优先选 Latest 或 Current
- 安装 Node.js 时，
npm会一起装好，不需要单独再装一次
下载完成后，双击安装包，一路按默认选项安装即可。
这一小步做完后，你应该得到什么？
你的电脑里应该已经装好了 Node.js 和 npm。
安装完成后，打开终端，运行下面两条命令：
node -v
npm -v如果终端里都能显示版本号，比如 v24.x.x、10.x.x 这样的结果，就说明 Node.js 和 npm 已经安装成功。
2. 安装 Git
Claude Code 经常会和 Git 一起使用，比如查看改动、理解仓库状态、生成提交建议。
你可以去 Git for Windows 官网 下载。
进入页面后，直接点击 Download 即可。网站会把你带到最新稳定版本的下载页。
对大多数 Windows 小白用户来说：
- 直接下载网站默认给你的最新版稳定安装包即可
- 安装时大多数选项保持默认就可以，不需要一开始就研究很多高级设置
下载完成后，双击安装包，继续按默认选项安装。
安装完成后，再打开终端运行：
git --version如果能看到版本号，比如 git version 2.x.x.windows.x，就说明 Git 已经可以用了。
3. 用一份清单确认依赖没有遗漏
继续往下之前，先检查下面 3 条是否都已经满足：
node -v能返回版本号npm -v能返回版本号git --version能返回版本号
如果这里有命令跑不通，不要急着继续后面的教程
先把缺的依赖补齐，再继续后面的接入步骤。
否则你后面很容易在安装 Claude Code 或切换链路时卡住，而且会分不清问题到底出在依赖、网络，还是配置。
再准备可用的 API Key
1. 注册或登录 api.dingjiai.com
这套教程面向中国用户，后面会通过 cc-switch 走更适合国内环境的接入路径。
所以在准备阶段，你先打开 api.dingjiai.com：
- 如果你还没有账号，就先注册
- 如果你已经有账号，直接登录即可
2. 先完成充值
Claude Code 后面调用模型时，需要通过 API Key 消耗额度。
所以登录后，先按页面提示完成充值，这一步不要跳过。
为什么这里要先充值？
因为后面创建出来的 API Key，不只是一个字符串，它背后还要绑定可用额度。
如果你先跳过这一步，后面就算配置好了，也可能因为没有余额而不能正常调用。
4. 把 API Key 保存好
创建完成后，先把 API Key 保存到一个你自己能稳定找到的位置，保证后面配置时可以随时复制使用。
同时注意这两点：
- 不要把 API Key 发给别人
- 不要把 API Key 直接提交到代码仓库里
把 API Key 当成密码来保管
谁拿到这串 Key，谁就可能用掉你的额度。
所以它不应该出现在聊天记录截图、公开仓库、教程示例代码，或者别人能直接看到的地方。
这一步先不用处理科学上网
你现在只需要确认两类东西已经齐了
- 电脑里已经装好 Node.js、npm 和 Git
- 手里已经有可用的 API Key
做到这里，准备阶段就完成了。
下一页继续看 CC Switch。