OMP 是从 Pi 分出来的一个版本，审批、计划模式、子代理、LSP、规则这些都预装好了，还会自动读 Claude Code、Codex、OpenCode 等工具的配置。代价是功能多、配置多、更新快。
上一节讲 Pi 的时候说过，它的思路是核心最小，缺什么自己加。很多人认这个思路，但不想自己一个个装扩展。
OMP（oh-my-pi）就是给这些人做的：拿 Pi 做底子，常用的东西提前装好。名字也说明了这一点，和 oh-my-zsh 之于 zsh 一样。
我推荐先用 OMP。用几个月，想自己捣鼓 Agent 了，再去用 Pi。
一、OMP 是什么
OMP 由 Can Bölük 开发，现在由 Stencil Labs 维护，开源（MIT 协议），命令是 omp。它从 Pi 分出来（fork），之后按编程优先的方向做了大量改写。
和 Pi 放在一起看：
| Pi | OMP | |
|---|---|---|
| 思路 | 核心最小，缺什么自己加 | 全家桶，常用的都装好 |
| 内置工具 | 4 个（另有 3 个可选） | 几十个：LSP、调试器、浏览器、子代理、待办、联网搜索…… |
| 审批 | 没有 | 有，三档可选，但默认也是全放行 |
| 计划模式、子代理 | 要装示例扩展 | 内置 |
| 读别的工具的配置 | AGENTS.md、CLAUDE.md、.agents/skills/ |
几乎全读：.claude/、.codex/、.opencode/、.cursor/…… |
| 运行环境 | Node.js | Bun |
| 配置目录 | ~/.pi/agent/、.pi/ |
~/.omp/agent/、.omp/ |
有几个设计是 OMP 独有的，进阶部分细讲：
- 模型角色：日常用便宜快的模型，做计划、深度推理时自动换成强模型
- 按需出现的规则（TTSR）：规则平时不占上下文，模型一写出违规的代码就被打断、注入规则、重来
- Hashline 编辑：每一行带一个短哈希做定位，文件被改过就拒绝修改，而不是改错位置
- 改完就跑 LSP：写完文件马上拿到类型错误、语法错误
二、安装与接模型
1. 安装
# macOS / Linux，官方安装脚本
curl -fsSL https://omp.sh/install | sh
# Homebrew
brew install can1357/tap/omp
# 或者用 Bun（需要 Bun 1.3.14 以上）
bun install -g @oh-my-pi/pi-coding-agent
# Windows（PowerShell）
irm https://omp.sh/install.ps1 | iex⚠️ OMP 跑在 Bun 上，不是 Node.js。npm 上虽然也能搜到这个包，但它要求 Bun，别用
npm install -g装。
2. 接入 DeepSeek
DeepSeek 也是 OMP 的内置服务商，设好环境变量就行：
export DEEPSEEK_API_KEY="sk-你的key"不进界面就能确认：
omp models deepseek
OMP 的模型列表比 Pi 多两个（deepseek-v4-flash 和带视觉的实验版）。thinking 一列是这个模型支持的思考深度档位。
3. 第一次启动：五步设置向导
cd your-project
omp第一次运行会进入设置向导，一共五步。
第 1 步：登录服务商。搜 deepseek，能看到它已经是登录状态，后面写着是从哪个环境变量读到的：
已经设了环境变量的话，这一步直接按 Esc 跳过。
第 2 步：选默认模型。向导默认选中的是 deepseek-v4-pro。输入 deepseek-flash 过滤，选中后按回车：
最下面一行是选中模型的信息：上下文、最大输出、每百万 token 的价格、是否支持推理和看图。这一步选的是 OMP 的 default 角色。计划、子代理这些活可以各自指定模型，进阶部分会讲。
后面三步是图标样式、输入框样式、配色主题，选自己看着舒服的就行，都能在 /settings 里改。以后想重新走一遍向导，输入 /setup。
4. 认识界面
输入框上方的状态栏，从左到右：
- DeepSeek V4.1 Flash 1017：当前模型
- ~/order-admin、main ?4：目录、Git 分支，
?4表示有 4 个未跟踪的文件 - $0.00：这次会话花了多少钱
- 0.8% ……… 1M：上下文用量和上限
- 右下 ⇧⇥ to change thinking effort：
Shift+Tab切思考深度。Pi 里这个键也是切思考深度，不是切权限模式
上面那行 Connected to MCP server: context7 是我已经配好的 MCP，后面讲
三、概念对照表
| 概念 | Claude Code（第一本） | Pi | OMP |
|---|---|---|---|
| 项目说明 | CLAUDE.md |
AGENTS.md 或 CLAUDE.md |
AGENTS.md、CLAUDE.md，还有 Cursor、Copilot 等工具的规则文件 |
| Skills | .claude/skills/ |
.pi/skills/、.agents/skills/ |
.omp/skills/、.agents/skills/、.claude/skills/、.codex/skills/…… |
| 手动调用 Skill | /skill名 |
/skill:skill名 |
/skill:skill名 |
| 斜杠指令 | Skill | .pi/prompts/ |
.omp/commands/，也读 .claude/commands/、.opencode/commands/ |
| MCP | claude mcp add |
mcp.json |
mcp.json，也读 .mcp.json、Cursor、Codex 的 MCP 配置 |
| 权限 | allow / ask / deny |
没有 | 三档审批 + 命令规则，默认全放行 |
| 计划模式 | 一种权限模式 | 示例扩展 | 内置 /plan，自动换成计划用的模型 |
| 子代理 | .claude/agents/ |
示例扩展 | 内置 6 个，自定义放 .omp/agents/ |
| Hooks | settings.json 里的 shell 脚本 |
扩展（TypeScript） | .omp/hooks/pre/（TypeScript，写法同 Pi） |
Shift+Tab |
切权限模式 | 切思考深度 | 切思考深度 |
| 回退 | /rewind，能改回文件 |
/tree，只回退对话 |
/branch（别名 /rewind）、/tree |
| 看加载了什么 | 各种指令分开看 | 启动画面顶部 | /extensions 控制中心 |
输入 / 能看到所有指令，OMP 的指令比前面几个工具都多：
这只是第一屏，往下翻还有 extensions、mcp、agents、git 等几十个。
四、入门：15 分钟跑通一个工作流
还是 order-admin 项目。项目里已经攒了好几个工具的配置：.agents/、.codex/、.opencode/、.pi/。OMP 能直接用上其中很多。
1. AGENTS.md
项目里的 AGENTS.md、CLAUDE.md，OMP 都直接读。
想确认读到了什么，输入 /extensions，打开扩展控制中心。它把从各处发现的 Skill、指令、规则、MCP、项目说明全列出来，每一项都标着来源文件：
右边这个 weekly-report 是灰的，原因写着 ~/ config not enabled。OMP 有一条规矩：别的工具放在用户目录下的配置（比如 ~/.claude/）默认不读，要你自己打开。进阶第 1 节讲怎么开。
2. 先把审批打开
OMP 默认也是全放行，和 Pi 一样，改文件、跑命令都不问。区别是它内置了审批，改个配置就能打开。