oh-my-claudecode 使用指南
notes/research/github/oh-my-claudecode-usage-guide.md
Port 8777
---
title: oh-my-claudecode 使用指南
category: research/github
source_type: github
created_by: xiaomeixia
status: archived
migrated_from: agent-notes/xiaomeixia/research/github/oh-my-claudecode-usage-guide.md
tags: []
---
# oh-my-claudecode 使用指南
## 🚀 快速开始
### 1. 安装插件
```bash
# 在 Claude Code 中执行
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
```
### 2. 初始化设置
```bash
/omc-setup
```
设置向导会自动配置：
- CLAUDE.md 文件
- HUD 状态行
- 缓存清理
---
## 📖 核心用法
### 模式 1: 需求不明确时 - Deep Interview
当你只有模糊想法，需要帮助梳理需求：
```bash
/deep-interview "我想做一个任务管理应用"
```
系统会用 Socratic 式提问帮你：
- 暴露隐藏假设
- 明确功能边界
- 衡量需求清晰度
### 模式 2: 全自动执行 - Autopilot
需求明确后，直接让系统自主完成：
```bash
autopilot: 构建一个 REST API 来管理任务
```
系统自动完成：设计 → 编码 → 测试 → 验证
### 模式 3: 团队执行 - Team
启动多 Agent 协作（推荐）：
```bash
# 5 人团队执行重构
/team 5:executor "重构后端认证模块"
# 团队会按 pipeline 执行：
# team-plan → team-prd → team-exec → team-verify → team-fix
```
### 模式 4: 持久化执行 - Ralph
适合需要持续迭代的大任务：
```bash
ralph: 重构整个 API 层
```
特点：不完成不罢休 ("The boulder never stops")
### 模式 5: 并行执行 - ULW
需要快速完成多个子任务：
```bash
ulw: 修复所有 TypeScript 错误
```
系统会并行启动多个 Agent 同时工作
---
## 🎯 常用命令速查
| 命令 | 用途 | 示例 |
|------|------|------|
| `/deep-interview` | 需求澄清 | `/deep-interview "我想做个博客系统"` |
| `autopilot:` | 全自动执行 | `autopilot: 创建用户登录功能` |
| `/team N:agent` | 团队执行 | `/team 3:executor "修复所有 bug"` |
| `ralph:` | 持久化任务 | `ralph: 优化数据库查询` |
| `ulw:` | 并行执行 | `ulw: 运行所有测试` |
| `/plan` | 交互式规划 | `/plan --consensus "设计支付系统"` |
| `/omc-teams` | 多模型编排 | `/omc-teams 2:codex "代码审查"` |
| `/ccg` | 三模型并行 | `/ccg 审查这个 PR` |
---
## 🔧 高级功能
### 多模型编排 (v4.4.0+)
```bash
# 在 tmux 中启动多个 CLI worker
/omc-teams 2:codex "审查认证模块安全性"
/omc-teams 2:gemini "重新设计 UI 组件"
/omc-teams 1:claude "实现支付流程"
# 三模型并行 (Codex + Gemini → Claude 整合)
/ccg 审查这个 PR — 架构用 Codex，UI 用 Gemini
```
### 通知系统 (v4.5.0+)
```bash
# 完成任务后发送 Telegram 通知
/omc --telegram "构建项目"
# 发送 Discord 通知
/omc --discord "部署到生产环境"
# Webhook 通知 (可集成 OpenClaw)
/omc --webhook "执行 CI/CD 流程"
```
### 模型路由说明
系统自动根据任务复杂度选择模型：
| 复杂度 | 模型 | 自动用于 |
|--------|------|----------|
| 简单 | Haiku | 查找、格式化、简单问答 |
| 标准 | Sonnet | 实现、测试、重构 |
| 复杂 | Opus | 架构设计、深度调试 |
---
## 🎭 核心哲学
### 指挥家原则 (Conductor Philosophy)
> **你是指挥家，不是演奏者**
**黄金法则**：
- ❌ 永远不要直接修改代码
- ✅ 始终委托给专业化 Agent
你的角色：
1. **指导** - 告诉系统要做什么
2. **审查** - 检查 Agent 的输出
3. **编排** - 协调多个 Agent 协作
### Agent 分工
```
Architect (架构师) → 全局视野、系统设计
↓
Executor (执行者) → 编写代码、实现功能
↓
Verifier (验证者) → 测试、证明功能正常
```
---
## 🛠️ 常见问题
### Q: 如何更新插件？
```bash
/plugin marketplace update omc
/omc-setup # 重新运行设置刷新配置
```
### Q: 如何清除缓存？
```bash
/omc-doctor
```
### Q: 团队执行失败怎么办？
检查 `~/.claude/settings.json` 是否启用了实验性团队功能：
```json
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
```
### Q: 如何查看可用 Agent 列表？
```bash
/omc-agents
```
---
## 📝 最佳实践
1. **从 Deep Interview 开始** - 需求不明确时先澄清
2. **用 Team 模式** - 复杂任务用团队执行，质量更高
3. **让 Ralph 处理大重构** - 持久化任务适合 Ralph
4. **并行用 ULW** - 需要速度时用 ULW
5. **定期清理缓存** - 用 `/omc-doctor` 保持性能
---
## 📚 更多资源
- **官方文档**: https://yeachan-heo.github.io/oh-my-claudecode-website
- **GitHub**: https://github.com/Yeachan-Heo/oh-my-claudecode
- **CLI 参考**: https://yeachan-heo.github.io/oh-my-claudecode-website/docs.html#cli-reference
---
*最后更新：2026-03-04*