Windows 环境下 Claude Code 安装与配置完全指南（含国产模型切换）

前言

在开始之前，请确保你的电脑已经准备好了以下两个基础工具：

1. Node.js：请从官方网站下载并安装。
2. Git：请从官方网站下载并安装。

第一步：安装 Claude Code

打开 PowerShell，请务必以管理员身份运行，然后执行以下命令进行全局安装：

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

安装过程会输出类似下面的信息，看到added 2 packages即表示成功：

########################## OUTPUT ############################### added 2 packages in 1m npm notice npm notice New minor version of npm available! 11.12.1 -> 11.14.1 npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.14.1 npm notice To update run: npm install -g npm@11.14.1 npm notice ########################## OUTPUT ###############################

安装完成后，验证一下版本：

claude--version

如果看到类似2.1.138 (Claude Code)的输出，说明安装成功。

第二步：初次使用与常见问题解决

首次运行claude命令时，你可能会遇到两个常见问题，别担心，这里提供了解决方案。

问题一：网络连接错误ERR_BAD_REQUEST

现象：输入claude后，终端报错Failed to connect to api.anthropic.com: ERR_BAD_REQUEST。

原因：Claude Code 在首次启动时会尝试连接 Anthropic 服务器进行初始化验证，这个过程可能因网络环境（如区域限制）而失败。

解决方案：跳过新手引导。

1. 找到并编辑配置文件%User%/.claude.json。
2. 在文件中添加以下配置项，告诉程序你已经完成了初始化：

{"hasCompletedOnboarding":true}

问题二：程序崩溃Segmentation fault

现象：终端输出类似下面的崩溃信息，并提示Bun has crashed。

panic(main thread): Segmentation fault at address 0x1AD35022E46 oh no: Bun has crashed.This indicates a bug in Bun,not your code....

原因：Claude Code 自带的 Bun 运行时版本为v1.3.14，该版本在 Windows 系统上，特别是支持avx2指令集的新款 CPU 上，存在已知的稳定性问题。

解决方案：降级 Bun 版本并配置环境变量。

1. 安装一个更稳定的 Bun 版本：

   npm install-g bun@1.2.20

2. 设置环境变量：告诉 Claude Code 使用你刚刚安装的系统 Bun，而不是它自带的版本。

   setx BUN_INSTALL"C:\Users\你的用户名\AppData\Roaming\npm\node_modules\bun"

   注意：请将你的用户名替换为你电脑上的实际用户名。

3. 重启终端：完成以上步骤后，务必关闭并重新打开你的 PowerShell 或终端窗口，使环境变量生效。

再次输入claude命令，如果能看到正常的启动界面，就说明问题已经解决了。

第三步：切换为国产大模型（以 MiniMax 为例）

由于网络限制，国内用户可能无法直接访问 Anthropic 的服务器。我们可以通过一个工具，让 Claude Code 调用国内的国产大模型。

1. 安装 ccSwitch 工具

请从 ccSwitch 的 GitHub Release 页面 下载最新版本的工具。

2. 配置 MiniMax 模型

根据 ccSwitch 工具的指引，填入你的 MiniMax API Key 等相关信息，完成配置。

3. 验证切换是否成功

启动 Claude Code，然后在对话中输入/model命令。如果看到返回的模型列表中包含了你配置的国产模型（如 MiniMax 的模型），就说明切换成功了！

第四步：在 VS Code 中集成 Claude Code

如果你习惯在 VS Code 中进行开发，可以安装插件来获得更流畅的体验。

1. 在 VS Code 的扩展商店中搜索并安装 Claude Code 相关插件。
   
2. 安装完成后，你可以在 VS Code 的侧边栏或命令面板中找到并启动它，效果如下图所示。
   

至此，你已经完成了从安装、排错到配置国产模型、集成 VS Code 的全部流程。希望这篇指南能帮助你顺利上手 Claude Code！