Skip to main content
Glama
baiqiaw

agent-fleet

by baiqiaw

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]      │
└─────────────────────────┴──────────────────────────┘

Related MCP server: codex-bridge

安装

cd ~/projects/agent-fleet
npm install

前置要求

使用

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

Related MCP Connectors

Related MCP Servers