建立並設定代理

本指南說明如何將代理加入工作區，並持續設定到它真的能執行為止。

每個工作區建立時都會預置五個代理——一位 CEO 加上 qa、architect、engineer 與 librarian——因此你通常在還沒設定任何代理之前就已經有代理可用。以下步驟對預置代理與新建代理同樣適用。

開始之前

你已位於某個工作區內。整個介面位於 設定 → 工作區 → 代理（/settings/workspace/agents）。
代理需要一個後端。你可以為內建執行環境在 設定 → 伺服器 → 模型供應商 連接供應商，或在裝載 cc_server 的機器上安裝 Claude Code CLI。
如果你希望代理具備技能，請先在 設定 → 工作區 → 技能 安裝它們。代理表單只能切換工作區中已存在的技能。

這裡不會出現對話框，也沒有角色選擇器。系統會立即建立一個名為「未命名代理」的代理，並在右側的詳細資料窗格中選取它。

此時你應該會在左側名冊中看到「未命名代理」，其詳細資料窗格已開啟設定分頁，且名稱欄位中包含「未命名代理」。

點擊表單底部的 儲存變更。本頁的每個欄位都由這一個按鈕儲存。

配接器 下拉式選單會列出伺服器主機上實際具備的執行器。內建配接器一律會被找到（它就是伺服器本身）。Claude Code 只在那台主機上偵測到它的 CLI 時才會出現：

配接器	後端
Control Center (built-in)	行程內的代理迴圈 — 不需要外部 CLI
Claude Code	`claude -p --output-format stream-json`

只有內建配接器會強制執行模式、操控、暫停/繼續、完成契約與子代理。Claude Code 這些全都沒有。Cursor、Codex 與其他模型供應商都掛接在內建配接器上，而不是獨立的執行器。

模型下拉式選單由你所選的配接器決定。對內建配接器而言，清單即時來自你在 設定 → 伺服器 → 模型供應商 已連接的供應商，因此沒有儲存憑證的供應商會貢獻零個模型。

技能是涵蓋此工作區中已安裝技能包的晶片選擇器。點按晶片即可切換；勾號圖示會標示已選取的項目。如果工作區沒有任何技能，該欄位會顯示「No skills available. Create skills in Settings → Skills first.」

你無法在這裡挑選儲存庫自帶的技能。帶有技能的儲存庫（放在 .agents/skills/、.claude/skills/ 或 .opencode/skills/）會自動把它們貢獻給在該儲存庫中工作的任何代理，並在代理移到另一個儲存庫時換掉——參見儲存庫範圍技能。

直屬主管 — 依名稱挑選另一位代理。這會建立頁首 組織圖 按鈕所顯示的回報樹。它不是團隊領導者委派時所用的名冊——那名冊來自團隊的成員及其技能。
人設 — 塑造語氣與行為的自由文字，例如：「偏好簡單、易讀的解法。為所有新程式碼撰寫測試。」

推理力度 — 選項來自所選模型自己公布的等級：Low / Medium / High，OpenAI 風格的模型另有 Extra High，Claude 風格的模型另有 Extra High + Max。當所選模型未宣告任何思考等級時，此欄位會完全隱藏，並採用模型本身的預設值。
上下文視窗大小 — 每次更換模型時會依模型的上下文視窗預先填入，並有一鍵晶片可選模型預設值、200k、500k 與 1M。你在選定模型之後輸入的值會生效，直到下次更換模型為止。
靜音逾時（分鐘） — 超過這段時間沒有輸出就終止執行。留空則使用各模式的預設值。

代理沒有自己的權限開關。它能推送、開啟、合併或存取什麼，由 設定 → 工作區 → 代理權限 中的動作規則決定，你可以在那裡把規則限定到這個代理。預設情況下，推送、pull request、審查或合併以及寫入追蹤器都會先逐項詢問你，網路存取則是允許的。

代理的 GitHub 權杖一律是唯讀的。推送會經由 Control Center，它在轉送前會詢問推送到遠端規則。每條規則如何作用於一次執行，請參見設定沙箱原則。

開啟 設定 → 伺服器 → 模型供應商，確認你選擇的配接器回報的是已安裝版本，而不是「找不到」。點擊 重新整理 可重新探測——探測是在裝載 cc_server 的機器上執行，而不是在你正在檢視的這台機器上。
開啟一個含有該代理的空間並傳訊息給它，或在既有空間中 @提及它。
回到 設定 → 工作區 → 代理，選取該代理並開啟它的日誌分頁。應該會出現一次執行，帶有狀態徽章、執行時間長度、開始時間，以及它使用的配接器。檢視會開啟該次執行的事件串流。

如果完全沒有出現任何執行，請依診斷代理逐步排查。

在名冊中選取它。在設定分頁中，捲到表單底部的 危險區域，然後點擊刪除。