文章
Deckhand 介紹:讓 Claude Code 成為你的第三方 AI 總控台
Deckhand 是開源的 Claude Code 外掛,在輸入框上方加設工具列:將任務以唯讀方式分派給 Codex、Cursor agent、agy 提供第二意見,用 Sub5 平行派出子代理,並提供用量指標與模型切換。本文說明安裝方法、各項功能用法、資料流向與已知限制。
· 5 分鐘閱讀
Deckhand 是一個 Claude Code 外掛,會在輸入框上方加設工具列。Claude 仍是主代理;工具列可以將任務交給 Codex、Cursor agent 或 agy 以唯讀方式處理,結果傳回後由 Claude 審查,再決定是否採用。
工具列亦提供用量指標、模型切換,以及將任務拆分給多個子代理平行處理的 Sub5。終端機與桌面版 App 均可使用。目前版本為 1.1.1,採用 MIT 授權。
披露:Deckhand 由本站作者開發。
功能一覽#
| 區塊 |
功能 |
cL cS cA cR gF |
將任務以唯讀方式分派給另一個 AI CLI,再由 Claude 審查結果 |
Sub5 |
將目前的任務拆成最多 5 項,交給子代理在各自的 git worktree 平行處理 |
O F S H |
切換為 Opus、Fable、Sonnet 或 Haiku |
| 用量指標 |
5 小時區間、各模型的每週區間、所有模型合計的每週區間、上下文視窗 |
Recap |
在側邊窗格說明目前的上下文 |
⚙ |
開啟設定窗格 |
安裝與系統要求#
在 Claude Code 中執行:
/plugin marketplace add stephen-taipei/deckhand
/plugin install deckhand@deckhand
若工具列未有出現,請開啟新的工作階段。
系統要求:
- macOS 或 Linux。Windows 尚待測試。
- 支援外掛 hook 模組的 Claude Code,已在 2.1.288 測試。
- Python 3.9 或以上版本。
- 選用:監看功能需要
gh;外派按鈕需要 codex、Cursor agent 或 agy CLI。未安裝的 CLI,對應的按鈕會自動隱藏。
外派:唯讀的第二意見#
按下外派按鈕後,Deckhand 會將任務交給對應的 CLI。對方只能讀取、不能修改,產生答案後交回 Claude 審查。
預設的外派目標:
| 按鈕 |
CLI |
模型 |
Effort |
cL |
Codex |
GPT-6 Luna |
max |
cS |
Codex |
GPT-6.1 Sol |
medium |
cA |
Codex |
GPT-6 Astra |
medium |
cR |
Cursor agent |
Grok 4.7 |
high |
gF |
agy |
Gemini 3.8 Flash |
high |
標籤、CLI、模型 ID、effort 與名稱均可在設定中修改。
唯讀限制由各 CLI 本身的旗標或模式強制執行:
- Codex:
-s read-only
- Cursor agent:
--mode ask
- agy:headless 模式,工具呼叫會被自動拒絕
送出前,Deckhand 會檢查任務說明;若含有 token、密鑰或密碼會拒絕送出。任務說明與答案存放於私有的暫存資料夾,3 天後自動刪除。
外派執行期間,用量列上方會額外顯示一行,列出標籤、CLI、模型與已執行時間。/delegates 可列出近 3 天的外派記錄,每項結果均可開啟、複製或帶回輸入框,亦會顯示 CLI 回報的 token 數量。
外派會將任務說明傳送至該 CLI 背後的服務供應商。
Sub5:平行子代理#
Sub5 將目前的任務拆成最多 5 個互相獨立的項目,每個項目由一個子代理在各自的 git worktree 中處理。全部完成後,主代理會審查成果、整合變更,並清理 worktree 與分支。
git 操作由腳本 bin/sub5.py 執行,不使用 force,亦不執行 push。子代理的模型、effort 與最多項目數量均可在設定中調整。
run 中斷時(回合被停止、worker 失敗、工作階段關閉),可能會留下 worktree 與分支。/sub5-clean 會列出這些殘留項目,確認後只會移除沒有未提交變更的 worktree,以及已合併的分支;最近一小時內使用過的項目會予以保留。
項目之間若有互相依賴的關係,則不適合使用 Sub5,平行處理只會增加整合時的衝突。
模型切換#
O F S H 分別對應 Opus、Fable、Sonnet、Haiku。
- 終端機:直接切換目前工作階段的模型,並保留原本的 effort 等級。
- 桌面版 App:Claude Code 不接受外掛送出以
/ 開頭的提示詞,App 亦不允許工作階段直接切換自身的模型,因此按鈕會將 /model claude-opus-5-5 這類完整模型 ID 填入輸入框。按下 Enter 後才會切換,隨後 Deckhand 會將 effort 設回原本的等級。
用量指標#
5h:5 小時區間。
fb、sn、op:帳號擁有的各模型每週區間。
7d:所有模型合計的每週區間。
ctx:上下文視窗的使用比例。
數據與 Claude App 用量卡片一致,無條件捨去。任一區間超出警示門檻時,Deckhand 會發出一次通知,門檻可在設定中調整。
Recap#
Recap 在側邊窗格以白話說明目前完整的上下文,不會在對話中加入任何內容。
監看與防護工具#
| 工具 |
用途 |
/watch-deploy、watch_deploy |
在背景監看 PR、CI 執行狀況或網址,連續 N 次結果相同時自動停止 |
| 輪詢防護 |
攔截 sleep 輪詢迴圈與 gh run watch 這類阻塞式等待 |
| 署名防護 |
從 commit 與 PR 指令中移除 Co-Authored-By trailer 與 Claude Code 頁尾 |
/handoff、/handoff-in、/codex |
在 Claude 與 Codex 之間交接工作 |
translate |
交給指定的外派目標進行本地化翻譯,預設關閉 |
search |
交給指定的外派目標進行網絡搜尋並附上來源,再由 Claude 查證,預設關閉 |
點擊工具列最右側的 ⚙,或執行 /deckhand,即可開啟設定窗格。窗格分為一般、外派、翻譯與搜尋、Sub5、進階 5 個分頁。設定儲存於本機,可匯出為 JSON,再於其他電腦匯入。
介面支援 English、繁體中文、简体中文、日本語與한국어,預設跟隨 Claude Code 的 language 設定。
資料流向#
會離開本機電腦的資料只有以下三類:
- 外派的任務說明:按下外派按鈕時,傳送至所選 CLI 的服務供應商。
- 用量讀數:透過 Claude Code,以目前工作階段的憑證呼叫 Anthropic 的用量端點。
- 主動呼叫的工具:
translate 與 search 傳送給指定的外派目標;監看功能透過 gh 查詢 GitHub,或讀取指定的網址。
已知限制#
- Windows 尚待測試。
- 桌面版 App 的模型按鈕無法一鍵切換,需要在輸入框按 Enter。
- 外派沒有終止按鈕:Deckhand 僅監控執行外派的 Bash 呼叫,無法直接取消。
- 外派的任務說明會傳送至第三方服務供應商。
原始碼與完整文件載於 GitHub。Deckhand 為獨立開發的外掛,並非 Anthropic 的產品。