Deliberation

在 Claude Code 中从 GPT、Gemini 和 Grok 获取第二意见——通过 OpenRouter 还可使用 400 多个模型，包括 Qwen、Kimi 和 DeepSeek。七位领域专家（架构师、代码审查员、安全分析师，以及另外四位）会审查你的计划、发现错误，并辩论边缘情况，直到达成一致。

最近博客文章：认识 Deliberation：400 多个模型很容易，但知道哪些值得占有一席之地却很难。

当三个模型争论时，真正的错误就会显现。第 1 轮 = 独立的首要发现。第 2 轮 = 每个模型都抨击其他模型的选中的问题。分歧矩阵显示它们在哪里分歧；结论显示实际应该先修复什么。

什么是 Deliberation？

Claude 可以通过 MCP 向 GPT、Gemini、Grok 或任何兼容 OpenAI 的模型（通过 OpenRouter）请求帮助。该插件处理每个提供商的接线，因此你只需编写提示词。每位专家都有独特的专长，可以提供建议或实现。

你可以使用提供商的任意子集。插件会检测哪些已配置并相应路由。OpenRouter 仅提供建议且由配置驱动：模型在 ~/.config/deliberation/config.json 中声明（Windows：%APPDATA%\deliberation\config.json；使用 DELIBERATION_CONFIG 覆盖），并且无需重启 Claude Code 即可热重载。

Related MCP server: Agents Council

安装

Claude Code 插件（推荐）：

1. 添加市场 - antonbabenko/agent-plugins

/plugin marketplace add antonbabenko/agent-plugins

2. 安装插件

/plugin install deliberation@antonbabenko

3. 运行设置

/deliberation:setup

Claude 现在将复杂任务路由给你的 GPT、Gemini、Grok 和 OpenRouter 专家（Grok 和 OpenRouter 提供建议；GPT 和 Gemini 也可以实现）。

设置是一次性步骤。 MCP 服务器由插件清单注册，因此它们会自动加载并在更新中保持最新。

更新（Claude Code）

/plugin marketplace update antonbabenko  # pull the new version from the marketplace
/reload-plugins                          # reconnect the MCP servers (or just restart Claude Code)

在非 Claude 主机上更新： 通过 npx -y @antonbabenko/deliberation-mcp 运行独立服务器的主机在每次全新解析时都会获得最新发布版本。npx 会缓存已解析的包，因此如果主机提供旧版本，请清除 npx 缓存（rm -rf ~/.npm/_npx）或固定/刷新版本。

替代方案：使用 deliberation MCP 服务器（独立，适用于任何代理）

编排服务器也独立发布——npm @antonbabenko/deliberation-mcp，官方 MCP 注册表名称 io.github.antonbabenko/deliberation。

一键安装：

将此添加到你的主机的 MCP 配置中（大多数主机使用 mcpServers 键）：

{
  "mcpServers": {
    "deliberation": {
      "command": "npx",
      "args": ["-y", "@antonbabenko/deliberation-mcp"],
      "env": {
        "XAI_API_KEY": "xai-...",
        "OPENROUTER_API_KEY": "sk-or-v1-..."
      }
    }
  }
}

env 块是你在 Claude Code 之外设置提供商密钥的方式。GPT 和 Gemini 不在此处读取密钥——它们使用 codex 和 agy CLI（单独登录），因此如果你只使用 GPT/Gemini，请删除这些行。XAI_API_KEY 启用 Grok；OPENROUTER_API_KEY 启用 OpenRouter（这还需要在 ~/.config/deliberation/config.json 中声明模型——规范的 XDG 路径，Windows %APPDATA%\deliberation\config.json——或使用 DELIBERATION_CONFIG 指向其他位置）。上面的一键按钮无法携带机密——安装后请手动添加 env 块。

各主机的配置位置及其期望的键：

