oh-my-claudecode 快速上手指南从插件安装到首个 Autopilot 会话与深度配置【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecodeOh My ClaudeCode简称 OMC是一套运行在 Claude Code 之上的团队优先多智能体编排框架无需记忆命令语法只要用自然语言描述目标它便会调度 19 个各司其职的专项 Agent按流水线自动完成从需求分析、规划、编码、QA 到最终验证的完整闭环。本篇以官方快速入门文档docs/GETTING-STARTED.md为核心骨架结合仓库源码逐步讲解如何完成插件与 CLI 双面安装、如何用一条命令启动你的首个 Autopilot 会话、以及如何通过全局/项目两级 JSONC 配置定制 Agent 模型与魔法关键词让你能真正上手并把 OMC 调教成贴合自己项目的方式运行。前置条件与整体概览在开始安装前请先确认环境满足以下最低要求源自 README.md项目要求Claude Code必须已安装官方 Claude Code CLI认证方式Claude Max/Pro 订阅或配置ANTHROPIC_API_KEY环境变量此外若希望使用omc teamtmux 终端 Worker与限流自动恢复等功能还需要 tmuxmacOS 用brew install tmuxDebian/Ubuntu 用sudo apt install tmux。OMC 提供两条并存、互补的接入面接入面提供能力推荐安装方式Claude Code 插件oh-my-claudecodeomc会话内 skills、agents、hooks、statuslineHUD、MCP server以及/autopilot、/ralph、/execute、/team等斜杠命令Marketplace 插件安装下文 Step 1–2终端 CLIomc二进制npm 包oh-my-claude-sisyphusShell 命令omc setup、omc update、omc team、omc ask以及已硬废弃的omc autoresearchshimnpm i -g oh-my-claude-sisyphuslatest重要命名提示项目仓库、插件与命令统一品牌为oh-my-claudecode但发布到 npm 的包名是oh-my-claude-sisyphus。通过 npm/bun 安装或升级 CLI 时务必使用oh-my-claude-sisyphuslatest该包同时安装oh-my-claudecode与简写omc两个命令别名。详见 README.md 中 Package naming 说明。绝大多数用户会同时安装两者插件负责会话内体验npm CLI 负责 Shell 侧自动化与升级。二者并行运行完全受支持——omc update与omc setup均幂等并且能自动检测插件安装避免在~/.claude/skills/下重复注册 skills对应 issue #2252。入门文档特别指出旧版文档曾声称 OMC 仅插件这是不准确的omcCLI 才是omc setup/omc update的规范入口两种路径的对照可参见 README.md#quick-start。安装三步从零到可用安装分三个主要步骤请严格按顺序执行。第一步与第二步都是在 Claude Code 会话内输入的斜杠命令README 提示两条命令必须逐条输入一次性粘贴两行会失败。Step 1添加 Marketplace 源在 Claude Code 内执行/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecodeStep 2安装插件/plugin install oh-my-claudecodeStep 2b可选但推荐安装终端 CLI如果你希望在 Shell 中使用omc setup、omc update、omc team、omc ask等命令npm i -g oh-my-claude-sisyphuslatest已知 npm 警告安装 CLI 时 npm 可能打印deprecated prebuild-install7.1.3。该警告来自上游原生依赖better-sqlite3 - prebuild-installprebuild-install7.1.3仍是当前最新发布版本仓库侧暂无安全的依赖升级或 override 可消除它。该警告正在 issue #2913 中跟踪它本身不代表 OMC CLI 安装失败。两条安装路径可以同时进行。CLI 会自动检测插件安装不会在~/.claude/skills/下重复注册 skills——若你此前曾遇到重复 skill 问题在 4.11.2 上运行一次omc update即可自愈它会通过prunePluginDuplicateSkills清理插件现已提供的遗留独立 skills。Step 3运行初始设置安装完成后在 Claude Code 中输入以下任一命令# 方式一自然语言 setup omc # 方式二skill 命令 /oh-my-claudecode:omc-setupomc-setupskill 的目标是一条命令解决全部配置。从 skills/omc-setup/SKILL.md 可看到其内部实现细节它会检查~/.claude/.omc-config.json尊重CLAUDE_CONFIG_DIR判断是否已配置、支持--help/--local/--global/--force四种旗标、通过scripts/setup-progress.sh保存阶段进度以支持中断后续跑并依次执行四个阶段安装 CLAUDE.md → 环境配置 → 集成配置 → 完成引导。该 skill 的完整 Help 文本还说明无旗标首次运行会进入交互式向导若已配置则会询问更新 CLAUDE.md / 完整重跑 / 取消三选一避免每次升级都重跑整个向导。选择设置作用域项目级设置推荐——只影响当前项目/oh-my-claudecode:omc-setup --local设置写入./.claude/CLAUDE.md不影响其他项目已有的全局CLAUDE.md被保留全局设置——作用于所有 Claude Code 会话/oh-my-claudecode:omc-setup设置写入~/.claude/CLAUDE.md应用于所有项目⚠️警告全局设置现在会先明确询问是否修改你的基础~/.claude/CLAUDE.md默认选择仍是覆盖。如果你选择保留preserve模式则普通claude继续使用你的基础配置而omc会强制加载 OMC companion 配置即写入CLAUDE-omc.md供omc启动使用。验证安装omc-doctor用诊断工具确认一切正常/oh-my-claudecode:omc-doctor它会依次检查依赖安装状态配置文件错误Hook 安装状态Agent 可用性Skill 注册状态从本地代码库运行如果你正在开发 OMC 或想测试某个分支上的未发布特性可以让 Claude Code 直接以本地 checkout 作为插件启动omc --plugin-dir /path/to/oh-my-claudecode setup --plugin-dir-mode这样 agents、skills、commands 会直接从你的 checkout 加载而不会被拷贝到~/.claude/。详细流程见 docs/LOCAL_PLUGIN_INSTALL.mdplugin-dir 旗标与模式的完整决策矩阵见 docs/REFERENCE.md#plugin-directory-flags。对应的仓库钩子脚本也印证了这一设计——如 scripts/setup-claude-md.sh 是 CLAUDE.md 配置协调器的唯一入口。平台支持平台安装方式Hook 类型macOSClaude Code PluginBash (.sh)LinuxClaude Code PluginBash (.sh)Windows推荐 WSL2Node.js (.mjs)ℹ️注意原生 Windows 支持目前处于实验阶段。对于基于 tmux 的 Team WorkerOMC 会先检测是否存在 tmux 兼容二进制PowerShell 7 用户可使用原生 [psmux]以便在交互式团队工作流中看到可见的 Claude Code teammate 窗格当没有兼容 tmux 或原生 Windows 行为不足时WSL2 仍作为兜底。psmux 不会强制 worktree 代理、非交互/print 模式代理或模型选中的进程内代理进入可见窗格。更新与卸载OMC 每 24 小时自动检查更新手动更新只需重跑插件安装命令。⚠️警告插件更新后请再次运行/oh-my-claudecode:omc-setup以应用最新配置。卸载插件/plugin uninstall oh-my-claudecodeoh-my-claudecode首个会话一条命令跑完整开发流水线安装完成后打开 Claude Code 直接输入autopilot build me a hello world app这一行就足以让 OMC 自动运行完整的开发流水线。关键词如何被触发autopilot是一个魔法关键词。从源码 src/hooks/keyword-detector/index.ts 可以看到OMC 通过一组带优先级的正则表达式做意图识别如autopilot会匹配\b(autopilot|auto[\s-]?pilot|fullsend|full\sauto)\b甚至支持build me a ...、i want an ...这类自然语言短语还覆盖韩文오토파일럿与日文オートパイロット。ultrathink、deepsearch等关键词同样在此注册对应优先级 11、12。检测到autopilot后即会启动下面 5 个阶段的流水线。五阶段流水线内部发生了什么Stage 1Expansion需求展开analyst与architect两个 Agent 分析想法、澄清需求并产出技术规格。二者在仓库默认配置中均固定为 opus 档模型承担高层推理职责。Stage 2Planning规划plannerAgent 创建执行计划criticAgent 审查计划并找出缺口。这一规划 批判的组合保证计划在上手编码前已被推敲过一轮。Stage 3Execution执行executorAgent 编写代码需要时多个 Agent 并行工作。Stage 4QA质量验证验证构建成功且测试通过自动修复失败并重新验证。Stage 5Validation最终验收专项 Agent 对功能、安全与代码质量做最终审查全部通过后任务才算完成——这也呼应了 OMC 不会放弃直到任务被验证完成的持久执行理念。用 HUD 观察流水线状态工作进行中可以通过 Claude Code 状态栏HUD监控当前状态例如[OMC] autopilot:execution | agents:3 | todos:2/5 | ctx:45%字段含义autopilot:execution当前位于 autopilot 流水线的哪个阶段agents:3当前活跃 Agent 数量todos:2/5已完成任务数 / 总任务数ctx:45%上下文窗口占用百分比如需配置 HUD 显示运行/oh-my-claudecode:hud setup从小任务起步如果 autopilot 显得太大可以先从单任务命令入手。这些关键词会直接唤起单一合适 Agent而不跑完整流水线# 代码分析 analyze why this test is failing # 文件搜索 deepsearch for files that handle authentication # 简单实现 ultrawork add a health check endpoint其中deepsearch在 src/hooks/keyword-detector/index.ts 中匹配\bsearch\sthe\scodebase\b、\bfind\sin\s(the\s)?codebase\b等模式将请求路由到 codebase 搜索方向。下一步继续阅读下面的[配置章节]掌握模型与特性定制docs/ARCHITECTURE.md 理解 agents、skills、hooks 之间的关系配置两级文件与合并优先级OMC 支持两级配置文件作用域文件路径用途用户全局~/.config/claude-omc/config.jsonc应用于所有项目项目.claude/omc.jsonc仅应用于当前项目⚠️警告配置文件格式为 JSONC支持注释的 JSON不是TypeScript 配置文件不是omc.config.ts。配置合并优先级当多个来源都存在设置时按下述顺序合并越靠后优先级越高Defaults → User config (~/.config/claude-omc/config.jsonc) → Project config (.claude/omc.jsonc) → Environment variables也就是说默认值 用户全局配置 项目配置 环境变量。config 加载器位于 src/config/loader.ts其测试用例见 src/config/tests/loader.test.ts。基本配置结构{ // 每个 Agent 的模型分配 agents: { explore: { model: haiku }, executor: { model: sonnet }, architect: { model: opus } }, // 特性开关 features: { parallelExecution: true, lspTools: true, astTools: true }, // 魔法关键词定制 magicKeywords: { ultrawork: [ultrawork, ulw, uw], search: [search, find, locate], analyze: [analyze, investigate, examine], ultrathink: [ultrathink, think, reason] }, // 可选的企业级 company context 契约 companyContext: { tool: mcp__vendor__get_company_context, onError: warn } }通过 MCP 注入公司上下文companyContext如果企业通过自定义 MCP server 暴露内部规范安全指引、术语表、评审清单等可在标准配置文件里指定所用工具{ companyContext: { tool: mcp__vendor__get_company_context, onError: warn } }MCP server 本身仍通过常规 Claude/OMC MCP 配置流程注册tool是完整 MCP 工具名如mcp__vendor__get_company_contextonError控制 prompt 级回退策略warn默认、silent或fail这是一份提示层面的咨询性工作流契约而非运行时强制。完整契约定义在 docs/company-context-interface.md该契约要求 vendor 只实现一个工具get_company_context输入{ query: string }输出{ context: string }并且明确context仅具参考性——返回的 markdown 应被当作引用的建议数据而非可执行指令不得试图覆盖系统提示或冒充策略执行。覆盖各 Agent 的默认模型你可以按需替换每个 Agent 使用的 AI 模型{ agents: { // 把 explore 升级为更强模型 explore: { model: sonnet }, // 复杂项目把 executor 升到 opus executor: { model: opus }, // 写文档用 haiku 省钱 writer: { model: haiku } } }默认模型映射入门文档给出了完整的默认映射表它也与仓库源码高度一致——在 src/agents/definitions.ts 中每个 Agent 定义都显式声明model与defaultModel如debugger/verifier/test-engineer/security-reviewer为sonnetcode-reviewer/code-simplifier为opusAgent默认模型职责explorehaiku代码库探索writerhaiku编写文档executorsonnet编码实现debuggersonnet调试排障designersonnetUI/UX 设计verifiersonnet验证tracersonnet循证的因果追踪security-reviewersonnet安全漏洞与信任边界test-engineersonnet测试策略与覆盖率qa-testersonnet交互式 CLI/服务运行时验证scientistsonnet数据与统计分析git-mastersonnetGit 操作与历史管理document-specialistsonnet外部文档与 API 参考检索architectopus系统设计planneropus战略规划criticopus计划审查analystopus需求分析code-revieweropus全面代码评审code-simplifieropus代码清晰化与简化整体设计思路很清晰轻量任务探索、写作用 haiku 控制成本标准实现执行、测试、调试用 sonnet需要深度推理的角色架构、规划、批判、评审用 opus。定制魔法关键词通过config.jsonc的magicKeywords段可定制四类关键词{ magicKeywords: { // 触发并行执行模式 ultrawork: [ultrawork, ulw, parallel], // 触发代码库搜索模式 search: [search, find, locate, grep], // 触发分析模式 analyze: [analyze, debug, investigate], // 触发深度推理模式 ultrathink: [ultrathink, think, reason] } }ℹ️注意magicKeywords段只允许定制上述四类ultrawork、search、analyze、ultrathink。像autopilot、ralph、ccg这类关键词是硬编码在 keyword-detector hook 中的无法通过配置文件修改源码参见 src/hooks/keyword-detector/index.ts其中ralph优先级 2、autopilot优先级 3并有team 优先于 autopilot的互斥逻辑。模型路由配置OMC 会根据任务复杂度自动选择模型档位{ routing: { enabled: true, defaultTier: MEDIUM, // 强制所有 Agent 继承父会话模型 // 使用 CC Switch、Bedrock 或 Vertex AI 时自动激活 forceInherit: false } }档位模型适用场景LOWhaiku快速查询、简单任务MEDIUMsonnet标准实现、一般任务HIGHopus架构设计、深度分析—fableClaude Fable 5高于 Opus凡接受档位别名之处均可使用会话模型 vs 委派 AgentFable 及其他模型需要澄清一个重要概念通过/model选择的模型只作用于主对话循环。委派 Agentplanner、architect、executor 及目录中的其他成员运行在各自 Agent 定义里固定的档位——opus、sonnet或haiku——与会话模型无关。原因在源码层面很清晰OMC 的 hooks 无法观察到/model选择只能看到 provider 环境变量因此在标准 Anthropic 认证下会话族继承不会自动发生。要让委派工作运行在别的模型上OMC 生产环境PreToolUseenforcer 认可三种方式逐次调用Per-call在Task/Agent调用中显式传model如model: fable显式模型始终被保留。单 Agent 覆盖Per-agent overrideagents: { planner: { model: fable } }—— 精确作用于单个 Agent解析后的档位别名会自动注入 Task 调用。全部继承Everything inheritsrouting: { forceInherit: true }—— 完全丢弃逐 Agent 路由核选项在 Bedrock/Vertex/proxy 上为兼容性自动开启。ℹ️ 补充routing.modelAliases/OMC_MODEL_ALIAS_OPUSfable会把某档位在所有固定位置重映射例如每个 opus Agent 都解析为 Fable而 haiku/sonnet 固定不受影响。SDK 侧enforceModelAPI 支持它但插件 hook 路径不会将其应用于Task/Agent调用因此在 Claude Code 插件会话中优先使用上面的 per-call 或 per-agent 方式。CLAUDE.md 配置OMC 的默认行为也通过CLAUDE.md文件配置。运行/oh-my-claudecode:omc-setup会自动生成该文件。作用域文件描述全局~/.claude/CLAUDE.md跨项目共享设置项目.claude/CLAUDE.md项目级上下文与覆盖从 skills/omc-setup/SKILL.md 的 Help 文本可看到setup 内部通过scripts/setup-claude-md.sh调用 plugin-local coordinator 来写入 CLAUDE.md脚本会校验 coordinator 响应及退出码、只为需要变更的文件创建字节级一致的备份并采用严格的完整 SemVer 缓存版本、编译产物握手校验fail-closed 处理协议不一致。何时需要重跑 setup初始安装之后OMC 更新之后以应用最新配置切换到另一台机器时启动新项目时使用--local选项关键实现依据速查若要深入验证本文所述行为仓库中值得研读的入口包括关键词检测与优先级编排src/hooks/keyword-detector/index.ts各 Agent 的默认模型声明src/agents/definitions.tssetup skill 的完整旗标与四阶段流程skills/omc-setup/SKILL.md 及 skills/omc-setup/phases/01-install-claude-md.md配置加载实现src/config/loader.ts公司上下文契约完整定义docs/company-context-interface.md插件本地安装与 plugin-dir 决策docs/LOCAL_PLUGIN_INSTALL.md、docs/REFERENCE.md#plugin-directory-flags整体架构关系docs/ARCHITECTURE.md掌握安装、首个 Autopilot 会话与两级 JSONC 配置这三步你便已具备把 OMC 投入日常开发的基本能力在此基础上结合 README 与 REFERENCE 中的/team团队编排、omc ask多模型顾问、持久执行等进阶能力可以逐步把多智能体工作流打磨成适合自己团队的标准流水线。【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
