🤖 OMX 多模型调度指南：Claude vs Codex

版本：v1.0 | 更新日期：2026-04-30

详解 OMX 中 Claude 与 Codex 双引擎的选择和调度策略

📐 一、架构总览

1.1 双引擎架构图

┌──────────────────────────────────────────────────────────────┐
│                    🎯 OMX 编排层                              │
│              任务调度 + 状态管理                               │
└──────────────────────────────────────────────────────────────┘
                              ↓
         ┌─────────────────────────────────────────┐
         │                                         │
         ▼                                         ▼
┌─────────────────────┐         ┌─────────────────────┐
│   🟢 Codex 引擎      │   ◄►    │   🟠 Claude 引擎     │
│                     │  协作   │                     │
│   主运行环境         │         │   外部调用           │
│   gpt-5.5           │         │   Claude CLI        │
│                     │         │                     │
│   ✅ 可修改文件       │         │   ❌ 仅只读分析       │
│   ✅ 运行测试         │         │   ✅ 外部知识库       │
│   ✅ Team 并行       │         │   ✅ 最佳实践         │
│                     │         │                     │
│   omx               │         │   omx ask claude    │
│   omx team N:agent  │         │   --agent-prompt    │
└─────────────────────┘         └─────────────────────┘
                              ↓
         ┌─────────────────────────────────────────┐
         │        🤖 Agents 层                      │
         │  executor | debugger | architect        │
         │  explore | designer | test-engineer     │
         │  (每个 Agent 可配置不同模型和推理深度)    │
         └─────────────────────────────────────────┘

⚖️ 二、核心区别对比

🎯 三、任务分流决策流程

                    用户任务输入
                         ↓
                ┌────────────────┐
                │ 🤔 是否需要修改代码？│
                └────────────────┘
                         ↓
        ┌────────────────┴────────────────┐
        │                                 │
        ▼                                 ▼
   ┌────────┐                       ┌────────┐
   │是：需要 │                       │否：只读 │
   │  修改   │                       │  分析   │
   └────────┘                       └────────┘
        │                                 │
        ▼                                 ▼
   🟢 Codex 引擎                    🟠 Claude 引擎
        │                                 │
   ┌────┴────┐                      ┌────┴────┐
   │         │                      │         │
   ▼         ▼                      ▼         ▼
单文件    多文件并行              架构分析   代码审查
executor  omx team               architect  code-reviewer

📊 场景决策表

🔧 四、Codex 引擎详解

4.1 启动方式

4.2 Agent 类型与复杂度

4.3 Team 模式详解

用户任务
    ↓
omx team N:agent "description"
    ↓
┌─────────────────────────────────────┐
│  🎯 Leader (tmux 主 pane)           │
│  - 任务分发                         │
│  - 结果整合                         │
│  - 最终验证                         │
└─────────────────────────────────────┘
    ↓ 分发
┌──────────┬──────────┬──────────┬──────────┐
│ Worker 1 │ Worker 2 │ Worker 3 │ Worker N │
│(独立     │(独立     │(独立     │(独立     │
│worktree) │worktree) │worktree) │worktree) │
│ executor │ debugger │ designer │ test-eng │
└──────────┴──────────┴──────────┴──────────┘
    ↓ 各自完成
    ↓
Leader 整合 + 验证
    ↓
omx team await / shutdown

Team 命令速查

🟠 五、Claude 引擎详解

5.1 omx ask 命令

5.2 Claude Agent 角色

🚀 六、完整工作流示例

6.1 新功能开发全流程

🔴【阶段 1】需求分析 - Claude
omx ask claude --agent-prompt=analyst "分析用户认证模块需求"

🔴【阶段 2】架构设计 - Claude
omx ask claude --agent-prompt=architect "设计认证模块架构方案"

🔴【阶段 3】方案评审 - Claude
omx ask claude --agent-prompt=critic "评审架构方案的问题"

🟢【阶段 4】并行实现 - Codex Team
omx team 3:executor "实现 auth API" "实现前端组件" "编写单元测试"

🟢【阶段 5】调试修复 - Codex
omx --agent debugger "修复测试失败"

🔴【阶段 6】代码审查 - Claude
omx ask claude --agent-prompt=code-reviewer "审查认证模块代码"

🔴【阶段 7】安全审查 - Claude
omx ask claude --agent-prompt=security-reviewer "安全审查认证流程"

🟢【阶段 8】最终验证 - Codex
omx --agent verifier "验证功能完整性"

6.2 Bug 修复流程

⚙️ 七、配置自定义 Agent 模型

7.1 编辑 Agent 配置

# 查看当前 agent 配置
cat ~/.codex/agents/executor.toml | grep model

# 编辑特定 agent
omx agents edit executor

# 添加新 agent
omx agents add my-custom-agent --scope user

7.2 Agent TOML 配置示例

# ~/.codex/agents/executor.toml

name = "executor"
description = "Code implementation, refactoring, feature work"

# 模型配置
model = "gpt-5.4"               # 可改为 gpt-5.5, gpt-5-spark 等
model_reasoning_effort = "medium"  # low | medium | high | xhigh

# 角色 posture
posture = "deep-worker"         # 执行优先姿态
model_class = "standard"        # standard | frontier

7.3 不同复杂度的模型建议

✅ 八、当前配置状态

❓ 九、常见问题

A: omx ask claude 是外部调用模式，Claude 无法访问 Codex 的文件操作工具。需要修改代码时必须使用 Codex。

A: 编辑各 Agent 的 TOML 配置文件，设置不同的 model 和 model_reasoning_effort。

A: 单文件任务用普通会话；多模块并行任务用 Team；需要外部视角分析用 Claude。

A: Claude 的外部知识库更广，适合架构评审、最佳实践参考、文档查询等需要外部视角的场景。

🎯 快速决策树

需要修改代码？
├── 是 → Codex
│   ├── 单文件 → omx --agent executor
│   ├── 多文件 → omx team N:executor
│   └── 调试 → omx --agent debugger
│
└── 否 → Claude
    ├── 架构设计 → omx ask claude --agent-prompt=architect
    ├── 代码审查 → omx ask claude --agent-prompt=code-reviewer
    ├── 外部文档 → omx ask claude --agent-prompt=researcher
    └── 设计评审 → omx ask claude --agent-prompt=critic

💡 提示：根据任务特点选择合适的引擎，充分发挥双引擎优势！