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

目录

• 前言
• 第一步：安装 Claude Code
• 第二步：初次使用与常见问题解决
• 问题一：网络连接错误ERR_BAD_REQUEST
• 问题二：程序崩溃Segmentation fault
• 第三步：切换为国产大模型（以 MiniMax 为例）
• 1. 安装 ccSwitch 工具
• 2. 配置 MiniMax 模型
• 3. 验证切换是否成功
• 第四步：在 VS Code 中集成 Claude Code
• Agent Team模式

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

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

打开 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 命令时，你可能会遇到两个常见问题，别担心，这里提供了解决方案。

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

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

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

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

{
  "hasCompletedOnboarding": true
}

现象：终端输出类似下面的崩溃信息，并提示 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 版本并配置环境变量。

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

• npm install -g bun@1.2.20

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

• setx BUN_INSTALL "C:Users你的用户名AppDataRoamingnpmnode_modulesbun"

• 注意：请将 你的用户名 替换为你电脑上的实际用户名。
• 重启终端：完成以上步骤后，务必关闭并重新打开你的 PowerShell 或终端窗口，使环境变量生效。

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

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

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

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

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

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

在 VS Code 的扩展商店中搜索并安装 Claude Code 相关插件。

安装完成后，你可以在 VS Code 的侧边栏或命令面板中找到并启动它，效果如下图所示。

在 Claude Code 中开启 Agent Teams（智能体团队）模式，需要满足一定的版本要求并手动启用实验性功能。你可以按照以下步骤进行操作：

1. 检查版本要求
首先，确保你的 Claude Code 版本至少为 v2.1.32。你可以在终端中运行以下命令来检查当前版本：

claude --version

2. 修改配置文件开启实验功能
你需要编辑 Claude Code 的配置文件 settings.json，添加开启 Agent Teams 的环境变量。

• 配置文件路径：通常位于用户目录下的 ~/.claude/settings.json（也可以设置在项目根目录的 .claude/settings.json 中）。
• 添加配置：在文件中加入以下代码：

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

(如果你的 settings.json 中已有其他配置，请确保将 "env" 部分正确合并进去，不要直接覆盖原有内容)。

3. 重启终端
保存配置文件后，重启你的终端并重新进入项目启动 Claude Code，Agent Teams 功能就会生效。

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

下一篇（推荐方式）：在 WSL 中部署 Claude Code 并开启 Agent Team 模式

到此这篇关于Windows 环境下 Claude Code 安装与配置完全指南（含国产模型切换）的文章就介绍到这了,更多相关 Claude Code 安装与配置内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！