提供商先决条件与插件相同（参见 要求）：GPT 使用 Codex CLI，Gemini 使用 agy，Grok 使用 XAI_API_KEY，OpenRouter 使用 OPENROUTER_API_KEY 加上 ~/.config/deliberation/config.json（Windows：%APPDATA%\deliberation\config.json；使用 DELIBERATION_CONFIG 覆盖配置路径）。

公开的工具：ask-all、consensus（一次调用完成整个收敛循环，或使用 synthesizeAlways:true 进行单次综合传递）、consensus-step（自己驱动循环，每次调用一个操作）、ask-gpt / ask-gemini / ask-grok / ask-openrouter、panel + ask-one（发现活动提供商集合，然后单独调用提供商——并行发出以显示每个提供商的进度）、analyze（对调试日志和会话进行只读分析：每个模型的延迟/令牌 + 结论一致性，并附有建议性调优建议；configuredOnly 和 since 将报告限制为你仍在运行的模型和你选择的时间段）、七位专家（architect、plan-reviewer、scope-analyst、code-reviewer、security-analyst、researcher、debugger）以及会话工具（session-get / session-revisit / session-annotate）。每个结果都带有 ms 和有效的 reasoningEffort（HTTP 提供商添加令牌 usage）。可选的调试日志（"debug": { "enabled": true }）记录延迟/令牌/投票——绝不记录提示或响应。这些是服务器端的，因此它们适用于每个 MCP 主机，而不仅仅是 Claude Code（参见 AGENTS.md）。

该包还附带一个 deliberation-setup 二进制文件。使用 npx -y --package @antonbabenko/deliberation-mcp deliberation-setup 运行一次，以写入一个起始 ~/.config/deliberation/config.json（它永远不会覆盖现有的）。普通的 npx -y @antonbabenko/deliberation-mcp 形式运行默认二进制文件（服务器），这是你的 MCP 主机启动的。有关主机规则接线，请参阅 AGENTS.md 和 examples/ 中的各主机片段。

各主机的原生插件（Cursor / Codex / Kiro / OpenCode）

除了上述原始 MCP 配置之外，deliberation 还为四个主机提供了原生插件工件，使体验与 Claude Code 插件相匹配（带有角色特征的专家 + 何时委派的指导，而不仅仅是裸工具）。所有这些都由 node scripts/sync-hosts.js 从规范源生成并提交，因此它们永远不会漂移（CI 漂移测试强制执行）。每个主机都会扫描仓库以查找自己的文件：

提供商凭据与独立服务器的工作方式相同（GPT 通过 Codex CLI，Gemini 通过 agy，Grok 使用 XAI_API_KEY，OpenRouter 使用 OPENROUTER_API_KEY）——只设置你使用的提供商。MCP 服务器已经在服务端注入了每位专家角色，因此这些原生文件只是添加了主机的命令/操控层，而非重复的逻辑。

各主机的完整安装指南： docs/hosts/ - Cursor、Codex CLI、Kiro、OpenCode。

要求

你至少需要一个提供商：

• Codex CLI（GPT）：npm install -g @openai/codex，然后 codex login。

• Antigravity CLI：Antigravity CLI 入门 和 从 Gemini CLI 迁移，然后运行 agy 并登录。

• Grok (xAI)：无需安装 CLI；桥接器随插件一起提供（需要 Node 18+）。设置 XAI_API_KEY（在 https://console.x.ai 获取密钥）。

• OpenRouter：无需 CLI；桥接器随插件一起提供（需要 Node 18+）。设置 OPENROUTER_API_KEY（在 https://openrouter.ai/keys 获取密钥），然后在 ~/.config/deliberation/config.json 中声明模型（Windows：%APPDATA%\deliberation\config.json；可用 DELIBERATION_CONFIG 覆盖）。适用于任何兼容 OpenAI 的端点（Ollama、vLLM、LM Studio、HuggingFace Inference）——当密钥环境变量为空时自动跳过认证。

