簡介

由于 Windows 原生終端并不支持 tmux，為了獲得完整且穩(wěn)定的多智能體分屏體驗，我們需要借助 WSL（Windows Subsystem for Linux）來安裝和使用 tmux。

本文將指導你如何在 Windows Subsystem for Linux (WSL) 環(huán)境中完成 Claude Code 的完整部署，并利用 tmux 開啟強大的 Agent Team 模式，實現(xiàn)多智能體協(xié)同開發(fā)。我們將涵蓋從環(huán)境安裝、配置到高級模式啟用的全過程。

第一部分：WSL 環(huán)境準備與配置

首先，我們需要在 Windows 系統(tǒng)上搭建 WSL 環(huán)境。如果你尚未安裝 WSL，請以管理員身份打開 PowerShell 或 Windows Terminal 并執(zhí)行以下命令：

wsl --install

該命令會自動啟用所需功能并安裝默認的 Linux 發(fā)行版。如果你想指定安裝特定發(fā)行版（如 Ubuntu），可以使用：

wsl --install -d Ubuntu

安裝完成后，可以通過以下命令查看已安裝的發(fā)行版及其狀態(tài)：

wsl -l -v

數(shù)據(jù)備份與遷移（可選）
為了防止數(shù)據(jù)丟失或便于遷移，我們可以將 WSL 實例導出為 tar 文件。例如，將 Ubuntu 實例導出到 E 盤：

wsl --export Ubuntu E:\wsl\wsl-ubuntu26.04.tar

若需重新導入（例如在新電腦上），先注銷舊實例（如果存在）：

wsl --unregister Ubuntu

然后從 tar 文件導入：

wsl --import Ubuntu E:\wsl\wsl-ubuntu26.04 E:\wsl\wsl-ubuntu26.04.tar

導入后，使用以下命令啟動：

wsl -d Ubuntu

第二部分：系統(tǒng)更新與依賴安裝

進入 WSL 終端后，首先更新系統(tǒng)包列表并升級現(xiàn)有包：

sudo apt update && sudo apt upgrade -y

安裝 tmux（分屏模式必備）
為了支持 Claude Code 的 Agent Team 分屏模式，我們需要安裝終端復用器 tmux：

sudo apt install tmux -y

安裝完成后，可以簡單驗證一下是否安裝成功：

tmux -V

安裝 Node.js 和 npm
這是運行 Claude Code 的基礎(chǔ)環(huán)境：

sudo apt install nodejs npm -y

安裝完成后，驗證版本以確保安裝成功：

node --version
npm --version

第三部分：Claude Code 安裝與配置

1. 全局安裝 Claude Code CLI
使用 npm 全局安裝 @anthropic-ai/claude-code 包：

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

2. 配置全局路徑
為了避免權(quán)限問題，建議配置 npm 的全局安裝路徑。首先設置 prefix：

npm config set prefix ~/.npm-global

然后將該路徑添加到系統(tǒng)環(huán)境變量 PATH 中，編輯 ~/.bashrc 文件：

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

使配置立即生效：

source ~/.bashrc

3. 重新安裝（可選）
如果之前安裝失敗或路徑配置有變，可以重新執(zhí)行安裝命令：

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

第四部分：配置文件詳解與 Agent Team 模式

Claude Code 的核心配置位于 ~/.claude/settings.json（不存在則新建）。要開啟 Agent Team 模式，我們需要精細調(diào)整此文件。

配置文件內(nèi)容解析
請在你的用戶目錄下創(chuàng)建或編輯該文件，內(nèi)容如下：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx",
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_MODEL": "MiniMax-M2.7",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "includeCoAuthoredBy": false,
  "teammateMode": "tmux"
}

關(guān)鍵配置項說明：

• ANTHROPIC_AUTH_TOKEN: 替換為你的實際 API 密鑰。
• ANTHROPIC_BASE_URL: 根據(jù)參考信息，此處配置為 https://api.minimaxi.com/anthropic，指向 MiniMax 的服務端點。
• 模型配置: 將默認模型（Haiku, Opus, Sonnet）均指向 MiniMax-M2.7，確保請求被正確路由。
• 超時設置: API_TIMEOUT_MS 設置為 3000000（50分鐘），防止長時間運行的任務被中斷。
• Agent Team 核心配置:
  • CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: 必須設置為 "1" 以啟用實驗性的多智能體團隊功能。
  • teammateMode: 設置為 "tmux"，這將利用 tmux 會話管理器來隔離和管理不同的智能體終端。

第五部分：啟動與使用

1. 啟動 tmux 會話
在項目目錄下啟動 tmux：

cd /mnt/e/project/xx-project
tmux new -s claude_team

2. 啟動 Claude Code
在 tmux 會話中運行：

claude

此時，Claude Code 應該會檢測到 teammateMode 配置，并嘗試在 tmux 環(huán)境中啟動 Agent Team 模式。你將能夠看到多個智能體在不同的 tmux 窗格中協(xié)同工作，處理代碼生成、審查和測試任務。

示例Prompt：創(chuàng)建一個 agent team 來審查當前項目，一個隊友負責檢查代碼安全風險，另一個隊友負責檢查性能問題，最后匯總成一份報告。

總結(jié)
通過以上步驟，你已經(jīng)成功在 WSL 環(huán)境中部署了 Claude Code，并利用 tmux 開啟了 Agent Team 模式。這種配置不僅利用了 Linux 環(huán)境的穩(wěn)定性，還通過 tmux 實現(xiàn)了高效的多智能體協(xié)作開發(fā)流。

上一篇：Windows 環(huán)境下 Claude Code 安裝與配置完全指南（含國產(chǎn)模型切換）

到此這篇關(guān)于在 WSL 中部署 Claude Code 并開啟 Agent Team 模式的文章就介紹到這了,更多相關(guān)Claude Code開啟Agent Team 模式內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論