克劳德委托者

用于 Claude Code 的 GPT 专家子代理。五位专家可分析并实施——架构、安全、代码审查等。

安装

在 Claude Code 实例中，运行以下命令：

步骤 1：添加市场

/plugin marketplace add jarrodwatts/claude-delegator

步骤 2：安装插件

/plugin install claude-delegator

步骤 3：运行设置

/claude-delegator:setup

完成！现在，Claude 会自动将复杂任务路由给 GPT 专家。

注意：需要 Codex CLI 或 Gemini CLI。设置过程会引导您完成安装。

---

什么是克劳德委托者？

通过原生 MCP，Claude 获得了一支由 GPT 和 Gemini 专家组成的团队。每位专家都有独特的专长，既可以提供建议，也可以直接实施。

注意：您可以使用 GPT 或 Gemini 中的任意一个提供商，也可以同时使用两者。插件会自动检测已配置的提供商，并相应地路由任务。

您获得的内容	为什么重要
5 位领域专家	针对每种问题类型配备合适的专家
GPT 或 Gemini	使用您偏好的模型提供商
双模式	专家可以进行分析（只读）或实施（写入）
自动路由	Claude 会根据您的请求判断何时委派
综合响应	Claude 会解读专家输出，绝不会直接传递原始结果

专家们

专家	他们的职责	示例触发条件
架构师	系统设计、权衡取舍、复杂调试	“我该如何构建这个系统？” / “有哪些权衡？”
方案评审员	在开始前验证计划	“请评审这个迁移方案” / “这种方法是否可行？”
范围分析师	提前发现模糊之处	“我还有什么遗漏吗？” / “请明确一下范围。”
代码审查员	查找错误、提升质量	“请评审这个 PR” / “这里有什么问题？”
安全分析师	漏洞检测、威胁建模	“这段代码安全吗？” / “加固这个接口。”

专家最能提供帮助的情况

• 架构决策 — “我应该使用 Redis 还是内存缓存？”
• 陷入困境的调试 — 尝试两次以上仍无法解决时，获取新的视角
• 实施前 — 在编写代码之前验证您的计划
• 安全顾虑 — “这个认证流程安全吗？”
• 代码质量 — 为您的实现寻求第二意见

不应使用专家的情况

• 简单的文件操作（Claude 可以直接处理）
• 第一次尝试修复问题（先自己试试）
• 简单的问题（无需委派）

---

工作原理

您： “这个认证流程安全吗？”
                    ↓
Claude： [检测到安全相关问题 → 选择安全分析师]
                    ↓
        ┌───────────────────────────────┐
        │  mcp__codex__codex            │
        │  (或 mcp__gemini__gemini)     │
        │  → 安全分析师提示             │
        │  → 专家分析您的代码           │
        └───────────────────────────────┘
                    ↓
Claude： “根据分析结果，我发现 3 个问题……”
        [综合响应，做出判断]

关键细节：

• 每位专家都有专门的系统提示词（位于 prompts/ 目录下）
• Claude 读取您的请求 → 选择合适的专家 → 通过 MCP（GPT 或 Gemini）委派任务
• 响应经过综合处理，而非直接传递原始结果
• 专家最多可重试三次后再上报
• 多轮对话通过 threadId 保留上下文，适用于链式任务

多轮对话

对于链式实施步骤，专家会在各轮之间保持上下文：

第 1 轮：mcp__*__* → 返回 threadId
第 2 轮：mcp__*__*-reply(threadId) → 专家记得第 1 轮的内容
第 3 轮：mcp__*__*-reply(threadId) → 专家记得第 1–2 轮的内容

对于咨询类任务，请使用单次调用（仅限 codex 或 gemini）。对于实施链条和重试任务，则应使用多轮调用。

---

配置

运行模式

每位专家都支持两种模式，具体取决于任务：

模式	沙盒环境	适用场景
咨询模式	只读	分析、建议、评审
实施模式	工作区写入	进行更改、修复问题

Claude 会根据您的请求自动选择模式。

配置默认值

您可以在 ~/.codex/config.toml 中设置全局默认值，而无需每次调用时都传递参数：

sandbox_mode = "workspace-write"
approval_policy = "on-failure"

每次调用时传递的参数会覆盖这些默认值。有关所有配置选项，请参阅 Codex CLI 文档。

手动 MCP 设置

如果 /setup 无法正常工作，您可以手动注册 MCP 服务器：

# 对于 Codex（GPT）
# 幂等性：可重复执行，安全无虞
claude mcp remove codex >/dev/null 2>&1 || true
claude mcp add --transport stdio --scope user codex -- codex -m gpt-5.3-codex mcp-server

# 对于 Gemini
# 幂等性：可重复执行，安全无虞
claude mcp remove gemini >/dev/null 2>&1 || true
claude mcp add --transport stdio --scope user gemini -- node ${CLAUDE_PLUGIN_ROOT}/server/gemini/index.js

验证方法如下：