Windows 说明（CLI 提供商）。 在 Windows 上，npm install -g 安装的是一个 codex.cmd 存根，而不是可执行文件，Node 无法直接启动 .cmd——所以之前 GPT 调用只会失败，连一个错误都没有。deliberation 现在自行解析 CLI（通过 PATHEXT，回退到包自身的入口点），并且不通过 shell 启动。如果你的机器上解析失败，请将 CODEX_BIN（GPT）或 AGY_BIN（Gemini）指向真正的可执行文件。Grok 和 OpenRouter 不受影响——它们是 HTTP 桥接，不启动任何东西。

命令

随插件提供（安装后即可使用）：

/setup 还可以在 ~/.claude/commands/ 中安装短别名（/ask-gpt、/ask-gemini、/ask-grok、/ask-openrouter、/ask-all、/consensus）。这是可选的。默认情况下会保留已有的同名命令；setup 在覆盖其中任何一个之前会先询问。/deliberation:uninstall 只会在别名与捆绑副本完全一致（字节级相同）时移除它。

analyze 被有意排除在外：/analyze 是一个常见名称，裸拷贝会与任何其他提供该命令的插件冲突。请使用 /deliberation:analyze，它始终可用。如果之前的 setup 安装了 ~/.claude/commands/analyze.md，setup 现在会指出该路径，以便你删除它。/deliberation:uninstall 也会列出 analyze，但其字节级相同的保护只匹配当前捆绑文件——从旧版本复制的别名会有所不同，因此会被有意保留，而不是在猜测中删除。

专家角色

何时专家最有帮助

• 架构决策 - “我应该用 Redis 还是内存缓存？”

• 调试卡住时 - 两次或更多次尝试失败后，获取一个全新的视角

• 实现之前 - 在写代码之前验证计划

• 安全顾虑 - “这个认证流程安全吗？”

• 代码质量 - 对你的实现征求第二意见

何时不要使用专家

• 简单的文件操作（Claude 直接处理即可）

• 任何修复的第一次尝试（先自己试试）

• 琐碎的问题（无需委派）

使用方法

描述你的任务。Claude 会检测到何时需要专家帮助并自动委派：

You: "Is this authentication flow secure?"
Claude: routes to the Security Analyst, then synthesizes the findings.

你也可以明确要求：“让 GPT 评审这个架构”、“让 Gemini 评审……”或“让 Grok 评审……”。每位专家以只读模式运行以进行分析，或以写入权限运行以应用修复，Claude 会根据你的请求选择模式。

或者直接调用斜杠命令——见上面的命令列表。

/consensus 和 /ask-* 如何让模型保持诚实

/ask-gpt、/ask-gemini、/ask-grok 和 /ask-all 是快速命令：每个命令派发一个或三个外部模型，Claude 读取输出，你得到一个综合答案。单次调用，无循环，无同行评审轮。

/consensus 是重量级命令。同样是并行派发，但增加了同行评审轮和一个多轮循环，只有当模型达成一致时才停止。代价是：编排者（Claude）编写评审提示词、投票、决定哪些反对意见是真实的，并运行循环。如果放任不管，这种设置可能会悄悄地为自己的计划盖章放行。四个防护机制阻止了这种情况。

查看带有偏见防护和逐模型流程的详细图示

四个防护机制：

• 盲审裁决。 Claude 在发送调用专家组的那条消息之前，先发布自己的裁决（APPROVE / REQUEST CHANGES / REJECT）。这个预先承诺留在对话记录中，因此 Claude 无法在看到其他模型意见后重塑自己的观点。引擎强制执行这一点：在盲审裁决被记录之前，专家组的结果不会揭晓。

• 同行评审。 每个外部模型独立评审计划，并返回裁决以及分类的关键问题；Claude 作为仲裁者权衡它们。模型投票，Claude 裁定。

• 禁止自我批准。 只有当每个响应的外部模型都批准且至少有一个外部模型实际回答了，一轮才算收敛。Claude 自己的批准永远不能单独让一轮通过。某个提供商出错时（例如未配置的 Grok 返回 missing-auth），它会从计数中退出，而不是卡住循环。

