簡(jiǎn)介

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

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

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

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

wsl --install

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

wsl --install -d Ubuntu

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

wsl -l -v

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

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

若需重新導(dǎo)入（例如在新電腦上），先注銷舊實(shí)例（如果存在）：

wsl --unregister Ubuntu

然后從 tar 文件導(dǎo)入：

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

導(dǎo)入后，使用以下命令啟動(dòng)：

wsl -d Ubuntu

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

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

sudo apt update && sudo apt upgrade -y

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

sudo apt install tmux -y

安裝完成后，可以簡(jiǎn)單驗(yàn)證一下是否安裝成功：

tmux -V

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

sudo apt install nodejs npm -y

安裝完成后，驗(yàn)證版本以確保安裝成功：

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 的全局安裝路徑。首先設(shè)置 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 模式，我們需要精細(xì)調(diào)整此文件。

配置文件內(nèi)容解析
請(qǐng)?jiān)谀愕挠脩裟夸浵聞?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)鍵配置項(xiàng)說明：

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

第五部分：?jiǎn)?dòng)與使用

1. 啟動(dòng) tmux 會(huì)話
在項(xiàng)目目錄下啟動(dòng) tmux：

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

2. 啟動(dòng) Claude Code
在 tmux 會(huì)話中運(yùn)行：

claude

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

示例Prompt：創(chuàng)建一個(gè) agent team 來審查當(dāng)前項(xiàng)目，一個(gè)隊(duì)友負(fù)責(zé)檢查代碼安全風(fēng)險(xiǎn)，另一個(gè)隊(duì)友負(fù)責(zé)檢查性能問題，最后匯總成一份報(bào)告。

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

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

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

最新評(píng)論