文章
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 和最大项目数均可在设置中调整。
当执行中断时(轮次被叫停、worker 失败、会话关闭),可能会残留 worktree 和分支。使用 /sub5-clean 可以列出这些残留,确认后仅清理没有未提交改动的 worktree 以及已合并的分支;最近一小时内使用过的会被保留。
若各项目之间存在依赖关系,则不适合使用 Sub5,并行处理只会徒增合并冲突。
模型切换#
O F S H 分别代表 Opus、Fable、Sonnet、Haiku。
- 终端:直接切换当前会话的模型,并保留原有的 effort 等级。
- 桌面端 App:由于 Claude Code 不允许插件发送以
/ 开头的 prompt,且 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 运行状态或 URL,连续 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,或拉取指定的 URL。
已知限制#
- Windows 暂未测试。
- 桌面端 App 的模型按钮无法一键直接切换,需在输入框中按 Enter 确认。
- 外派暂不支持手动中止:Deckhand 仅监听执行外派的 Bash 调用,无法中途取消该调用。
- 外派的任务描述会发送给第三方服务商。
源码与完整文档已发布至 GitHub。Deckhand 为独立开发的第三方插件,非 Anthropic 官方产品。