• 禁止无声驳回。 每个被驳回或推迟的关键问题，在最终报告中都会附带一行原因，包括 Claude 撤回自己盲审反对意见的情况。引擎会拒绝没有原因就驳回问题的裁定。

/ask-* 命令带有同一规则的轻量版本。外部模型只提供建议：Claude 读取输出，运用自己的判断，并负责综合答案。当模型意见一致时，那是输入，而不是裁决。

/consensus 是核心收敛引擎（core/consensus-loop.js）之上的一个薄驱动层；循环机制——轮次计数、收敛规则、可配置的最大轮次上限、历史记录和置信度标签——都存在于引擎中，而不是命令中。每一轮：

1. 盲审裁决。 Claude 在专家组揭晓之前提交自己的裁决（对话记录可见）；引擎以此作为揭晓的门控条件。

2. 专家组评审。 GPT、Gemini、Grok（以及任何已配置的 OpenRouter 委托模型）并行评审计划，并发出 APPROVE / REQUEST CHANGES / REJECT 以及分类的关键问题。服务器解析每一条裁决。

3. 仲裁者裁定 + 修订。 Claude 协调专家组裁决与自身盲审裁决；对每个关键问题，它选择接受、驳回（需说明理由）或推迟，然后为下一轮修订计划。

当至少一个响应的外部模型批准、无模型拒绝、无剩余被接受的关键问题，且 Claude 裁定为 APPROVE 时，循环收敛——因此 Claude 不能自我批准。否则，循环在 consensus.maxRounds（默认 5，可配置）处停止，状态为 unresolved。置信度标签反映收敛速度（第 1 轮 = 高，第 2-3 轮 = 中，第 4-5 轮 = 低）。

同一引擎支撑其他宿主使用的入口点：consensus 工具（在一次调用中通过提供方仲裁者在服务端运行整个循环，或在 synthesizeAlways:true 时执行单次综合处理）和 consensus-step（自行驱动，每次调用一个动作）。分类体系和引擎契约详见 TECHNICAL.md。

早期版本运行了一个额外的"第 2 阶段"匿名同行交叉评审（每个模型盲评其他模型的答案，改编自 karpathy/llm-council）。引擎驱动的重写移除了该阶段以保持单一事实来源；它可能作为引擎功能回归。

配置

完整的设置与配置参考见 SETUP.md。涵盖：

• 专家模式 - 咨询（read-only）与实施（workspace-write），根据您的请求自动选择

• 配置文件 - 位置（~/.config/deliberation/config.json）、DELIBERATION_CONFIG 覆盖项以及热重载

• 六个配置区块 - providers、models、routing、consensus、sessions、debug - 附最小示例

• OpenRouter 模型 - 声明记录、askAll / consensus 资格、扇出、reasoningEffort 以及仲裁者选择；consensus 还配置轮次上限（maxRounds）和墙钟时间预算（maxWallMs，默认 20 分钟）

• 超时 - providers.defaults.timeout 一次性提高所有提供方的单次调用上限；providers.<name>.timeout 覆盖单个提供方，而固定模型的 models.<id>.timeout 仍然优先。被限流（HTTP 429）的调用会重试一次，并遵循上游的 Retry-After

• 调试日志 - 可选的延迟 / token / 投票追踪

• 会话持久化 - 可选的磁盘运行历史（包括宿主驱动的 /consensus 循环）以及 session-* 工具；sessions.captureText（默认关闭）额外存储提供方响应体（已脱敏）

有关提供方内部机制、环境变量和手动 MCP 设置，请参阅 TECHNICAL.md。

作者

由 Anton Babenko 维护 - LinkedIn、X/Twitter。

贡献

欢迎贡献。工作流程、提交约定和自动化发布流程请参阅 CONTRIBUTING.md。

许可证

MIT