記事
Deckhand の紹介：Claude Code をサードパーティ AI の統合コントロールプレーンにする
Deckhand はオープンソースの Claude Code プラグインで、入力欄の上にツールバーを追加します。タスクを Codex、Cursor agent、agy に読み取り専用で委譲してセカンドオピニオンを取得したり、Sub5 でサブエージェントを並列実行したり、使用量メトリクス表示やモデル切り替え機能を提供します。本記事ではインストール手順、各機能の使い方、データフロー、既知の制限事項について解説します。
· 7 分で読めます
Deckhand は、入力欄の上にツールバーを追加する Claude Code プラグインです。Claude が引き続きプライマリエージェントとして動作し、ツールバーからタスクを Codex、Cursor agent、agy へ読み取り専用で委譲できます。返ってきた回答は Claude が検証したうえで採用するかどうかを判断します。
ツールバーには使用量メトリクスの表示、モデルの切り替え、タスクを複数のサブエージェントに分割して並行処理する Sub5 も備わっています。ターミナルとデスクトップアプリの双方で利用可能です。現在のバージョンは 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：ヘッドレスモード（ツール呼び出しは自動的に拒否されます）
送信前に Deckhand はタスクの指示内容を検査し、トークン、秘密鍵、パスワードが含まれている場合は送信を拒否します。タスクの指示と回答はプライベートな一時ディレクトリに保存され、3 日後に削除されます。
委譲の実行中は、使用量バーの上に 1 行追加され、ラベル、CLI、モデル、経過時間が表示されます。/delegates を実行すると過去 3 日間の委譲履歴が一覧表示され、各回答を開く、コピーする、入力欄に読み込むといった操作が可能なほか、CLI から報告されたトークン数も確認できます。
委譲を行うと、タスクの指示内容は各 CLI のバックエンドサービスプロバイダに送信されます。
Sub5：並列サブエージェント#
Sub5 は、現在のタスクを互いに独立した最大 5 つの項目に分割し、各項目を独立した git worktree 内でサブエージェントに処理させます。すべて完了すると、プライマリエージェントが成果物をレビューして変更を統合し、worktree とブランチをクリーンアップします。
git の操作はスクリプト bin/sub5.py によって実行され、force オプションの使用や push は行いません。サブエージェントのモデル、effort、最大タスク数は設定で調整可能です。
実行が中断された場合（ターンの停止、ワーカーの失敗、セッションの終了など）、worktree やブランチが残ることがあります。/sub5-clean はこれらの残留項目を一覧表示し、確認後に未コミットの変更がない worktree とマージ済みのブランチのみを削除します。直近 1 時間以内に使用されたものは保持されます。
項目間に依存関係がある場合、Sub5 の利用は適していません。並列処理を行うと統合時のコンフリクトが増える原因になります。
モデルの切り替え#
O F S H はそれぞれ Opus、Fable、Sonnet、Haiku に対応しています。
- ターミナル：現在のセッションのモデルを直接切り替え、既存の effort レベルを維持します。
- デスクトップアプリ：Claude Code はプラグインから
/ で始まるプロンプトの送信を受け付けず、アプリ側でもセッション自体のモデル変更が制限されているため、ボタンを押すと /model claude-opus-5-5 のような完全なモデル ID が入力欄に挿入されます。Enter キーを押すことで実際に切り替わり、Deckhand が effort を元のレベルへ戻します。
使用量メトリクス#
5h：5 時間枠。fb、sn、op：アカウントで保持している各モデルの週間枠。7d：全モデル合計の週間枠。ctx：コンテキストウィンドウの使用率。
数値は Claude アプリの使用量カードと一致しており、端数は切り捨てられます。いずれかの枠が警告のしきい値を超えると Deckhand から一度通知されます。しきい値は設定で変更可能です。
Recap#
Recap は、現在の完全なコンテキストをサイドパネルにプレーンテキストで解説します。会話ログ自体には何も追加されません。
監視・保護ツール#
| ツール |
用途 |
/watch-deploy、watch_deploy |
バックグラウンドで PR、CI 実行、または URL を監視し、N 回連続で同一の結果が得られた場合に自動停止 |
| ポーリング保護 |
sleep によるポーリングループや gh run watch のようなブロッキング待機を遮断 |
| 署名保護 |
コミットおよび PR コマンドから Co-Authored-By トレイラーと Claude Code のフッターを除去 |
/handoff、/handoff-in、/codex |
Claude と Codex の間でタスクを引き継ぎ |
translate |
指定した委譲先にローカライズ翻訳を委託（デフォルトは無効） |
search |
指定した委譲先にソース付きのウェブ検索を実行させ、Claude が検証（デフォルトは無効） |
ツールバー右端の ⚙ をクリックするか、/deckhand を実行して設定パネルを開きます。パネルは「一般」「委譲」「翻訳と検索」「Sub5」「高度な設定」の 5 つのタブで構成されています。設定はローカルに保存され、JSON としてエクスポートして他のマシンにインポートすることができます。
インターフェースは English、繁體中文、简体中文、日本語、한국어 に対応しており、デフォルトでは Claude Code の language 設定に従います。
データフロー#
ローカル環境の外部へ送信されるデータは以下の 3 種類のみです。
- 委譲時のタスク指示：委譲ボタンを押した際、選択された CLI のサービスプロバイダに送信されます。
- 使用量の読み取り：Claude Code を介し、現在のセッションの認証情報を用いて Anthropic の使用量エンドポイントを呼び出します。
- 明示的に呼び出されたツール：
translate および search は指定された委譲先に送信されます。監視機能は gh を通じて GitHub に問い合わせるか、指定された URL を読み取ります。
既知の制限事項#
- Windows は未検証です。
- デスクトップアプリのモデルボタンはワンクリックで切り替えることができず、入力欄で Enter キーを押す必要があります。
- 委譲処理には停止ボタンがありません。Deckhand は委譲を実行する Bash 呼び出しを監視しているのみで、プロセスをキャンセルすることはできません。
- 委譲されたタスクの指示内容はサードパーティのサービスプロバイダに送信されます。
ソースコードと完全なドキュメントは GitHub で公開されています。Deckhand は独自に開発されたプラグインであり、Anthropic の製品ではありません。