跳到主要內容

安裝與使用 Claude Code Agent Teams(代理團隊) 的完整指南

Anthropic 正式將原本由 OpenClaw 社群開發的多代理協作功能納入原生支援。以下是關於如何設置並在今天開始使用的詳細介紹。


核心概念:從「單兵作業」進化到「團隊協作」

早期的 Claude Code 運作模式就像一位單一員工:給它一個任務,它從第一步做到最後一步,一次只能處理一件事。

Agent Teams 則完全改變了遊戲規則。現在,當你描述一個大型任務時,會有一位 「首席代理(Lead Agent)」 出現。它會將任務拆解,並同時開啟多個 「隊友(Teammates)」 平行作業:

  • 一位隊友研究程式碼庫。

  • 另一位正在除錯某個函式。

  • 第三位則在撰寫測試案例。

他們擁有各自的內容視窗(Context Window),甚至能彼此傳送訊息、分享發現,並透過共享的「任務清單(Task List)」自我協調。


區分:子代理 (Sub-agents) vs. 代理團隊 (Agent Teams)

你可能會問:「這跟之前的子代理有什麼不同?」

  • 子代理: 像是一個去幫你跑腿買咖啡的助理,做完專屬的小任務後回報結果,成本較低。

  • 代理團隊: 每個隊友都是一個「完整的 Claude Code 階段」。他們不只是回報,還能互相討論、質疑彼此的工作。這就像把一群專家關在房間裡,讓他們共同解決複雜問題。


什麼時候該用「代理團隊」?

這項功能會消耗大量 Token,且有一定的協調成本,因此不要濫用。

  • 適用場景:

    • 平行研發: 同時處理前端、後端與測試。

    • 競爭性除錯: 讓多個代理同時測試不同的錯誤假說,誰先找到答案誰就贏。

    • 深度審查: 從不同角度(例如安全性、性能、易讀性)同時審核程式碼。

  • 不適用場景:

    • 循序漸進的任務: 如果第二步必須等第一步完成,則不需要團隊。

    • 編輯同一檔案: 兩個代理同時改同一個檔案會導致覆蓋衝突。

    • 簡單任務: 單一代理能搞定的事,開團只會浪費錢。


安裝與設定(只需 30 秒)

這項功能目前處於「研究預覽版(Research Preview)」,預設是關閉的。

1. 修改設定檔

在你的 settings.json 中加入以下環境變數:

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

2. 或者直接在終端機設定

如果你想在當前工作階段開啟,可輸入:

  • macOS/Linux: export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

  • Windows (PowerShell): $env:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS="1"


如何下指令啟動團隊?

你不需要學習特殊語法,只需用白話文告訴 Claude 你的需求:

範例提示詞:

