Node.js安装、Claude Code 与 大模型AI 配置（CMD命令窗口）

一、环境准备：Node.js 下载与安装

Claude Code 依赖 Node.js 环境，需确保版本在 v18 或以上。

1. 下载安装包

Node.js 官网下载链接：https://nodejs.cn/en/download

• Windows 系统推荐下载Windows 安装程序(.msi)（x64 架构），安装包内置 npm 包管理工具。

2. 📋安装程序步骤

1. 安装包下载完成后，双击.msi安装文件，启动安装向导；

2. 在欢迎界面，点击Next进入下一步；

3. 勾选「我同意协议中的条款」，点击Next；

4. 选择 Node.js 安装路径（可自定义任意磁盘路径，示例为F:\nodejs\）， 确认后点击Next；

5. 自定义安装组件页面，保持默认配置，直接点击Next；

6. 原生模块工具配置页面，无需额外勾选，继续点击Next；

7. 准备安装页面，点击Install开始执行安装。

8. 安装完成后，点击Finish退出安装向导。

3. 🔧验证安装

1. 使用快捷键Win+R打开运行窗口，输入cmd，回车打开 CMD 命令提示符窗口；

2. 在 CMD 窗口依次输入以下命令输入以下命令，按回车执行：

node -v // 检查 Node.js 版本 npm -v // 检查 npm 版本

• 若安装成功，会显示对应的版本号信息。
• 若未显示版本号，说明安装失败，需要检查环境变量配置：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，在系统变量的「Path」中添加 Node.js 的安装路径和其下的npm路径。

4. 修改 npm 全局路径（可选）

此步骤可修改 npm 全局模块与缓存的默认保存路径，避免占用系统盘空间，可根据需求选择是否修改，无需修改可跳过。

1. 先查看当前 npm 全局安装路径和缓存路径：

npm get prefix //查看当前 npm 全局安装路径 npm get cache //查看当前 npm 缓存路径

执行后可查看默认路径，通常为C:\Users\ 用户名 \AppData\Roaming\npm与C:\Users\ 用户名 \AppData\Local\npm-cache。

2.在自定义路径下（示例为：F:\nodejs\），新建两个文件夹，分别命名为node_global和node_cache；

3. 执行命令修改 npm 全局配置，将路径替换为新建的文件夹路径。

npm config set prefix "F:\nodejs\node_global" //修改npm全局下载路径 npm config set cache "F:\nodejs\node_cache" //修改npm缓存路径

5. 路径修改有效性测试

在 CMD 窗口执行以下命令，全局安装 express 模块，测试路径是否修改成功：

npm install express -g

如果安装成功，命令行输出安装完成提示，且在node_global文件夹下会生成node_modules文件夹，内部包含express文件夹，说明路径修改生效；

安装失败常见原因：

(1) 权限不足报错（错误码 EPERM）： 右键点击 nodejs 根文件夹 → 选择「属性」→ 切换到「安全」选项卡 → 点击「编辑」，给当前用户授予「完全控制」等所有权限，确认后重试；

(2) npm 版本过低提示：按照命令行提示，执行升级命令npm install -g npm@版本号，升级完成后重试。

6. ⚙️添加系统环境变量

1. 右键点击桌面「此电脑」，选择「属性」→ 点击「高级系统设置」→ 在弹出的「系统属性」窗口中，点击右下角「环境变量」；

2. 在「系统变量」区域，找到名为Path的变量，双击打开编辑界面；

3. 点击「新建」，粘贴之前配置的node_global文件夹完整路径（示例：F:\nodejs\node_global），同时补充 Node.js 根目录路径（示例：F:\nodejs\）；

4. 依次点击所有窗口的「确定」，保存环境变量配置。

二、🔑大模型 API Key 获取

这里以GLM-4.7-Flash（智谱 AI）为例：

1. 进入智谱大模型官网（https://www.bigmodel.cn/），登录账户后，进入左上角的API-Key 管理页面；

2. 点击页面左上角的「添加新的 API-key」，自定义 API 名称，点击「确定」完成创建；

3. 创建成功后，复制生成的 API-Key，妥善保存，后续配置会使用。

⚡注意：API Key 是访问大模型的密钥，请勿泄露给他人。

三 、Claude Code 安装

1. 📋安装步骤

1. 使用快捷键Win+R打开运行窗口，输入cmd，回车打开 CMD 命令提示符窗口；

2. 在 CMD 窗口输入以下命令，按回车执行。

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

2. 🔧验证安装

1. 在 CMD 窗口输入以下命令，按回车执行，若成功输出版本号（示例：2.1.71（Claude Code）），说明安装成功。

claude --version

🚑：安装成功后，还需下方步骤四配置 Claude Code 环境变量，先不要直接使用claude命令启动(可能由于网络或地区限制无法使用)。

四、🔥核心配置（关键）

1. 跳过新手引导

Claude Code 首次启动会请求连接官方服务器完成新手引导校验，国内网络环境易出现连接失败，可通过修改配置文件跳过该步骤：

1. 打开路径C:\Users\ 用户名，找到.claude.json文件，右键选择用记事本打开：

