agent-fleet

Claude Code + Codex 双模型协作工具。通过 MCP (Model Context Protocol) 和 tmux 实现 Claude Code 主控、Codex 执行的实时协作。

架构

┌─────────────────────────┬──────────────────────────┐
│                         │                          │
│  Claude Code            │  Codex Output            │
│  (用户交互, MCP client)  │  (实时流式日志)            │
│         │               │                          │
│         │ MCP/HTTP      │  tail -f /tmp/fleet.log  │
│         ▼               │            ▲             │
│  ┌──────────────┐       │            │             │
│  │ MCP Server   │───────┼── codex exec --json      │
│  │ (HTTP :9876) │       │            │             │
│  └──────────────┘       │            ▼             │
│                         │  [codex subprocess]      │
└─────────────────────────┴──────────────────────────┘

安装

cd ~/projects/agent-fleet
npm install

前置要求

• Node.js >= 18
• Claude Code CLI
• Codex CLI (npm install -g @openai/codex)
• tmux（可选，用于分屏）

使用

1. 启动

# 启动 MCP server + tmux 分屏
npx tsx src/cli.ts start

# 仅启动 MCP server（不用 tmux）
npx tsx src/cli.ts start --no-tmux

# 指定端口
npx tsx src/cli.ts start -p 9999

2. 配置 Claude Code

在项目的 .claude/settings.json 或全局 ~/.claude/settings.json 中添加：

{
  "mcpServers": {
    "agent-fleet": {
      "url": "http://127.0.0.1:9876/mcp",
      "type": "streamable-http"
    }
  }
}

或运行 npx tsx src/cli.ts setup 查看配置。

3. 在 Claude Code 中使用

配置完成后，Claude Code 可以使用以下 MCP 工具：

工具	说明
codex_run(prompt)	向 Codex 下发任务
codex_status()	检查 Codex 当前状态
codex_cancel()	取消正在运行的任务
fleet_info()	查看集群状态

4. 停止

npx tsx src/cli.ts stop

MCP 工具详情

codex_run

codex_run({
  prompt: "实现一个快速排序函数",
  cwd: "/path/to/project",     // 可选：工作目录
  model: "o3",                 // 可选：指定模型
  sandbox: "workspace-write"   // 可选：沙箱策略
})

返回：

{
  "taskId": "uuid",
  "output": "任务输出...",
  "exitCode": 0,
  "state": "completed"
}

开发

# 开发模式（热重载）
npm run dev

# 编译
npm run build

# 测试
npm test

# 类型检查
npx tsc --noEmit

License

MIT