「我正在設計一個追蹤程式碼 TODO 註釋的工具。請建立一個代理團隊,從不同角度切換:一個負責 UX 使用者體驗,一個負責技術架構,另一個扮演反方(Devil's Advocate)來質疑設計缺陷。」

顯示模式

  • 處理中模式(In-process): 預設模式,所有隊友都在同一個終端機運作。使用 Shift + Up/Down 來切換不同隊友的畫面。

  • 分欄模式(Split-pane): 如果你使用 tmuxiTerm2,每個隊友會有獨立的視窗面板,讓你同時監控所有人。


如何操控運行中的團隊

  1. 直接溝通: 你可以隨時切換到某位隊友的視窗直接對話,不一定要透過首席代理。

  2. 委派模式(Delegate Mode): 按下 Shift + Tab 開啟。這會強制首席代理只負責「協調與分配」,防止它自己跑去寫程式碼而忘了管理隊友。

  3. 任務領取: 隊友完成目前工作後,會自動從清單領取下一個任務。

  4. 關閉隊友: 任務完成後,叫首席代理關閉特定的隊友,最後再執行 /cleanup 清理資源。


專家建議:避免浪費 Token

  • 詳細的啟動提示: 雖然隊友會讀取 CLAUDE.md,但他們不會繼承首席代理的對話歷史。啟動時給予明確的背景資訊。

  • 切割任務粒度: 任務太小則協調成本太高;太大則容易跑偏。最好的單位是:一個函式、一個測試檔、或是一次代碼審查。

  • 檔案分工: 確保每個隊友負責不同的檔案路徑。


目前的侷限(請注意)

  • 不支援階段恢復: 如果你使用 /resume/rewind,目前的隊友可能會消失,必須重新生成。

  • 狀態延遲: 有時隊友做完了卻沒更新工作清單,這時需要你或首席代理去「推」它一下。

  • 終端機限制: VS Code 內建終端機目前不支援「分欄顯示模式」。



留言

這個網誌中的熱門文章

[CSS] z-index 在不同瀏覽器繼承問題

今天會討論到這個課題,是因為要實做一個Popup dialog,所以我們希望的結果如下圖。 可是在IE7 卻發生了這樣的情況。 Popup不論怎麼設定z-index都無法浮在最上層,我們看一下html架構發生什麼事情。

[教學] 快快樂樂刪除CodeIgniter index.php

預設的CI網址預設都設定為index.php同一層級,因此所有的程式都必須指定index.php導向才能開始,例如 http://localhost/ci/index.php/welcome/test http://localhost/ci/welcome/test 本文將說明如何將惱人的index.php消除,還你一個漂亮的URL。 設定開始: 接下來說明如何使用rewrite方式將惱人的index.php去除。 rewrite不清楚的人,煩請先自行google 首先要先確定Apache的 mod_rewrite 有 開啟 ,如果沒有開啟請設定好之後重新啟動apache。 接著,在根目錄底下建立一個新檔案,檔名為 .htaccess ,裡面程式碼如下: <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php/$1 [L] </IfModule> 接著到 application/config/config.php ,開啟檔案修改 $config['index_page'] = ""; 注意: /index.php/$1 要根據你目錄,例如 http://localhost/index.php ,網站根目錄為 /ci/index.php 則要寫成 /ci/index.php/$1 接著至CI目錄下,尋找 config\config.php , 修改一下裡面的檔案,修改如下: $config['index_page'] = ""; 存檔後,如此一來大功告成。 參考資料 官方網站說明

[教學] Mojito 安裝與入門,install mojito for beginner.

mojito ,最近終於從 YDN 對外公開此專案,這個套件主要用於解決前端多重裝置及瀏覽器端的問題,後端服務採取 node.js ,因此使用上必定要先準備以下幾個元素 準備素材 c++ complier git Node.js > 0.4.x NPM > 1.0.x 安裝方式 git clone git://github.com/yahoo/mojito.git cd mojito/source sudo npm install -g . npm install . 以上四個簡單的步驟,就可以把 mojito module 完整安裝到服務器上,接著就可以開始進入 mojito 的世界 使用方式 mojito 提供了完整的 command line 給開發者使用,接著先建立一個基本 hello world 專案,跟著以下步驟完成第一個專案。首先建立一個 mojito application, mojito create app hello cd hello 切換到目錄之後,再接著建立自己的 mojit,這邊的 mojit 就像是一個應用(application)可能會包含許多個獨立網站體,擁有獨立架構的 MVC ,包含內部設定等,詳細資料可以參考官方的 說明 ,建立 mojit mojito create mojit HelloMojit 輸入指令後,會看到顯示結果如下, creating mojit called 'HelloMojit' (using "default" archetype) ✔ mojit: HelloMojit created! ✔ mojito done. 接著修改 application.json 這個 mojit 設定檔案,讓剛才新建立的 hellp application 指定底下有一個 mojit -> HelloMojit ,讓應用可以去執行 mojit controller ,修改如下, [ { "settings": [ "master" ], "appPort": 8666, "specs": { ...