Claude Code 太全能？试试只用 4 个工具的 pi，再配个全家桶 oh-my-pi

先说结论如果你用腻了什么功能都往里塞的 AI 编程工具可以试试pi——它默认只给模型 4 个工具read、write、edit、bash别的一概不带想用什么自己装。如果你想要装完就干活、不再做选择题的体验可以试试它的分叉版oh-my-pi命令叫 omp——31 个内置工具、子代理、代码评审、调试器全部内置。两者可以装在同一台电脑上互不干扰本文给出 Windows 11、Ubuntu 26.04、macOS 26 三平台的一键安装脚本以及自己动手装和让 Agent 帮你装两种玩法。本文写作与截图时间为 2026 年 8 月下旬文中所有命令都在真实机器上执行过示例已做抽象处理不包含任何真实 IP、机器名与密钥。一、为什么又冒出来两个新工具1.1 背景AI 编程工具越来越像大而全的 IDE这两年终端里的 AI 编程助手Coding Agent越来越多但不少工具走着走着就变成了另一个 IDE功能列表越来越长弹窗确认越来越多配置文件越来越厚。对喜欢折腾的开发者来说这种感觉就像去买一把螺丝刀结果被塞了一套 128 件的家用工具箱——能干活但你真正想用的只有那一把。pi 的作者 Mario Zechner网名 badlogic做游戏开发框架 libGDX 的那位的想法正好反过来只给模型最小的内核剩下的一切都让用户自己拼装。这就是 pi。而 oh-my-pi 的作者 Can Bölükcan1357则把 pi 拿过去做了分叉fork走向另一个极端把大家常用的功能全部内置进去口号大概是你喜欢的 pi加上全家桶。它的命令叫omp。1.2 一句话理解两者的关系打个比方pi 像一把瑞士军刀的刀柄——出厂只有刀柄本身刀片、剪刀、开瓶器想装哪个自己挑不装就永远不多出来。oh-my-pi 则像买回家就配好的工具箱——锤子、电钻、水平仪都在里面打开就能用不用自己逛五金店。这两个项目都是开源的MIT 协议配置目录互不冲突一个在~/.pi/agent一个在~/.omp/agent完全可以装在同一台机器上按心情换着用。二、pi极简到只有 4 个工具的 Coding Agent2.1 pi 是什么pi 是一个跑在终端里的 AI 编程助手。它最大的特点是克制默认只给模型 4 个工具——读文件、写文件、改文件、执行命令。没有内置的 MCP、没有子代理、没有计划模式、没有权限弹窗。那缺的功能怎么办pi 给出的答案是四种扩展机制相当于给刀柄装刀片Extensions扩展用 TypeScript 写的插件可以加新工具、新命令、新界面。Skills技能符合 Agent Skills 标准的 Markdown 说明书教模型做某类事。Prompt Templates提示词模板把常用的提示词存成模板随用随取。Themes主题换界面配色。这些扩展可以打包成 “Pi Packages”通过 npm 或 GitHub 分享给别人。装好扩展后甚至能在终端里跑起 Doom 游戏——官方 README 里就有这个演示目的是告诉你扩展系统能做的事情远超想象。2.2 pi 的几个好用的细节会话是一棵树pi 把每次会话保存成 JSONL 文件支持分支。聊到一半想回到之前某个节点换个思路用/tree命令就能看到整棵会话树跳到任意分支继续聊像 Git 分支一样。30 多家模型服务商OpenAI、Anthropic、Gemini、DeepSeek、Kimi、OpenRouter 都支持也支持本地跑的 llama.cpp用/login登录即可。编辑器小抄输入可以模糊搜索并引用文件输入!命令可以把命令的输出发给模型看CtrlV直接粘贴截图。2.3 安装 pipi 基于 Node.js先确保有 Node 20 以上版本然后任选一种方式# 方式一npm 全局安装本文写作时验证通过版本 0.74.2npminstall-g--ignore-scripts earendil-works/pi-coding-agent# 方式二官方安装脚本curl-fsSLhttps://pi.dev/install.sh|sh装完后先配一个 API Key比如exportANTHROPIC_API_KEY你的密钥pi# 进入交互界面小提示pi 的 GitHub 仓库已经从badlogic/pi-mono搬家到earendil-works/pinpm 包名也换成了earendil-works/*。网上一些旧教程里的mariozechner/*包名暂时还能用但建议直接用新名字。三、oh-my-pi (omp)把能装的都装好3.1 omp 是什么omp 是 pi 的全家桶分叉版。如果说 pi 的哲学是缺什么自己装omp 的哲学就是先都给你装上用不上再说。它内置了 31 个工具挑几个最实用的说子代理task可以让 omp 同时派出多个分身并行干活比如一个分析目录结构、一个读代码、一个跑测试各自在隔离的工作区里跑互不打扰。LSP 与调试器内置了语言服务器就是 VS Code 里跳转到定义背后的技术和 DAP 调试器模型可以像 IDE 一样理解代码结构、打断点调试。代码评审/review一键让 omp 评审某个提交问题按 P0 到 P3 分级P0 最严重。模型角色分工可以给不同任务配不同模型——写代码用贵的干杂活用便宜的省钱。3.2 Hashline 编辑这篇文章里最值得知道的巧思omp 里有一个原创设计叫Hashline 编辑值得单独讲讲因为它解决了一个真实痛点。先打个比方理解痛点传统 AI 编辑文件的方式像让小学生改作文时必须把整段原文一字不差地重抄一遍再写上改后的版本。原文越长抄错的概率越高模型能力稍弱一点抄错一个字整个修改就失败了。Hashline 的做法是工具先给文件每一行算一个门牌号哈希值。模型想改哪一行只要说把 3 号门牌那行换成这句新内容不用重抄原文。相当于把背诵默写题变成了看图填号题。官方 README 给出的实测数据Grok Code Fast 1 的编辑通过率从6.7% 提升到 68.3%Grok 4 Fast 的输出 token 减少61%。对于用小模型或本地模型的人来说这个功能能明显减少改来改去改不对的挫败感。3.3 安装 ompomp 基于 bun 运行时官方推荐的安装方式# 方式一bun 全局安装官方推荐buninstall-goh-my-pi/pi-coding-agent# 方式二官方安装脚本macOS / Linuxcurl-fsSLhttps://omp.sh/install|sh# 方式三macOS 用 Homebrewbrewinstallcan1357/tap/omp# 方式四Windows 用 PowerShellirm https://omp.sh/install.ps1|iex装完跑omp setup会进入交互式向导一步步帮你选模型。omp 还会自动读取你已有的.claude、.cursor、.codex目录里的规则配置从别的工具搬家过来几乎零成本。四、一张表看清差异30 秒决定装哪个看完速查表还拿不定主意回答下面 5 个问题我的建议如果你对工具替我做决定这件事敏感从 pi 开始如果你今天就要用 AI 干活、不想研究生态直接装 omp。反正两者不冲突各玩三天再留一个也不迟。五、一键全自动安装脚本三平台下面三套脚本分别覆盖 Windows 11、Ubuntu 26.04、macOS 26只依赖官方源不依赖任何第三方镜像服务。每个脚本都干同样四件事装运行时 → 装 pi → 装 omp → 验证版本。脚本里的包名和下载地址都来自官方 README。5.1 Windows 11PowerShell管理员窗口运行#Requires -RunAsAdministratorSet-StrictMode-Version Latest$ErrorActionPreferenceStop# 1. 装 Node.js 与 Gitwinget 为 Windows 11 自带winget install-e--id OpenJS.NodeJS.LTS--accept-source-agreements--accept-package-agreements winget install-e--id Git.Git--accept-source-agreements--accept-package-agreements# 2. 装 pinpm 是 Node.js 自带无需第三方服务npm install-g--ignore-scripts earendil-works/pi-coding-agent# 3. 装 omp官方 PowerShell 脚本irmhttps://omp.sh/install.ps1|iex# 4. 验证pi--version omp--versionWrite-Host全部安装完成。运行 pi 或 omp 开始先 /login 配置模型。5.2 Ubuntu 26.04Bash#!/usr/bin/env bashset-euopipefail# 1. 装 Node.js 22NodeSource 官方仓库与基础工具sudoapt-getupdatesudoapt-getinstall-ycurlca-certificates gnupgcurl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoapt-getinstall-ynodejs# 2. 装 pisudonpminstall-g--ignore-scripts earendil-works/pi-coding-agent# 3. 装 bun 与 ompcurl-fsSLhttps://bun.sh/install|bashexportBUN_INSTALL$HOME/.bunexportPATH$BUN_INSTALL/bin:$PATHgrep-qBUN_INSTALL~/.bashrc||echoexport BUN_INSTALL$HOME/.bun; export PATH$BUN_INSTALL/bin:$PATH~/.bashrc buninstall-goh-my-pi/pi-coding-agent# 4. 验证pi--versionomp--versionecho全部安装完成。运行 pi 或 omp 开始先 /login 配置模型。5.3 macOS 26zsh基于 Homebrew#!/usr/bin/env bashset-euopipefail# 0. 没有 Homebrew 先装 Homebrew官方脚本if!command-vbrew/dev/null21;then/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)fi# 1. 装 Node.jsbrewinstallnode# 2. 装 pinpminstall-g--ignore-scripts earendil-works/pi-coding-agent# 3. 装 ompbrew tap 官方源brewinstallcan1357/tap/omp# 4. 验证pi--versionomp--versionecho全部安装完成。运行 pi 或 omp 开始先 /login 配置模型。5.4 人工执行 vs 让 Agent 帮你装上面是人工自动执行你复制脚本自己跑一遍出问题自己看报错。另一种是Agent 自动配置把下面这段话原样发给你已有的 AI 助手pi、omp、Claude Code、Codex 都行让它来完成请帮我在当前机器上安装 pinpm 包 earendil-works/pi-coding-agent和 oh-my-pi官方文档 omp.sh。要求 1. 先检测操作系统和已有的运行时node/npm/bun/brew/winget缺什么装什么 2. 只用官方源安装不用第三方镜像 3. 每装一步验证一次版本号失败就停下来报告原因 4. 装完后打印 pi --version 和 omp --version 的输出 5. 不要替我配置任何 API Key只告诉我下一步该运行什么命令。这条路的好处是不同机器的环境差异有没有装过 nvm、PATH 干不干净由 Agent 现场判断脚本是死的Agent 是活的。坏处是你要盯着它别让它顺手把你的环境改乱。六、安全提示默认配置≠安全配置这点必须单独说pi 没有内置权限系统模型拿到 bash 工具后能执行的命令和你自己敲命令的权限一样大。项目目录里的.pi/extensions/扩展在你确认信任后会自动执行其中的代码。打个比方pi 像把家里钥匙直接给了保洁阿姨——阿姨大概率是好人但门一关她做什么你看不见。所以官方 README 也建议在不熟悉的项目里跑 pi/omp 时最好用 Docker 容器或虚拟机隔离一层至少别在存有重要密钥的目录里裸奔。omp 虽然内置了更多能力但能力越多能碰的东西也越多隔离建议同样适用。七、常见问题QAQ1pi 和 omp 能装在同一台机器上吗能。配置目录分别是~/.pi/agent和~/.omp/agent命令名也不同互不干扰。Q2我没有国外大模型的 Key能用吗能。pi 支持 30 多家服务商omp 支持 60 多家都包含国内的 Kimi、DeepSeek、MiniMax 等两者也都支持本地 llama.cpp 跑开源模型完全不花钱也能玩。Q3网上教程里的npm install -g mariozechner/pi-coding-agent还能用吗暂时能用旧包名做了别名但 pi 已搬家到earendil-works/pi建议直接用新包名earendil-works/pi-coding-agent免得哪天别名失效。Q4omp 内置 31 个工具会不会很臃肿很慢omp 用 Rust 重写了搜索、文件查找等核心操作内置 ripgrep 等官方的思路是功能多但每个都快。实际体感如何建议自己装来跑两天再下结论。Q5我从 Claude Code 搬家过来配置要重写吗omp 会自动读取.claude、.cursor、.codex目录里的规则和技能配置pi 则默认读取AGENTS.md和CLAUDE.md作为项目上下文。大部分规则类配置可以平移工具专属命令需要适应。八、写在最后pi 和 oh-my-pi 其实是同一个问题的两种答案AI 编程工具到底该内置多少东西pi 的答案是能不给的都不给omp 的答案是能给的都给。没有标准答案只有适不适合你的手。我自己的做法是日常探索性任务用 pi小、快、心里有数需要子代理并行干活或评审代码时切到 omp。两个工具都是 MIT 开源、活跃更新装一个试试的成本就是五分钟比看十篇评测文章有用。参考来源pi 官方文档、pi 作者的设计思路博文、oh-my-pi GitHub 仓库、oh-my-pi 官网。文中功能与数据以写作时的官方 README 为准后续版本可能有变化以你本地pi --help/omp --help的输出为准。