教程概述

tmux CLI Workers 是 oh-my-claudecode 的高级功能，允许你在 tmux 终端中运行 Codex、Gemini 和 Claude CLI，实现真正的多 AI 协作。

你将学到

• ✅ 为什么需要多 AI 协作
• ✅ 安装和配置 Codex/Gemini CLI
• ✅ omc team 命令详解
• ✅ 跨 AI 协作模式
• ✅ CCG 三模型合成
• ✅ 实战案例

为什么需要多 AI 协作？

各模型优势互补

flowchart TD
    subgraph "Claude"
        C1[强大的推理能力]
        C2[代码生成质量高]
        C3[上下文理解深入]
    end

    subgraph "Codex"
        O1[代码审查专家]
        O2[安全分析]
        O3[架构建议]
    end

    subgraph "Gemini"
        G1[1M token 上下文]
        G2[UI/UX 设计]
        G3[文档撰写]
    end

    style C1 fill:#e1f5ff
    style O1 fill:#e8f5e9
    style G1 fill:#fff3e0

协作价值

环境准备

安装 Gemini CLI

npm install -g @google/gemini-cli

配置 API Key：

# 设置环境变量
export GOOGLE_API_KEY="your-api-key"

# 或在首次运行时登录
gemini

安装 Codex CLI

npm install -g @openai/codex

配置 API Key：

export OPENAI_API_KEY="your-api-key"

验证安装

# 测试 Gemini
gemini --version

# 测试 Codex
codex --version

tmux 要求

确保 tmux 已正确安装：

tmux -V  # 需要 2.0+

基本用法

命令语法

omc team N:provider "task description"

Claude CLI Workers

# 启动 2 个 Claude worker
omc team 2:claude "refactor the authentication module"

Codex CLI Workers

# 启动 2 个 Codex worker 进行代码审查
omc team 2:codex "review auth module for security issues"

Gemini CLI Workers

# 启动 2 个 Gemini worker 进行 UI 设计
omc team 2:gemini "redesign UI components for accessibility"

状态监控

# 查看团队状态
omc team status <team-name>

# 关闭团队
omc team shutdown <team-name>

CLI Workers 工作原理

架构图

flowchart TD
    subgraph "Lead Session"
        L[Team Lead]
        M[Monitor]
    end

    subgraph "tmux Session"
        P1[Pane 1: Codex]
        P2[Pane 2: Gemini]
        P3[Pane 3: Claude]
    end

    L -->|创建任务| P1
    L -->|创建任务| P2
    L -->|创建任务| P3

    P1 -->|输出结果| M
    P2 -->|输出结果| M
    P3 -->|输出结果| M

    style L fill:#e1f5ff
    style P1 fill:#e8f5e9
    style P2 fill:#fff3e0
    style P3 fill:#f3e5f5

执行流程

sequenceDiagram
    participant User
    participant Lead
    participant tmux
    participant Codex
    participant Gemini

    User->>Lead: omc team 2:codex "review code"
    Lead->>tmux: 创建 tmux session
    tmux->>Codex: 启动 Pane 1
    tmux->>Codex: 启动 Pane 2
    Codex->>Lead: 输出结果到文件
    Lead->>User: 报告完成
    User->>Lead: omc team shutdown
    Lead->>tmux: 关闭 session

与 Claude Teammate 的区别

跨 AI 协作模式

模式 1：分工协作

flowchart LR
    A[任务] --> B[Codex: 架构审查]
    B --> C[Gemini: UI 设计]
    C --> D[Claude: 代码实现]
    D --> E[完成]

    style B fill:#e8f5e9
    style C fill:#fff3e0
    style D fill:#e1f5ff

示例：

# Step 1: Codex 审查架构
omc team 1:codex "review the authentication architecture"

# Step 2: Gemini 设计 UI
omc team 1:gemini "design the login form UI components"

# Step 3: Claude 实现代码
omc team 2:claude "implement the authentication flow based on reviews"

模式 2：并行验证

flowchart TD
    A[同一任务] --> B[Codex 审查]
    A --> C[Gemini 审查]
    A --> D[Claude 审查]

    B --> E[结果合成]
    C --> E
    D --> E

    E --> F[最终决策]

    style A fill:#e1f5ff
    style E fill:#fff3e0

示例：

# 三个模型同时审查
omc team 1:codex "security review of auth module" &
omc team 1:gemini "ux review of auth flow" &
omc team 1:claude "code quality review of auth module"

模式 3：专家咨询

flowchart TD
    A[复杂问题] --> B{问题类型？}
    B -->|安全| C[Codex: 安全分析]
    B -->|UI/UX| D[Gemini: 设计建议]
    B -->|实现| E[Claude: 代码方案]

    C --> F[综合建议]
    D --> F
    E --> F

    style A fill:#e1f5ff
    style F fill:#e8f5e9

