关于 Deputy
Deputy 是面向编码 Agent 的 Claude Code 插件和 MCP 服务,以 DeepSeek V4.1 Flash 作为低成本辅助模型,由 Claude 继续负责编写代码。它提供代码审查、第二意见、代码库调查和可选的任务委派。
主要功能
- 01审查代码变更中的错误
- 02获取多角度意见
- 03查找代码位置与测试
- 04委派明确的编码任务
- 05追踪令牌与费用估算
适用场景
- 01在完成前检查较复杂的代码变更
- 02在大型代码库中查找函数
- 03获取实现计划的反馈
- 04委派定义明确的机械性工作
MCP 相关
Deputy 通过 MCP 服务提供 review、consult、investigate、delegate 和 stats 工具。它可安装在 Claude Code 中,也可通过 stdio 配置给其他 MCP 客户端。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
uvx deputy-ccDEPUTY_PROVIDERdeepinfra (DeepSeek V4.1 Flash) or xai (Grok, default model grok-4.3).DEEPINFRA_API_KEY密钥DeepInfra API key (deepinfra.com, Dashboard > API Keys), for the default provider. Only sent to api.deepinfra.com.XAI_API_KEY密钥xAI API key (console.x.ai), when DEPUTY_PROVIDER is xai. Only sent to api.x.ai.DEPUTY_MODEaccuracy: Claude writes all code; Deputy reviews and consults. lean: fewest Claude tokens, little accuracy loss. balanced: Deputy takes mechanical work. partner: Deputy does all low-level work and gives ideas. savings: Deputy takes most coding.DEPUTY_THINKINGHow hard the helper model thinks.DEPUTY_MODELModel id served by the endpoint.DEPUTY_BASE_URLAny OpenAI-compatible endpoint (https, or http on localhost for a local model).DEPUTY_WORKSPACEProject folder Deputy may read and edit. Defaults to the client's project folder.DEPUTY_API_KEY密钥API key for a non-DeepInfra endpoint. Takes precedence over DEEPINFRA_API_KEY.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
6收录的工具列表 · 更新于 2 天前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| lenses | any | 否 | |
| context | string | 否 | |
| my_view | string | 否 | |
| question | string | 是 | |
| thinking | any | 否 | |
| project_dir | string | 否 |
详细介绍
Deputy
让低成本模型担当副手。Claude 仍是警长。
Deputy 是一个 Claude Code 插件和 MCP 服务,它使用低成本模型 DeepSeek V4.1 Flash 审查 Claude 编写的代码,查找漏洞并提供第二意见,每次不到 1 美分。代码仍由 Claude 编写。
这是一个基准测试案例的回放。Deputy 的发现、耗时和成本、复现过程及测试运行都是真实的。
claude plugin marketplace add alimohammadiamirhossein/deputy
claude plugin install deputy@deputy
在 Claude Code 中,执行相同操作的命令是 /plugin marketplace add alimohammadiamirhossein/deputy。
你需要 uv 和一个
DeepInfra API 密钥。
成本(实测)
| 运行 | 耗时 | 成本 |
|---|---|---|
review:两位审查器检查一个植入了差一错误的更改(两者都发现了) | 27 s | $0.0011 |
consult:从两个角度提供第二意见 | 68 s | $0.0018 |
investigate:列出项目中的函数及其测试 | 18 s | $0.0004 |
delegate:修复一个漏洞,添加 3 个测试,运行 pytest 直至通过 | 46 s | $0.0006 |
在一个小型演示项目上使用 high 思考模式测得。在实际项目中,consult 和
review 的成本预计仍低于 $0.01。每个结果都会显示实际的令牌用量和成本。
基准测试:使用和不使用 Deputy 的 Opus
四项带有 Claude 看不到的隐藏测试的小型 Python 任务(bench/), 于 2026 年 10 月在 Claude Opus 5.5 上各运行一次:
| 配置 | 通过的隐藏测试 | 平均成本(Claude + Deputy) | 耗时中位数 |
|---|---|---|---|
| 单独使用 Opus | 4/4 | $0.18 | 30 s |
Opus + /deputy:review | 4/4 | $0.31($0.30 + $0.013) | 3.7 min |
Opus + /deputy:delegate | 4/4 | $0.19($0.19 + $0.0015) | 76 s |
这些结果说明了什么,又不能说明什么:
- **这里没有可测量的准确度提升。**这些任务太简单了:Opus 单独使用就通过了所有隐藏测试。
- **审查给 Claude 带来的成本高于给 Deputy 带来的成本。**Deputy 分摊的成本约为 1 美分,但 Claude 还要花费更多精力检查发现,因此经过审查的任务成本增加了 68%,耗时也更长。有一次审查耗时 24 分钟,因为一位审查器进行了 73k 个令牌的思考。
- **这些发现确实改变了代码。**在 4 项任务中的 3 项里,Claude 将代码强化到了超出规范要求的程度:它修复了一个会被 NaN 时间戳永久阻塞的速率限制器,并补上了缺失的测试。它拒绝了一条与规范相矛盾的发现。
- **在这么小的任务上,委派没有节省任何成本。**Claude 自己阅读和检查所花的成本,和编写代码本身差不多。
- **样本量很小。**每种配置只运行了一次。完整表格: bench/results/2026-10-24-opus。
review 能发现 bug 吗?又有多大概率误报?
在 6 个植入 bug 的改动和 8 个干净改动上,单独运行 Deputy 的 review,不使用 Claude。
每个植入 bug 的改动都有一个干净的双胞胎,即正确完成的相同改动。每项运行 5 次
(bench/review_cases):
| 差异 | 审查次数 | 标记次数 | 标记为 major 或 critical 的次数 | 平均成本 | 平均耗时 |
|---|---|---|---|---|---|
| 植入 bug | 30 | 30/30 次均发现 | 30/30 | $0.0022 | 55 秒 |
| 干净改动 | 39 | 23/39 | 7/39 | $0.0067 | 4 分钟 |
- **每个植入的 bug 都被发现了,**每次都被两位审查者标记为 major 或 critical。
- **干净代码仍会出现发现项,**因此 Claude 必须逐一检查。大多数发现项都是 minor(61 项中有 50 项),18% 的干净改动审查包含 major 级别的判断。
- **其中许多发现项是合理的,**例如一个不会失败的测试、没有任何测试覆盖的入口点,或比改动 假设范围更大的缓存键(7 项 major 级别判断中有 5 项)。
- **基准测试已修复一个误报原因。**在首次运行中,审查者将标记为“(未跟踪)”的新文件视为
未纳入改动。Deputy 现在会像
git diff一样显示这些文件。这类发现项从 6 项降至 0 项, 而包含 major 级别判断的干净改动审查从 11/39 降至 7/39(其中一部分降幅是运行间的随机波动)。 - **对于干净代码,一致意见并非有力证据。**两位审查者在 26% 的干净差异中标记了同一处,因此 不能仅仅因为两位审查者都报告了某个发现项,就认为它确实存在。
- 干净差异上的所有发现项都列在结果中: 最近一次运行, 首次运行。
功能说明
Claude(例如 Opus 5.5)仍负责掌控全局并编写代码。Deputy 会在你的项目中添加四种工具, 由成本低得多的模型作为助手运行:
| 工具 | 功能 |
|---|---|
review | 独立审查者会在 Claude 宣布任务完成前,查找其改动中的 bug |
consult | 在 Claude 确定计划前,同时从 2–4 个角度征求第二意见 |
investigate | 阅读大量代码并返回 file:line 线索 |
delegate | 将编码任务交给低成本模型(默认关闭;可按需启用,或在节省模式下启用) |
stats | 大致显示 Deputy 为你节省了多少 token 和费用:本次会话、今天、本周及累计 |
Claude 会将 Deputy 提供的所有内容视为未经验证的提示:它会对照代码检查每项发现, 并只保留经得起检验的内容。
查看节省情况
每项结果的末尾都会附上一行估算,例如下面这条来自真实 investigate 运行的结果:
Savings (rough): this work would cost about $0.0082 on Claude Opus 5.5; Deputy did it for $0.0001. Saved about $0.0074 and 2.0k Claude Opus 5.5 tokens.
向 Claude 请求 stats,或运行 deputy stats,即可查看总计。审查和第二意见会单独列为额外检查,
因此不会夸大节省量。估算假设你的主模型会使用大致相同数量的 token,因此应将其视为数量级估算。
只存储数字,从不存储代码或提示词。使用 DEPUTY_LEAD_MODEL(opus、sonnet、
haiku、fable 或 custom)设置你的主模型。
何时使用 Deputy,何时不使用
适用于:
- 非简单的更改:漏掉一个 bug 的代价超过一分钱,例如逻辑、边缘情况,以及涉及多个文件的重构。
- 在 Claude 确定设计方案前征求第二种意见,同时不消耗 Claude 的 token。
- 在大型代码库中广泛查阅,例如“这个设置在哪里读取?”。
- 规格明确的机械性工作(样板代码、重命名、测试脚手架),在
lean、balanced、partner或savings模式下执行,适合想在较大的任务上节省 Claude token 的情况。在小任务上它并没有节省任何 token,详见基准测试。
不适用于:
- 拼写错误和单行改动等琐碎编辑。审查需要几分钟,但收益不大。
- 你可能不会与第三方分享的代码。Deputy 会将代码发送到 DeepInfra,或发送到你在
DEPUTY_BASE_URL中设置的端点(也可以使用本地模型)。 - 最终答复。发现的问题来自较弱的模型,其中也包含误报,因此 Claude 会逐一核实。
- 在
savings模式下做架构和安全敏感型决策。此类工作应交给 Claude。
快速开始
1. 获取 DeepInfra API 密钥(DeepInfra 在美国托管 DeepSeek 的模型)
- 使用 GitHub、Google 或电子邮件在 deepinfra.com 注册。
- 在 Dashboard → Billing 中添加银行卡并充值 $5–10,然后将消费限额设为相同金额。
- 在 API Keys 中创建密钥(以
sk-di-开头)并复制。请妥善保管。
你不需要套餐、购买模型或专用 GPU。按需付费的额度就足够了。
2. 安装 uv 和插件
claude plugin marketplace add alimohammadiamirhossein/deputy
claude plugin install deputy@deputy
Claude Code 会提示你输入 DeepInfra 密钥,并将其存储在系统的安全存储中。
3. 重启 Claude Code 并试用
/deputy:review
/deputy:consult I plan to cache sessions in Redis. What am I missing?
/deputy:investigate how does a request reach the database?
也可以照常工作:遇到非简单任务时,Claude 会自行咨询并审查。
Cursor 和 Codex
运行一条命令即可将 Deputy 添加到编辑器的 MCP 配置中(并备份旧文件),同时将操作手册安装为 Cursor 规则或 Codex 技能:
uvx --from git+https://github.com/alimohammadiamirhossein/deputy deputy setup cursor --project .
uvx --from git+https://github.com/alimohammadiamirhossein/deputy deputy setup codex
先在环境中设置 DEEPINFRA_API_KEY,然后重启编辑器。添加 --dry-run 可在不写入更改的情况下查看将要进行的修改。现成的文件位于
integrations/。
使用 Grok 代替 DeepSeek(实验性,尚未测试): Grok 支持遵循 xAI 的文档,但尚未使用真实的 xAI 密钥运行。如果你愿意尝试,请
告诉我们哪些有效、哪些无效,即使只需回复一个词“有效”也可以。
改用 --provider xai 并设置 XAI_API_KEY(从 console.x.ai 获取)。然后 Deputy 会使用 grok-4.3;将 DEPUTY_MODEL 设为 grok-build-0.1(xAI 的编码模型)或 grok-4.7(其最强模型)。Grok 的每个 token 成本约为 DeepSeek V4.1 Flash 的 10 倍。
uvx --from git+https://github.com/alimohammadiamirhossein/deputy deputy setup cursor --project . --provider xai
其他 MCP 客户端(Cline、Windsurf、Claude Desktop)
Deputy 已发布到 PyPI,包名为 deputy-cc。添加一个 stdio MCP 服务并运行:
uvx deputy-cc serve
并在其环境中设置 DEEPINFRA_API_KEY。运行 uvx deputy-cc doctor 检查配置。
推荐模型:DeepSeek V4.1 Flash,思考强度为 high
默认模型是在 DeepInfra 上运行的 deepseek-ai/DeepSeek-V4.1-Flash-1017,思考强度设为 high。
这是我们为这项工作找到的性价比最佳选择:
- 价格低廉: 每 1M 个输入 token 收费 $0.098,每 1M 个输出 token 收费 $0.294(2026 年 10 月),比 DeepSeek 自家的 API 更便宜。
- 能力出色: 上下文长度约为 1M 个 token,并且能可靠地调用工具。
- 确实启用了思考: 除非特别要求,否则 DeepInfra 会关闭思考功能。Deputy 始终会请求启用思考(
high),我们通过测量推理 token 确认了这一点。 - 保护隐私: DeepInfra 表示不会使用你的数据训练模型。你的代码不会发送到 DeepSeek 自己的服务器。
模式
| 模式 | 由谁编写代码 | 适用场景 |
|---|---|---|
| accuracy(默认) | 始终由 Claude 编写 | 你想获得最佳结果 |
| lean | 小型和棘手的更改由 Claude 编写;Deputy 阅读代码并承担范围明确的大型任务 | 你希望尽可能少用 Claude 令牌,同时几乎不损失准确性 |
| balanced | 由 Claude 编写;Deputy 负责样板代码 | 你希望节省一些开销,同时避免风险 |
| partner | Deputy 负责所有底层工作;Claude 检查每个差异 | 你希望 Deputy 负责具体工作并提出想法,由 Claude 进行验证 |
| savings | Deputy 编写,Claude 验证 | 你希望尽可能节省令牌 |
在插件设置(/plugin)中更改,或使用 DEPUTY_MODE。
了解更多
- SKILL.md:Claude 遵循的操作指南(咨询 → 决策 → 实施 → 审查 → 检查每项发现)。无需插件也可使用。
- docs/REFERENCE.md:所有设置、费用、安全、服务条款、设计背后的研究、故障排除和路线图。
- CHANGELOG.md:各个版本的变更内容。
Deputy 遵守 Anthropic 的规则:Claude Code 保持原样运行,Deputy 也绝不会接触你的 Claude 登录信息。它是一个普通的 MCP 工具,使用你自己的 DeepInfra 密钥。
支持此项目
如果 Deputy 帮你发现了 Bug,给它点个 ⭐,并分享给使用 Claude Code 的朋友。欢迎提交问题和拉取请求;适合新手的问题是很好的起点。
MIT © 2026 Amirhossein Alimohammadi · 与 Anthropic、DeepSeek 或 DeepInfra 无关联。
关键词:Claude Code 插件、MCP 服务、Model Context Protocol、AI 代码审查、第二意见、DeepSeek V4.1 Flash、DeepInfra、子 Agent、Opus、Agent 编码、降低 Claude Code 成本。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。