Pi 装好了，然后呢？

花 10 分钟做个记账本，你就知道它强在哪了

Pi 在 GitHub 上 9.3 万星，社交时间线上到处在刷。第一反应跟很多人一样：又一个 AI 编程助手，Claude Code 和 Codex 还不够用？

装完跑了一圈，发现它确实不太一样。别的工具在给 AI 不断加功能，它在给 AI 做减法。

三个数看懂它的减法逻辑

先看几组对比数据。

内置工具数量，Pi 默认只有 4 个：读文件、写文件、改文件、执行命令。另外还有 3 个只读查询工具。Claude Code 和 Codex 都是 10 个以上，还在不断增加。

系统提示词长度，Pi 大约 1000 token。Claude Code 和 Codex 从一万 token 起步。

同样的动作，比如你刚启动工具，还没开始干活，只打了个招呼。Pi 消耗 1100 token，占上下文的 0.4%。Codex 要 1.8 万 token，占 7%。桌子还没铺开，已经烧掉 7% 的办公面积。

看不懂 token 没关系，核心就一句：AI 每轮对话都要把系统提示词和工具清单重新发一遍，这些是固定开销。工具越多、提示词越长，固定税就越重。一个 50 轮对话的任务，光这块就比 Pi 贵出一个数量级。

Pi 砍的就是这笔固定税。

硬数据比口号实在

Databricks 拿自家几百万行代码的代码库跑过基准测试，换一个 Agent 外壳，同样成本下代码质量能差 2 倍以上。同等成本下，Pi 配 Claude 最强模型的代码质量超过了 Claude Code 和 Codex。

速度方面，Composio 的测试结果是 Pi 完成编程任务比同类工具快 1.5 到 2 倍。

Shopify 的 CEO 拿 Pi 给自己的开源模板引擎写了个自动优化插件，跑了多轮自动实验，性能提升 53%，内存占用减少 61%，全程 AI 自己动手。

六个特点，后面都会用到

默认只有 4 个工具，AI 每一步干了什么都摊开在终端里，没有黑盒。同样任务完成速度快 1.5 到 2 倍。上下文纪律好，同样的话账单更薄。支持 15 家以上模型供应商，DeepSeek、Claude、ChatGPT、Gemini、Kimi 随便切，对话中途换模型不丢上下文。要什么功能自己装插件，联网、子代理、Plan 模式、goal 目标模式、MCP 连接外部服务都能加。最狠的一条是它能自己给自己写插件，缺什么功能，跟它说一声，它自己写、自己装、自己测。

别人给 AI 加装备，它给 AI 减负担。减到底，AI 反而发挥得更好。

装 Pi，三选一

Windows 推荐一键脚本。桌面空白处右键，选“在终端中打开”，粘贴这行命令：

powershell -c "irm https://pi.dev/install.ps1 | iex"

如果提示需要 Node.js 或 Git，输入 y 让它自动安装。装完关掉当前窗口，重新打开一个终端，这步不能省，新装的命令才能生效。输入 pi，出现对话界面就是成了。

Mac 或 Linux，打开终端，粘贴：

curl -fsSL https://pi.dev/install.sh | sh

装完同样重新开终端，输入 pi。

如果已经装了 Node.js（建议 LTS 版本），npm 全局安装也行：

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

然后 cd 到你的项目目录，输入 pi 启动。

验证是否装好：pi --version 能看到版本号就对了。

配模型，两步搞定

装好只是空壳，得配一个大脑。两种方式二选一。

用 API Key 的话，启动 Pi 后输入 /login 回车，选 API key 那一项。国内直连推荐 DeepSeek，便宜也稳定。打开 DeepSeek 开放平台注册充值，在“API keys”里创建一个 key，复制粘贴回 Pi，按提示完成。打个招呼，Pi 回复了就说明配好了。

也可以不用 /login，先 export DEEPSEEK_API_KEY=sk-xxx 再启动 Pi，效果一样。

订阅账号也行，/login 选“Sign in with account”，选你的订阅，Claude Pro/Max、ChatGPT Plus/Pro（Codex）、GitHub Copilot 都支持。浏览器弹窗登录，登完回 Pi。按 Ctrl + L 打开模型选择器，就能看到你的订阅模型了。

日常切模型有三个快捷键。Ctrl + L 或 /model 打开模型选择器。Ctrl + P 循环切换常用模型，Shift + Ctrl + P 后退。Shift + Tab 调整思考强度，循环选项是 off、minimal、low、medium、high、xhigh、max。

省钱口诀就一句：简单任务用便宜模型加低思考强度，复杂任务再上贵模型。对话中途随时切，上下文不丢。

看懂底部状态栏

界面最下面一行是仪表盘。输入 Token 和输出 Token 显示本会话累计的输入输出量。Cache Read 和缓存命中率，命中率越高越省钱。预估成本显示花了多少，订阅模式仅供参考。xx% 和总窗口显示当前上下文占用比例。auto（压缩）表示上下文快满时自动压缩历史。末尾是模型供应商、模型名和思考强度。

三个概念，懂了就顺了

Agent：能自己动手干活的人工智能，不只是聊天，还能读写文件、运行命令。类比成一个会写代码的员工。

模型：Agent 的大脑，负责理解和思考。

Token：AI 计费的字数单位，中文大约 1 个字对应 1 到 2 个 token。类比电费，用得越多越贵。

