FuturesDesk 集成 OMC 多智能体编排提效

背景

FuturesDesk 是一个基于 Electron + Vue 3 + TypeScript 的期货量化交易前端项目。随着项目进入功能密集开发阶段，日常工作中涉及的任务类型越来越多样：从编写组件、调试样式、修复 Bug，到撰写文档、排查依赖问题、优化构建配置。

这些任务看似独立，但在实际开发中往往需要反复切换上下文。举个例子，修改一个 ECharts 图表的自适应逻辑，可能需要同时查阅 Element Plus 文档、理解 Splitpanes 的布局机制、确认 CSS 变量的作用域。每次切换都是一次心智负担。

后来接触到了 oh-my-claudecode（简称 OMC），一个 Claude Code 的多智能体编排系统。它的核心理念很简单：让 AI 不再是一个单一的对话助手，而是一个能自动分工协作的团队。

什么是 OMC

OMC 的全称是 oh-my-claudecode，它是一个运行在 Claude Code 之上的多智能体编排层。它不是替代 Claude Code，而是在 Claude Code 的基础上增加了智能分工 和自动编排的能力。

OMC 内置了 32 个专业智能体，涵盖架构、探索、规划、执行、测试、审查、设计等角色。当你提出一个任务时，OMC 会自动判断任务的复杂度，选择合适的智能体组合来处理：

智能体类型	对应模型	适用场景
explore	Haiku	快速文件搜索、代码定位
executor	Sonnet	标准编码任务、Bug 修复
planner / architect	Opus	架构设计、复杂方案规划
verifier	Sonnet	验证执行结果是否达标
code-reviewer	Opus	代码审查、质量把关

同时，OMC 还引入了 Team 模式，可以同时 spawn 多个 Claude Code 会话作为协作队友，共享任务列表，实时通信。

为什么要装 OMC

回到具体场景。FuturesDesk 作为一个金融桌面应用，涉及的领域知识较多：期货交易术语、K 线图技术指标、WS 实时行情等。这些内容在通用 AI 模型中并非强项，需要借助上下文和工具来弥补。

在实际开发中，以下几种情况反复出现：

重复性上下文注入。每次开启新会话，都需要重新说明项目结构、技术栈、配置驱动原则。即使有 CLAUDE.md 的帮助，某些业务细节仍然需要反复提及。

任务串行等待。修改一个多文件功能时，AI 只能一步一步来，改完一个文件等反馈，再改下一个。如果多个文件的改动彼此独立，完全可以并行处理。

长上下文耗散。单会话处理复杂任务时，上下文窗口逐渐膨胀，早期的约定和决策容易被遗忘，导致后期输出质量下降。

OMC 的编排机制正好切入这些痛点：通过多智能体分工降低单会话上下文压力，通过 Team 模式实现并行开发，通过智能体路由将简单任务交给轻量模型处理、复杂任务交给更强模型。

安装过程

OMC 的安装通过 Claude Code 的插件系统完成，整体流程很顺。

第一步：添加 OMC 的 marketplace 源。

通过 Claude Code 内置的 /plugin 命令添加第三方插件市场：

复制代码

/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode

执行后系统会提示 Successfully added marketplace: omc，表示源已添加成功。

第二步：从 marketplace 安装 OMC 插件。

复制代码

/plugin install oh-my-claudecode

安装完成后，OMC 的核心文件会被下载到 ~/.claude/plugins/cache/omc/oh-my-claudecode/ 目录下。同时，插件的注册信息会被写入 installed_plugins.json，Claude Code 启动时会自动识别并加载。

第三步：运行配置向导。

复制代码

/omc-setup

配置向导会依次引导完成 CLAUDE.md 安装、HUD 状态栏配置、环境参数设置、MCP 服务器集成、Agent Teams 启用等步骤。整个过程是交互式的，按提示选择即可。

配置详解

配置环节有几个关键决策点，下面逐一说明。

安装范围选择

向导会询问安装到本地项目还是全局。选择全局安装 时，OMC 的 CLAUDE.md 会写入 ~/.claude/CLAUDE.md，所有 Claude Code 会话都能使用 OMC。选择本地安装则只在当前项目生效。

如果选择全局安装且已存在 CLAUDE.md，向导会询问是覆盖原文件还是保留原文件、仅在 omc 启动时加载。建议选覆盖，这样无论直接启动还是通过 omc 启动，都能获得完整的编排能力。

HUD 状态栏

HUD 是 OMC 的状态显示层，会在 Claude Code 的状态栏中实时显示编排信息。配置内容包括：

显示预设：minimal / focused / full，分别对应精简、默认和详细三种级别
显示元素：运行模式、上下文使用率、后台任务数、Agent 数量等
阈值设置：上下文使用率超过 70% 时变黄，超过 85% 时变红

