mcpField
D
Deputy

Deputy

本地服务
github.com开发工具23 天前更新

关于 Deputy

Deputy 是面向编码 Agent 的 Claude Code 插件和 MCP 服务,以 DeepSeek V4.1 Flash 作为低成本辅助模型,由 Claude 继续负责编写代码。它提供代码审查、第二意见、代码库调查和可选的任务委派。

主要功能

  1. 01审查代码变更中的错误
  2. 02获取多角度意见
  3. 03查找代码位置与测试
  4. 04委派明确的编码任务
  5. 05追踪令牌与费用估算

适用场景

  1. 01在完成前检查较复杂的代码变更
  2. 02在大型代码库中查找函数
  3. 03获取实现计划的反馈
  4. 04委派定义明确的机械性工作

MCP 相关

Deputy 通过 MCP 服务提供 review、consult、investigate、delegate 和 stats 工具。它可安装在 Claude Code 中,也可通过 stdio 配置给其他 MCP 客户端。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"alimohammadiamirhossein-deputy": {
"command": "uvx",
"args": [
"deputy-cc"
],
"env": {
"DEPUTY_PROVIDER": "<DEPUTY_PROVIDER>",
"DEEPINFRA_API_KEY": "<DEEPINFRA_API_KEY>",
"XAI_API_KEY": "<XAI_API_KEY>",
"DEPUTY_MODE": "<DEPUTY_MODE>",
"DEPUTY_THINKING": "<DEPUTY_THINKING>",
"DEPUTY_MODEL": "<DEPUTY_MODEL>",
"DEPUTY_BASE_URL": "<DEPUTY_BASE_URL>",
"DEPUTY_WORKSPACE": "<DEPUTY_WORKSPACE>",
"DEPUTY_API_KEY": "<DEPUTY_API_KEY>"
}
}
}
}
启动命令uvx deputy-cc
需要配置的环境变量
DEPUTY_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+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypideputy-cc0.3.1

工具

6

收录的工具列表 · 更新于 2 天前

参数类型必填说明
lensesany否
contextstring否
my_viewstring否
questionstring是
thinkingany否
project_dirstring否

详细介绍

Deputy 警长徽章标志

Deputy

让低成本模型担当副手。Claude 仍是警长。

Deputy 是一个 Claude Code 插件和 MCP 服务,它使用低成本模型 DeepSeek V4.1 Flash 审查 Claude 编写的代码,查找漏洞并提供第二意见,每次不到 1 美分。代码仍由 Claude 编写。

GitHub stars CI PyPI License: MIT MCP

Deputy 在 Claude Code 中审查未提交的更改:两个低成本审查器以十分之一美分的成本发现了一个差一错误,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)耗时中位数
单独使用 Opus4/4$0.1830 s
Opus + /deputy:review4/4$0.31($0.30 + $0.013)3.7 min
Opus + /deputy:delegate4/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 的次数平均成本平均耗时
植入 bug3030/30 次均发现30/30$0.002255 秒
干净改动3923/397/39$0.00674 分钟
  • **每个植入的 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 的模型)

  1. 使用 GitHub、Google 或电子邮件在 deepinfra.com 注册。
  2. 在 Dashboard → Billing 中添加银行卡并充值 $5–10,然后将消费限额设为相同金额。
  3. 在 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 负责样板代码你希望节省一些开销,同时避免风险
partnerDeputy 负责所有底层工作;Claude 检查每个差异你希望 Deputy 负责具体工作并提出想法,由 Claude 进行验证
savingsDeputy 编写,Claude 验证你希望尽可能节省令牌

在插件设置(/plugin)中更改,或使用 DEPUTY_MODE。

了解更多

  • SKILL.md:Claude 遵循的操作指南(咨询 → 决策 → 实施 → 审查 → 检查每项发现)。无需插件也可使用。
  • docs/REFERENCE.md:所有设置、费用、安全、服务条款、设计背后的研究、故障排除和路线图。
  • CHANGELOG.md:各个版本的变更内容。

Deputy 遵守 Anthropic 的规则:Claude Code 保持原样运行,Deputy 也绝不会接触你的 Claude 登录信息。它是一个普通的 MCP 工具,使用你自己的 DeepInfra 密钥。

支持此项目

如果 Deputy 帮你发现了 Bug,给它点个 ⭐,并分享给使用 Claude Code 的朋友。欢迎提交问题和拉取请求;适合新手的问题是很好的起点。

Star History Chart


MIT © 2026 Amirhossein Alimohammadi · 与 Anthropic、DeepSeek 或 DeepInfra 无关联。

关键词:Claude Code 插件、MCP 服务、Model Context Protocol、AI 代码审查、第二意见、DeepSeek V4.1 Flash、DeepInfra、子 Agent、Opus、Agent 编码、降低 Claude Code 成本。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。