2. 在文件倒数第二行的末尾添加一个英文逗号,；

3. 换行新增一行，输入以下配置语句：

"hasCompletedOnboarding": true

4. 保存文件并关闭。

2. ⚙️配置模型映射与环境变量

1. 创建.claude文件夹：

👉动作：进入路径C:\Users\你的用户名，右键新建文件夹，若无法直接创建以点开头的文件夹，可新建名为.claude.的文件夹，系统会自动去除末尾的点，生成.claude文件夹。

2. 创建并配置settings.json文件：

（1）在.claude文件夹中，右键新建文本文档，将文件名修改为settings.json（需确保电脑已开启「显示文件扩展名」，避免生成settings.json.txt无效文件；开启方法：打开文件资源管理器，点击「查看」选项卡，勾选「文件扩展名」）。

（2）使用记事本打开settings.json文件，输入以下配置代码，务必将your_zhipu_api_key，替换为你自己复制的大模型 API Key。

智谱：

{ "env": { "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key", "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "GLM-4-Flash", "ANTHROPIC_DEFAULT_OPUS_MODEL": "GLM-4-Flash", "ANTHROPIC_DEFAULT_SONNET_MODEL": "GLM-4-Flash", "ANTHROPIC_MODEL": "GLM-4-Flash", "API_TIMEOUT_MS": "3000000", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" } }

配置项说明：

• ANTHROPIC_DEFAULT_*_MODEL：模型映射配置，将 Claude 原生模型替换为对应的 自定义 大模型；
• ANTHROPIC_AUTH_TOKEN：大模型接口鉴权密钥，填写你自己申请的 API Key；
• ANTHROPIC_BASE_URL：大模型兼容接口的访问地址，适配国内大模型服务；
• API_TIMEOUT_MS：接口请求超时时间，避免网络波动导致请求中断，600000 是 10 分钟；
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC：关闭非必要网络请求，适配国内网络环境。

五、Claude Code 启动与使用

1. 在 CMD 窗口中输入claude启动程序，首次启动选择信任此文件夹 (Trust This Folder)，以允许 Claude Code 访问该文件夹中的文件；

2. 进入交互页面，输入/model命令并回车，即可查看或切换已配置的大模型；

3. 输入/status确认模型、Base URL、API Key 是否配置正确；

4. 直接输入指令，即可与大模型进行交互，完成代码编写、调试、项目分析等操作。

六、cc-Switch 一键切换大模型工具

如果你使用过 Claude Code，一定遇到过这样的困扰：切换大模型配置过程繁琐，需要手动修改配置文件。

1. 🎯 工具介绍

cc-switch是一个完全免费、开源的 Claude Code 模型切换工具。

核心特性：

• ✅ 图形化界面，操作简单
• ✅ 支持 GLM、Qwen、DeepSeek 等主流国产大模型
• ✅ 一键切换，无需手动修改配置
• ✅ 预设配置模板，只需填入 API Key
• ✅ 切换速度快，不到 10 秒完成

GitHub 地址：https://github.com/farion1231/cc-switch

2. 📋 安装 cc-switch

1. 打开 GitHub Releases 页面：https://github.com/farion1231/cc-switch/releases

2. 根据系统选择安装包：

Windows 用户：下载.msi安装包

3. 选择 cc Switch 安装路径（可自定义任意磁盘路径，示例为F:\CC Switch\）， 确认后点击Next；

4. 安装完成后，桌面会出现 cc-switch 图标。

2.1. 获取 API Key

在大模型官网创建 API-Key，并复制。

2.2. 在 cc-switch 中配置大模型

1. 打开 cc switch 应用，点击左上角的 ➕ 号按钮，添加新的供应商。

这里以 GLM（ 智谱 AI）为例：

• 供应商名称：Zhipu GLM（可自定义）
• 官网链接：https://open.bigmodel.cn（选填）
• API Key：填入你在官网控制台获取的令牌
• API 请求地址：https://open.bigmodel.cn/api/anthropic
• 模型名称：例如GLM-4-Flash

向下滚动，可以看到 JSON 配置。点击添加按钮完成配置。

3. ✨使用体验

1. 在 cc-switch 主界面，找到Zhipu GLM这一行
2. 点击该行右侧的启动按钮
3. 打开终端，输入claude启动 Claude Code
4. 测试一下：输入你是什么模型？
5. 回复：我是 GLM-4-Flash✅ 切换成功！

七、Claude Code 卸载与重装

若 CMD 窗口可正常查询 Claude Code 版本号，但运行时出现异常。建议按以下步骤完整卸载后重装：

1. 执行卸载命令，移除全局安装的 Claude Code：

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

2. 清理残存文件：

查看 npm 全局包目录：

npm root -g //查看 npm 全局包目录

根据返回的路径打开文件夹，删除名为@anthropic-ai的文件夹。

3. 进入C:\Users\你的用户名目录，删除.claude文件夹（若未找到该文件夹，说明 Claude Code 未被使用过，可跳过此步骤）。

清理 npm 缓存：

npm cache clean --force

4. 重新安装并验证：