Pi 走的是极简和高度自由的路线,能让人随心搭配。刚上手时整理一下,它的基础功能其实就这几样,干净得刚刚好。

第一,是一个完整的 Agent 循环:调模型、执行工具、把结果交回模型,一直循环到任务完成,中途还能随时插话纠偏,或者直接打断。
第二,默认只开 4 个工具:read 读文件和图片、bash 执行命令、edit 精确修改文件、write 新建或覆盖文件。别看只有 4 个,其实已经够用了,grep、find、curl 这些都能直接通过 bash 去跑。
第三,还有 4 个内置工具默认没开:grep、find、ls,以及 Windows 上的 PowerShell。需要的话一行命令就能打开:pi –tools +grep,+find,+ls。也可以只开 read、grep、find、ls,变成一个只读 Agent,只看代码不改代码。
第四,MCP 现在是内置的,不用另外装插件,pi mcp add 加个 MCP 服务器就能用。注意一点:Pi 本身没有联网搜索,想让它上网查资料,得自己接一个搜索类的 MCP 或者其他的工具。

第五,支持 Skills,和 Claude Code 一样的 SKILL.md 格式,平时只把名字和描述给模型,用到了才加载全文,很省上下文。不过它默认不读 .claude/skills,需要在 ~/.pi/agent/settings.json 里加一行:”skills”: [“~/.claude/skills”]。
第六,能读 CLAUDE.md:会读当前目录和上层目录里的 AGENTS.md 或 CLAUDE.md,但同一个目录两个都有的话,只读 AGENTS.md;它也不读 ~/.claude/CLAUDE.md,全局说明要放到 ~/.pi/agent/ 下面。CLAUDE.md 并没有单独处理,就是和 AGENTS.md 放在同一个文件名列表里,所以 Claude Code 里的 @ 引用这些也不支持。
第七,其他基础能力也都有:多模型随时切换、会话可以分叉回退、上下文快满了自动压缩、支持命令行、RPC、SDK 调用。默认没有的,是子代理、计划模式、待办列表、权限确认这些,不过官方仓库的 examples 里都有对应的示例扩展,有兴趣的可以照着装,或者直接让 Pi 帮你写一个。
所以 Pi 更像一个干净的 Agent 底座,该有的基础都有,剩下的按自己的习惯往上搭。模型能力越强,Harness 也越应该简洁,不需要那么多花里胡哨的功能。