2026年7月21日 · 阅读约 6 分钟

你有没有遇到过这样的场景：打开 Claude Code 或 Cursor，输入一个简单需求，它却生成了满屏的代码、弹出一堆确认框，还 spawn 出好几个子代理——你根本不知道它到底在干什么？

如果你也厌倦了这种"被 AI 绑架"的感觉，那么今天介绍的 Pi Coding Agent，可能会让你眼前一亮。

Pi 是什么？

Pi 是一个开源、极简的终端 AI 编码助手，由知名游戏框架 libGDX 的作者 Mario Zechner 开发。它运行在终端中，只用 4 个核心工具就完成了所有编程任务：读文件、写文件、精确修改、执行命令。GitHub 上已获得 69K+ Stars，采用 MIT 开源协议，完全免费。

它的核心理念可以用一句话概括：砍掉所有花活，只留真正有用的东西。Claude Code 的系统提示词超过 10000 tokens，而 Pi 只有约 1000 个 tokens。Mario 的原话是："我实在看不出有什么必要塞 10000 tokens 的 system prompt。"

一句话总结：Pi 就像编程工具界的 Vim——核心极小，但通过扩展系统可以变成任何你想要的样子。它不替你做决策，而是把控制权 100% 还给你。

四个工具，走天下

Pi 只有这四个工具，一个不多：

▲ Pi 的四大核心工具：read、write、edit、bash

为什么这么少？因为 AI 编程代理的核心能力，说穿了就是读代码、写代码、改代码、跑命令。Pi 把每件事都做到极致，不堆砌你用不到的功能。

Pi vs Claude Code：谁更适合你？

▲ Pi 的极简哲学 vs 传统工具的"大而全"路线

简单说：如果你喜欢自己掌控一切，选 Pi；如果你想要开箱即用、不想折腾，选 Claude Code

小白快速上手指南（5 步搞定）

虽然 Pi 的定位偏硬核，但安装和基本使用其实并不复杂。跟着以下 5 步，10 分钟就能跑起来：

1. 1

   安装 Node.js（≥ 20.0）打开终端，输入 node -v检查版本。如果没装，去 nodejs.org 下载 LTS 版本安装即可。

2. 2

   全局安装 Pi

3. npm install -g @earendil-works/pi-coding-agent

4. 3

   配置 API Key设置环境变量（二选一）：

5. # 方式一：直接设置（推荐）export ANTHROPIC_API_KEY="你的API密钥"# 方式二：使用 OpenAI 兼容接口export OPENAI_API_KEY="你的API密钥"

6. 4

   启动 Pi进入你的项目目录，终端输入：

7. cd 你的项目目录pi

8. 5

   安装推荐扩展（可选但强烈建议）

这会安装作者维护的官方技能包，让 Pi 的能力更丰富

npx skills add badlogic/pi-skills

第一次对话试试这些

安装完成后，试试在 Pi 的交互界面输入以下指令，感受一下它的速度：

帮我看看这个项目是做什么的给 src/index.ts 添加一个 hello 函数运行 npm test 看看有没有报错

你会发现 Pi 的响应快得惊人——同样任务下，它比 Claude Code 快约 5 倍，因为系统提示词极短，token 开销极低。

新手避坑指南

坑 1：Pi 没有确认弹窗

Pi 默认完全信任你，执行命令不会弹出确认框。这意味着 rm -rf这种危险命令会直接执行。建议：在项目目录下使用，重要操作前先 git commit。

坑 2：没有内置 Plan Mode（计划模式）

Pi 不做任务规划。替代方案：写一个 PLAN.md文件，让 Pi 边读边执行。这个文件可以进 Git 版本控制，团队也能共享。

坑 3：Windows 用户注意

Pi 目前对 Windows 的原生支持有限，建议使用 WSL2（Windows Subsystem for Linux）来运行，体验会好很多。

进阶玩法：用扩展打造你的专属工具

Pi 的核心设计哲学是"核心只做基础事，扩展来补充"。你可以用 TypeScript 写自己的扩展模块，注册新工具、命令、快捷键，甚至打包成 Pi Package 通过 npm 分享：

pi install npm:@foo/pi-tools

想要 MCP 支持？写个扩展。想要子代理？写个扩展。想要权限控制？写个扩展。这种"Vim 式"的插件哲学，让你可以一步步搭建出高度契合自己工作流的工具链。

总结：谁适合用 Pi？

Pi 不是万能的，它更偏向"高级用户的趁手兵器"。如果你符合以下描述，强烈建议试试：

• 喜欢在终端里干活，对 IDE 臃肿感到烦躁
• 想要 100% 控制 AI 的行为，不想被黑盒"绑架"
• 希望用不同的 AI 模型（Claude、GPT、DeepSeek 等），而不是被一家绑定
• 享受自己搭积木的乐趣，愿意花时间定制工具

如果你是纯小白、开箱即用党，Claude Code 或 Cursor 可能更适合你。但如果你愿意花 10 分钟折腾一下，Pi 回报给你的效率和掌控感，绝对值得。

Mario 说过一句话很有意思："如果 Pi 不适合你的需求，我恳请你 fork 它。"——这首先是他自己用的工具，而不是为了做成商业产品。这种"为自己而写"的纯粹，正是 Pi 最打动人的地方。