用途
omc-setup 是 oh-my-claudecode（OMC）的安装与配置命令。按资料描述，这是用户唯一需要学习的命令，运行后其余流程自动完成。它适用于用户希望安装、刷新或修复 OMC 本身的场景：插件市场安装用户在执行 /plugin install oh-my-claudecode 后进入此流程；npm 用户在执行 npm i -g oh-my-claude-sisyphus@latest 后进入此流程；本地开发与 worktree 用户在更新已检出仓库并重新运行 setup 后进入此流程。
主要能力
- 首次设置：无参数运行时执行交互式向导，配置 CLAUDE.md（本地或全局）、设置 HUD 状态栏、检查更新、清理已废弃的配置值（5.0.0 移除的 defaultExecutionMode）并将 MCP 注册指向 Claude Code 原生配置，同时配置团队模式默认值（智能体数量、类型、模型）。若已配置，则提供快速更新选项。
- 本地配置（--local）：通过 scripts/setup-claude-md.sh 调用插件本地协调器，shell 会在任何安装后工作前校验协调器响应及其退出状态；仅对需要变更的文件报告协调器创建的字节一致备份；用于在 OMC 升级后更新项目配置。
- 全局配置（--global）：同样通过脚本调用协调器；仅对发生变更的全局文件报告字节一致备份；默认显式覆盖 ~/.claude/CLAUDE.md，使普通 claude 命令也使用 OMC；可选 preserve 模式保留用户基础 CLAUDE.md，并将 OMC 安装到 CLAUDE-omc.md 供 omc 启动使用；适用于所有 Claude Code 会话；除非同名遗留 hook 文件的确切历史内容被独立验证，否则予以保留。
- 强制完整设置（--force）：跳过“已配置”检查，从头运行完整向导，用于重新配置偏好。
- 帮助（--help）：显示帮助文本后停止。
使用方式
命令形式为 /oh-my-claudecode:omc-setup，可附带参数：
- /oh-my-claudecode:omc-setup：首次设置（或已配置时更新 CLAUDE.md）
- /oh-my-claudecode:omc-setup --local：仅更新当前项目
- /oh-my-claudecode:omc-setup --global：更新所有项目
- /oh-my-claudecode:omc-setup --force：重新运行完整设置向导
- /oh-my-claudecode:omc-setup --help：显示帮助
设置调用方式为从运行插件环境提供的插件根目录调用脚本：
bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" <local|global> [overwrite|preserve]
该脚本是唯一的缓存解析器，只接受完整插件根目录，选择严格完整 SemVer 缓存版本，校验编译源握手，并在协调器协议或状态不一致时失败关闭。不应在此技能中独立扫描插件缓存目录或选择插件根目录，也不应在协调器之外下载配置或修改 CLAUDE.md。
流程包含预设置检查（检测是否已配置）、断点续跑检测、分阶段执行（阶段 1 安装 CLAUDE.md、阶段 2 环境配置、阶段 3 集成设置、阶段 4 完成）。阶段 2 必须将 HUD/statusLine 设置委托给 hud 技能，不得在此内联生成或修补 statusLine 路径。
适用场景
- 首次安装 OMC 后的初始化配置
- OMC 升级后更新本地或全局配置
- 需要重新配置偏好时强制重跑向导
- 安装中断后从上次进度恢复
限制与注意事项
- 所有 ~/.claude/... 路径在设置 CLAUDE_CONFIG_DIR 环境变量时遵循该变量。
- 预设置检查需要 jq；若缺少 jq，会报错并保持现有配置不变；若现有配置为无效 JSON，同样报错且不修改。
- 快速更新路径仍须执行阶段 2 步骤 2.4，以移除已废弃的 defaultExecutionMode 值，且不得写入任何替代的执行模式设置。
- 设置过程在每个阶段后通过 scripts/setup-progress.sh 保存进度，若被中断（Ctrl+C 或连接丢失）可从断点恢复。
- 资料未提供该工具的收费、价格、平台支持范围或效果数据。