CCG 三模型合成

/ccg 命令提供一键三模型合成，自动协调 Codex 和 Gemini 的输出，由 Claude 进行综合。

使用方法

/ccg Review this PR — architecture (Codex) and UI components (Gemini)

工作流程

flowchart TD
    A["/ccg task"] --> B["/ask codex"]
    A --> C["/ask gemini"]
    B --> D[Codex 输出]
    C --> E[Gemini 输出]
    D --> F[Claude 合成]
    E --> F
    F --> G[最终结果]

    style A fill:#e1f5ff
    style F fill:#fff3e0
    style G fill:#e8f5e9

合成策略

1. Codex 负责：后端架构、代码审查、安全分析
2. Gemini 负责：前端组件、UI/UX、文档
3. Claude 负责：综合决策、冲突解决、最终输出

实际案例

/ccg 设计一个用户认证系统

# Codex 输出：
# - 推荐使用 JWT + Refresh Token
# - 安全建议：使用 HTTPS, 设置 HttpOnly cookie
# - 架构建议：分离认证服务和业务服务

# Gemini 输出：
# - UI 设计：登录表单、忘记密码流程
# - 用户体验：记住登录状态、社交登录选项
# - 文档：用户手册、API 文档

# Claude 合成：
# 综合两方建议，生成完整的实现方案

实战案例

案例 1：全栈功能开发

任务：开发一个标签管理系统

步骤：

# 1. Codex 设计数据库架构
omc team 1:codex "design database schema for tag management system"

# 2. Gemini 设计 UI 组件
omc team 1:gemini "design tag selection UI component"

# 3. Claude 实现后端
omc team 2:claude "implement tag API endpoints"

# 4. Claude 实现前端
omc team 1:claude "integrate tag component into article editor"

案例 2：代码重构

任务：重构认证模块

步骤：

# 1. Codex 安全审查
omc team 1:codex "security audit of current auth implementation"

# 2. Codex 架构建议
omc team 1:codex "propose refactoring plan for auth module"

# 3. Claude 执行重构
omc team 2:claude "refactor auth module according to the plan"

案例 3：多模型验证

任务：验证 API 设计

# 同时用三个模型验证
/ccg Review the REST API design for task management

# 比较三个视角：
# - Codex: 安全性、最佳实践
# - Gemini: 文档完整性、一致性
# - Claude: 可实现性、代码质量

最佳实践

1. 选择正确的 Provider

2. 合理控制并发

# 推荐：根据资源限制
- 本地开发：最多 3 个 worker
- 云服务器：最多 5-10 个 worker

# 避免
omc team 20:codex "task"  # 太多会导致资源竞争

3. 结果文件管理

CLI Workers 的输出保存在 .omc/artifacts/：

# 查看输出
ls .omc/artifacts/

# 清理旧文件
rm -rf .omc/artifacts/*

4. 错误处理

# 如果 worker 失败
omc team status <team-name>  # 检查状态

# 强制关闭卡住的 team
omc team shutdown <team-name> --force

成本考量

月度成本估算

推荐配置：3 个 Pro 计划约 $60/月，覆盖所有需求。

成本优化策略

1. 优先使用 Claude：对于大多数任务，Claude 性价比最高
2. Codex 用于关键审查：安全相关任务值得投入
3. Gemini 用于大上下文：需要处理大量代码时使用

常见问题

Q1：CLI Workers 无法启动？

# 检查 CLI 是否安装
which codex
which gemini

# 检查 tmux
tmux -V

# 检查 API keys
echo $OPENAI_API_KEY
echo $GOOGLE_API_KEY

Q2：输出文件找不到？

# 默认位置
ls .omc/artifacts/

# 指定输出位置
omc team 1:codex "task" --output ./results/

Q3：worker 卡住不动？

# 检查 tmux session
tmux ls

# 手动进入查看
tmux attach -t <session-name>

# 强制终止
omc team shutdown <team-name> --force

小结

tmux CLI Workers 让 oh-my-claudecode 超越单模型限制：

1. 多模型协作 - Codex、Gemini、Claude 各展所长
2. 并行执行 - 多个 worker 同时处理任务
3. CCG 合成 - 一键获得三模型综合建议
4. 成本可控 - 按需选择模型，优化投入产出比

关键要点

• ✅ 根据任务类型选择正确的 provider
• ✅ 合理控制并发 worker 数量
• ✅ 使用 CCG 获取多视角建议
• ✅ 注意管理输出文件和清理资源

系列导航：

• ← 上一篇：教程 2：Team Mode 多代理协作核心编排模式
• → 下一篇：教程 4：编排模式详解
• 返回：教程系列索引