---
title: "Deckhand 介紹：讓 Claude Code 成為你的第三方 AI 總控台"
description: "Deckhand 是開源的 Claude Code 外掛，在輸入框上方加一條工具列：把任務以唯讀方式交給 Codex、Cursor agent、agy 取得第二意見，用 Sub5 平行派出子代理，並提供用量指標與模型切換。本文說明安裝、各功能用法、資料流向與已知限制。"
url: https://stephen.taipei/articles/deckhand-claude-code-toolbar
author: "Stephen Chuang"
date: 2026-10-11T23:45:44+08:00
tags: [ai-agents]
lang: zh-TW
---

# Deckhand 介紹：讓 Claude Code 成為你的第三方 AI 總控台

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 中執行：

```text
/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](https://github.com/stephen-taipei/deckhand)。Deckhand 是獨立開發的外掛，不是 Anthropic 的產品。