文章
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 的產品。