上下文：AI 一次能记住的内容总量。类比员工的办公桌，越大能摊开的东西越多。

Pi 的本质是一个让你用一句话指挥“会写代码的员工”的终端工具。它负责调度模型、读写文件、执行命令，把“说人话”翻译成“干活”。

基础操作，先练顺手

建项目文件夹，建议全英文名，省得以后踩坑。文件夹里右键“在终端中打开”，输入 pi 回车。窗口顶部会显示这个文件夹的路径，这就是 AI 的工作地点，代码都写在这里。

发指令直接打字回车。输入多行指令用 Shift + Enter 换行，写完再回车。Ctrl + G 打开系统编辑器写长文，保存关掉自动同步。给 AI 看截图，Windows 按 Alt + V，Mac 按 Ctrl + V，Windows 这个是 Alt+V，最容易记反。让 AI 只读某个文件，输入 @ 弹出文件搜索，选中即可。命令行也能 pi @README.md "概括一下"。运行命令并把结果给 AI，用 !命令，比如 !npm run dev。运行命令但 AI 看不见，用 !!命令，比如 !!git commit -m "wip"。

会话管理：/new 开新会话，AI 忘掉之前一切。下次回来 pi -c 继续最近一次，pi -r 从列表里挑一个。pi --name "记账本任务" 给会话起名，方便以后找。

第一个作品：10 分钟做个家庭记账本

理论够了，动手。这一步让 Pi 从零做出一个家庭记账本网页，记收入、记支出、看汇总。也可以换成任何想要的，菜谱管理、读书清单、健身打卡都行，套路完全一样。

在 Pi 对话框输入这段话：

用 React 做一个家庭记账本网页，功能包括：
1. 记录每笔收支（金额、类别、备注、日期）
2. 显示总收入、总支出、结余
3. 最近的记录列表

回车。Pi 会开始读文件、写文件、跑命令。对话里出现大量文件操作记录，最后提示可以启动项目，就说明代码写好了。

输入 !npm run dev 启动。等它跑起来，会给你一个本地地址，一般是 http://localhost:5173 或 3000。浏览器打开，记账本的页面就在眼前。

觉得界面丑？比如想让“结余”数字更醒目。浏览器里截图，回到 Pi，Windows 按 Alt + V、Mac 按 Ctrl + V 粘贴图片，输入“结余数字要大、用绿色显示”。Pi 看图改代码，刷新浏览器看效果。

代码别堆在一个文件里，输入：

@src/main.tsx 把代码拆成组件，收支表单一个组件、汇总一个组件、列表一个组件

Pi 会重构代码结构，以后加功能改样式都更清晰。

几个命令闭环用：!npm run dev 启动项目，!npm install 装依赖，/new 干完一轮开新会话继续，pi -c 明天回来接着干。

操作速览

安装启动

• 🍂
  
  Windows：powershell -c "irm https://pi.dev/install.ps1 | iex"
• 🍂
  
  Mac/Linux：curl -fsSL https://pi.dev/install.sh | sh
• 🍂
  
  npm：npm install -g --ignore-scripts @earendil-works/pi-coding-agent
• 🍂
  
  验证：pi --version

配置模型

• 🍂
  
  API Key：/login 选 API key，粘贴 DeepSeek 或其他供应商的 key
• 🍂
  
  订阅账号：/login 选 Sign in with account，浏览器登录
• 🍂
  
  切模型：Ctrl + L
• 🍂
  
  调思考强度：Shift + Tab

日常操作

• 🍂
  
  新会话：/new
• 🍂
  
  继续最近会话：pi -c
• 🍂
  
  命令结果给 AI：!命令
• 🍂
  
  命令结果不给 AI：!!命令
• 🍂
  
  粘贴截图：Windows Alt + V，Mac Ctrl + V

项目命令

• 🍂
  
  启动项目：!npm run dev
• 🍂
  
  装依赖：!npm install

常见问题

装完输入 pi 提示找不到命令

装完没有重新开终端。关掉当前终端窗口，新开一个再试。Windows 用户尤其容易漏这一步。

/login 之后模型还是用不了

检查 API Key 是否正确复制，有没有多余空格。DeepSeek 的 key 以 sk 开头。订阅账号的话，确认浏览器已经登录了对应服务。

Pi 一直在跑命令不动了

第一次跑项目要装依赖，需要联网下载，等几分钟正常。如果超过 5 分钟没动静，Ctrl + C 终止，输入 !npm install 手动装依赖，再 !npm run dev 启动。

上下文占用比例到 90% 以上了

Pi 底部状态栏显示比例过高时会自动压缩历史。也可以手动 /new 开新会话，把必要的文件用 @ 重新喂给 AI，比让它在一堆旧上下文里硬撑要稳。

截图粘贴没反应

Windows 按的是 Alt + V，不是 Ctrl + V。Mac 是 Ctrl + V。确认截图已经保存在剪贴板里，再按快捷键。

想让 Pi 改某个具体文件，不想让它自己猜

输入 @ 弹出文件搜索，选中要改的文件，然后说具体要改什么。比直接说“改一下样式”要准得多，不会改错文件。

代码拆完组件后项目跑不起来了

拆组件过程中 Pi 可能漏了 import。把报错信息完整贴给 Pi，说“修复这个报错”，它自己能补上。或者在拆组件之前先 !npm run dev 确认项目是能跑的，拆完跑不起来就把报错扔回去。