claude mcp list
printf '{"jsonrpc":"2.0","id":"health","method":"initialize","params":{}}\n' | node ${CLAUDE_PLUGIN_ROOT}/server/gemini/index.js

自定义专家提示词

专家提示词位于 prompts/ 目录中。每个提示词都遵循相同的结构：

• 角色定义与背景信息
• 咨询模式与实施模式
• 响应格式指南
• 何时调用 / 何时不调用

您可以编辑这些提示词，以根据自己的工作流程自定义专家行为。

---

要求

您至少需要配置以下其中一个提供商：

• Codex CLI（用于 GPT）：npm install -g @openai/codex
• Gemini CLI（用于 Gemini）：npm install -g @google/gemini-cli

身份验证：

• Codex：运行 codex login
• Gemini：运行一次 gemini 并完成登录流程（或设置 GOOGLE_API_KEY）

---

命令

命令	描述
/claude-delegator:setup	配置 MCP 服务器并安装规则
/claude-delegator:uninstall	移除 MCP 配置和规则

---

故障排除

问题	解决方案
找不到 MCP 服务器	设置完成后重启 Claude Code
提供商未通过身份验证	Codex：运行 codex login。Gemini：运行一次 gemini 完成登录（或设置 GOOGLE_API_KEY）
工具未显示	运行 claude mcp list 并确认注册情况
专家未被触发	尝试明确指定：“请让 GPT 评审……”或“请让 Gemini 评审……”

---

开发

git clone https://github.com/jarrodwatts/claude-delegator
cd claude-delegator

# 在本地测试，无需重新安装
claude --plugin-dir /path/to/claude-delegator

请参阅 CONTRIBUTING.md 获取贡献指南。

---

致谢

专家提示改编自 @code-yeongyu 的 oh-my-opencode。

---

许可证

MIT — 详见 LICENSE

---

星标历史

Claude Delegator 快速上手指南

Claude Delegator 是一个为 Claude Code 设计的插件，它引入了 5 位 GPT 或 Gemini 专家子代理（Subagents）。这些专家不仅能分析架构、安全、代码质量等问题，还能直接实施修复方案。Claude 会根据你的请求自动路由任务给最合适的专家，并综合输出结果。

环境准备

在使用本工具前，请确保你的系统已安装 Node.js，并配置了以下至少一种 AI 提供商的 CLI 工具：

1. 选择并安装提供商 CLI

你可以选择使用 OpenAI 的 Codex (GPT) 或 Google 的 Gemini，也可以同时配置两者。

选项 A: 使用 GPT (推荐)

npm install -g @openai/codex
# 登录认证
codex login

选项 B: 使用 Gemini

npm install -g @google/gemini-cli
# 登录认证（运行一次完成签到流程，或设置 GOOGLE_API_KEY 环境变量）
gemini

注意：国内开发者若遇到 npm 安装缓慢问题，建议使用国内镜像源（如 npm config set registry https://registry.npmmirror.com）进行安装。

安装步骤

请在 Claude Code 实例内部执行以下命令来完成插件的安装与配置：

第一步：添加插件市场源

/plugin marketplace add jarrodwatts/claude-delegator

第二步：安装插件

/plugin install claude-delegator

第三步：运行初始化设置

/claude-delegator:setup

执行此命令后，插件会自动检测你配置的提供商（Codex 或 Gemini）并完成 MCP 服务器的注册。

基本使用

安装完成后，无需手动调用特定命令。你只需用自然语言向 Claude 提出复杂任务，它会自动判断是否需要委托给专家处理。

使用示例

场景 1：安全审计（自动调用安全分析师）

用户：这个认证流程安全吗？有没有潜在的漏洞？

系统行为：Claude 检测到安全问题，自动调用 Security Analyst 专家进行深度分析，最后综合给出修复建议。

场景 2：架构设计（自动调用架构师）

用户：我应该用 Redis 还是内存缓存？请分析权衡利弊并给出实现方案。

系统行为：Claude 调用 Architect 专家，提供系统设计方案及具体的代码实施。

场景 3：代码审查（自动调用代码审查员）

用户：帮我审查这个 PR，找出其中的 Bug 并优化代码质量。

系统行为：Claude 调用 Code Reviewer 专家，不仅指出问题，还可以直接在 workspace-write 模式下修复代码。

核心专家列表

专家角色	擅长领域	触发示例
Architect	系统设计、技术选型、复杂调试	"如何构建这个系统？"
Plan Reviewer	方案验证、迁移计划审查	"这个迁移计划可行吗？"
Scope Analyst	需求澄清、范围界定	"我遗漏了什么需求？"
Code Reviewer	Bug 查找、代码优化	"审查这段代码"
Security Analyst	漏洞扫描、威胁建模	"加固这个接口"

提示：对于简单的文件操作或琐碎问题，Claude 会直接处理而不调用专家，以保持高效。只有在遇到架构决策、调试陷入僵局或需要深度安全审查时，专家代理才会介入。