HUD 的配置写入 ~/.claude/settings.json 的 statusLine 字段，示例如下：

json 复制代码

{
  "statusLine": {
    "type": "command",
    "command": "node C:/Users/username/.claude/hud/omc-hud.mjs"
  }
}

Agent Teams

OMC 的 Team 模式是实验性功能，需要在 settings.json 中启用：

json 复制代码

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

启用后可以使用 /team 命令 spawn 多个 Agent 协作。向导中可配置的默认值包括：

配置项	说明	推荐值
默认 Agent 数量	Team 启动时创建的队友数	3-5
默认提供商	claude / codex / gemini	claude
队友显示模式	自动 / 进程内 / 分屏窗格	自动

MCP 服务器

配置向导还提供了 MCP 服务器集成选项。MCP（Model Context Protocol）服务器可以为 AI 提供额外的工具能力。我们选择了 Context7，它可以提供零配置的文档上下文查询能力，在编写代码时自动获取相关库的文档：

复制代码

claude mcp add context7 -- npx -y @upstash/context7-mcp

OMC CLI

向导还会询问是否安装 OMC CLI 全局命令行工具。安装后可以独立使用 omc 命令查看 HUD 状态、管理工作树等：

bash 复制代码

npm install -g oh-my-claude-sisyphus

安装后验证版本：

bash 复制代码

omc --version
# 4.13.5

配置文件汇总

安装完成后，相关配置文件的位置如下：

文件路径	用途
`~/.claude/settings.json`	Claude Code 全局设置，含插件注册、HUD、Teams 配置
`~/.claude/CLAUDE.md`	OMC 的全局指令文件，定义编排规则和 Agent 目录
`~/.claude/.omc-config.json`	OMC 自身配置，含执行模式、Team 参数
`~/.claude/hud/omc-hud.mjs`	HUD 状态栏脚本
`~/.claude/plugins/cache/omc/`	OMC 插件缓存目录

如何使用

安装配置完成后，OMC 的使用方式非常自然。大部分情况下，正常向 Claude Code 描述需求即可，OMC 会自动判断是否需要编排。

以下是在 FuturesDesk 开发中常见的 OMC 使用场景：

日常编码

直接描述任务，OMC 会自动匹配合适的智能体：

复制代码

帮我实现一个期货涨跌停价格的计算工具函数

如果任务涉及多个文件或需要规划，OMC 会自动进入编排模式，调用 planner 先设计方案，再让 executor 执行。

使用魔法关键词

对于需要明确控制执行模式的场景，可以在描述中包含关键词：

关键词	作用	适用场景
`ralph`	持久模式，直到任务验证完成	重构大型模块、迁移数据逻辑
`ulw`	最大并行度	批量修复 Lint 错误、更新多处配置
`plan`	先规划再执行	新增功能模块、设计 API 接口

例如，批量修复项目中的 TypeScript 类型错误：

复制代码

ulw 修复项目中所有的 TypeScript 类型错误

Team 模式

对于大型任务，可以显式 spawn 多个 Agent 协作：

复制代码

/team 3:executor "将所有 Vue 组件的样式从 scoped 迁移到 CSS Modules"

这个命令会启动 3 个 executor Agent，共享一个任务列表，各自领取任务并行执行，完成后汇总结果。

规划访谈

当需求不够明确时，可以使用规划访谈模式，让 OMC 通过问答帮你理清思路：

复制代码

plan 实现一个自定义指标公式编辑器

OMC 会从功能范围、输入输出、UI 布局、数据流等维度进行结构化提问，形成清晰的实现方案后再开始编码。

使用效果

在 FuturesDesk 项目中使用 OMC 后，最直观的变化是多文件修改的效率明显提高。以前需要分多次会话完成的跨组件改动，现在可以在一次编排中并行完成。上下文管理的压力也减轻了，因为复杂任务被拆解到多个智能体各自处理，单个会话的上下文不会过度膨胀。

Team 模式对于批量重构类任务尤其好用。比如统一替换所有组件中的 CSS 变量引用，或者更新一批接口调用签名，3-5 个 Agent 同时开工，速度提升很明显。

HUD 状态栏也带来了额外的透明感。能看到当前有几个 Agent 在运行、上下文使用率多少、后台任务进度，对整个会话的状态一目了然。

总结

OMC 给 Claude Code 带来了多智能体编排能力，让 AI 辅助开发从"一对一对话"升级为"多角色协作"。安装和配置过程不复杂，跟随向导几步就能完成。日常使用时几乎不需要改变习惯，OMC 会自动判断何时需要编排。对于批量重构、跨文件修改、复杂方案设计等场景，Team 模式和魔法关键词提供了更精细的控制手段。

在 FuturesDesk 的持续开发中，这套编排机制预计会在提升开发效率方面发挥越来越大的作用。