安裝
/plugin marketplace add arbiterForge/codeArbiter
/plugin install ca@codearbiter適合誰
- 在 Claude Code、Codex CLI 或 Pi 裡工作、希望改動在進入程式碼庫前經過強制檢查的開發者與團隊:codeArbiter 是為這三個宿主設計的治理層(governance layer),官方倉庫標題道出它的動機——「When you can't trust yourself with your code base, trust Arbiter.」(當你在自己的程式碼庫上無法信任自己時,交給 Arbiter)。
- 啟用後,向 agent 表達的每個意圖都會被路由到 gated skill 或 reviewer agent,閘門全綠之前不會提交,決策經 SMARTS,稽核記錄 append-only、只能追加。它作用在儲存庫粒度上:opt in 的對象是某個儲存庫。需要提交前強制關卡與可追溯決策記錄的人,面向的正是這類需求。append-only 意味著稽核記錄只能新增,不能刪除或改寫。
- 適合「先看後動」的謹慎使用者:官方明確說明外掛裝後預設休眠,在你顯式 opt in 某個儲存庫之前,它對該儲存庫不做任何事,原文稱「That silence is intentional.」(這種沉默是有意設計);安裝本身不會立刻改變儲存庫的現有行為。
- 不適合的情況:不想要門禁式流程、只想做一次性程式碼分析或改寫的場景,以及環境無法滿足下一節所列需求的機器。它適用於哪些程式語言與專案類型,官方說明未涉及,未知,這直接影響你是否該選它。
- 除 Claude Code、Codex CLI 與 Pi 之外是否支援其他 agent 宿主,證據未說明,未知。
3 分鐘完成第一次嘗試
- 前提:Windows、macOS 或 Linux;官方要求 Pi 0.80.10、Node.js 22.19 或更新版本、Python 3 與 Git,無需帳號或範例資料。缺任何一項時,先補齊環境再安裝。
- 安裝位置:官方給出的安裝路徑是 Claude Code 的 plugin marketplace。在 Claude Code 中依序執行下面兩條指令——第一條把 arbiterForge/codeArbiter 加入為 marketplace 來源,第二條從該來源安裝名為 ca 的外掛:
/plugin marketplace add arbiterForge/codeArbiter
/plugin install ca@codearbiter
- 安裝後的成功訊號:hooks、commands、agents 與 statusline 接線自動載入,所有指令在 /ca: 命名空間下解析;也就是說裝完不需要手動接線,以 /ca: 為前綴的指令應能被辨識。此時外掛仍在休眠,這是預期行為,不代表安裝失敗。
- 關鍵確認點:儲存庫必須顯式 opt in 之後才會進入治理流程,安裝完成不等於開始工作。opt in 的具體指令未在官方說明中出現,這一步如何執行未知,請以官方倉庫內的說明為準,不要自行猜測指令。
- 第一次任務:opt in 之後,向 agent 表達一個普通的程式碼分析或修改意圖,然後觀察兩點——意圖是否被路由到 gated skill 或 reviewer agent;閘門全綠前是否保持不提交。如果意圖沒被路由、或閘門未全綠就提交了,表示治理流程沒有按官方描述運作。/ca: 下還有哪些具體指令,證據未列出,無法逐字給出。
使用案例
- 案例 1:為個人儲存庫啟用門禁式提交。情境:希望每次改動在提交前自動過一遍檢查。做法:在 Claude Code 中執行上述兩條安裝指令裝好 ca 外掛,確認 hooks、commands、agents 與 statusline 已自動載入、/ca: 指令可解析,然後把儲存庫 opt in,再向 agent 發出變更意圖。可期待:意圖被路由到 gated skill 或 reviewer agent,閘門全綠前不會提交,決策經 SMARTS,稽核記錄只能追加。由於裝後休眠,這個案例的所有副作用都從 opt in 那一步才開始,安裝指令本身不會觸發治理動作。只想先看裝上後是什麼樣子的話,到「自動載入、/ca: 可解析」這一步就可以停下來觀察,不必急著 opt in。
- 案例 2:讓團隊的變更決策可追溯。情境:多人協作時,希望每個改動的決策有據可查、歷史不被改寫。做法:對已 opt in 的儲存庫向 agent 表達變更意圖,走同一套門禁工作流。可期待:決策經 SMARTS 記錄,稽核記錄 append-only,已寫入的記錄不會被後續操作覆寫。SMARTS 具體如何互動、在哪個介面檢視記錄,證據未說明,可確認範圍到此為止。
使用邊界
- 副作用與確認點:安裝時會自動載入 hooks、commands、agents 與 statusline 接線,這是官方說明的安裝即發生的行為;初始狀態為休眠,顯式 opt in 某個儲存庫之前,外掛對該儲存庫不做任何事,因此不 opt in 就無法驗證治理效果。opt in 本身是否可撤銷、如何撤銷,證據未說明,未知;在意回退成本的使用者應在 opt in 前先確認這一步。
- 檔案、指令與網路:它是否會讀寫你的檔案、執行哪些指令、是否存取網路,官方說明均未涉及,未知;不能據此推斷它沒有任何這類行為。把它接到重要儲存庫前,建議先在一個可捨棄的環境中 opt in 試運行。
- 平台與用戶端差異:官方逐字給出的安裝路徑只有 Claude Code 的 plugin marketplace;Codex CLI 與 Pi 雖被列為治理層服務的宿主,但兩者的安裝方式未在官方說明中出現,未知。
- 尚未確認的關鍵資訊:opt in 的具體指令、/ca: 命名空間下的完整指令清單、SMARTS 的互動方式、支援的程式語言與專案類型、Windows、macOS、Linux 之外的系統支援、如何解除安裝或臨時停用,均未在證據中出現,採用前請到官方倉庫逐項確認。