前言

在開始之前，請確保你的電腦已經(jīng)準備好了以下兩個基礎(chǔ)工具：

1. Node.js：請從官方網(wǎng)站下載并安裝。
2. Git：請從官方網(wǎng)站下載并安裝。

第一步：安裝 Claude Code

打開 PowerShell，請務(wù)必以管理員身份運行，然后執(zhí)行以下命令進行全局安裝：

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 命令時，你可能會遇到兩個常見問題，別擔(dān)心，這里提供了解決方案。

問題一：網(wǎng)絡(luò)連接錯誤ERR_BAD_REQUEST

現(xiàn)象：輸入 claude 后，終端報錯 Failed to connect to api.anthropic.com: ERR_BAD_REQUEST。

原因：Claude Code 在首次啟動時會嘗試連接 Anthropic 服務(wù)器進行初始化驗證，這個過程可能因網(wǎng)絡(luò)環(huán)境（如區(qū)域限制）而失敗。

解決方案：跳過新手引導(dǎo)。

1. 找到并編輯配置文件 %User%/.claude.json。
2. 在文件中添加以下配置項，告訴程序你已經(jīng)完成了初始化：

{
  "hasCompletedOnboarding": true
}

問題二：程序崩潰Segmentation fault

現(xiàn)象：終端輸出類似下面的崩潰信息，并提示 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 系統(tǒng)上，特別是支持 avx2 指令集的新款 CPU 上，存在已知的穩(wěn)定性問題。

解決方案：降級 Bun 版本并配置環(huán)境變量。

• 安裝一個更穩(wěn)定的 Bun 版本：

• npm install -g bun@1.2.20

• 設(shè)置環(huán)境變量：告訴 Claude Code 使用你剛剛安裝的系統(tǒng) Bun，而不是它自帶的版本。

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

• 注意：請將 你的用戶名 替換為你電腦上的實際用戶名。
• 重啟終端：完成以上步驟后，務(wù)必關(guān)閉并重新打開你的 PowerShell 或終端窗口，使環(huán)境變量生效。

再次輸入 claude 命令，如果能看到正常的啟動界面，就說明問題已經(jīng)解決了。

第三步：切換為國產(chǎn)大模型（以 MiniMax 為例）

由于網(wǎng)絡(luò)限制，國內(nèi)用戶可能無法直接訪問 Anthropic 的服務(wù)器。我們可以通過一個工具，讓 Claude Code 調(diào)用國內(nèi)的國產(chǎn)大模型。

1. 安裝 ccSwitch 工具

請從 ccSwitch 的 GitHub Release 頁面 下載最新版本的工具。

2. 配置 MiniMax 模型

根據(jù) ccSwitch 工具的指引，填入你的 MiniMax API Key 等相關(guān)信息，完成配置。

3. 驗證切換是否成功

啟動 Claude Code，然后在對話中輸入 /model 命令。如果看到返回的模型列表中包含了你配置的國產(chǎn)模型（如 MiniMax 的模型），就說明切換成功了！

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

如果你習(xí)慣在 VS Code 中進行開發(fā)，可以安裝插件來獲得更流暢的體驗。

在 VS Code 的擴展商店中搜索并安裝 Claude Code 相關(guān)插件。

安裝完成后，你可以在 VS Code 的側(cè)邊欄或命令面板中找到并啟動它，效果如下圖所示。

Agent Team模式

在 Claude Code 中開啟 Agent Teams（智能體團隊）模式，需要滿足一定的版本要求并手動啟用實驗性功能。你可以按照以下步驟進行操作：

1. 檢查版本要求
首先，確保你的 Claude Code 版本至少為 v2.1.32。你可以在終端中運行以下命令來檢查當(dāng)前版本：

claude --version

2. 修改配置文件開啟實驗功能
你需要編輯 Claude Code 的配置文件 settings.json，添加開啟 Agent Teams 的環(huán)境變量。

• 配置文件路徑：通常位于用戶目錄下的 ~/.claude/settings.json（也可以設(shè)置在項目根目錄的 .claude/settings.json 中）。
• 添加配置：在文件中加入以下代碼：

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

(如果你的 settings.json 中已有其他配置，請確保將 "env" 部分正確合并進去，不要直接覆蓋原有內(nèi)容)。

3. 重啟終端
保存配置文件后，重啟你的終端并重新進入項目啟動 Claude Code，Agent Teams 功能就會生效。

至此，你已經(jīng)完成了從安裝、排錯到配置國產(chǎn)模型、集成 VS Code、開啟Agent Team模式 的全部流程。希望這篇指南能幫助你順利上手 Claude Code！

下一篇（推薦方式）：在 WSL 中部署 Claude Code 并開啟 Agent Team 模式

到此這篇關(guān)于Windows 環(huán)境下 Claude Code 安裝與配置完全指南（含國產(chǎn)模型切換）的文章就介紹到這了,更多相關(guān) Claude Code 安裝與配置內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論