《万字长文 | Pi Agent 零基础实操：从打开终端到完成第一个真实任务》

我最近一直在想，普通人第一次接触终端 Agent，最应该学会的到底是什么。

不是背诵复杂的底层参数或自动化脚本，而是分清材料边界、盯住工具调用，并完成一次能够独立核对的真实任务。

网上很容易找到一长串命令。很多人看完似乎懂了不少，真把终端打开，光标一闪，又不知道第一句话该写什么。更麻烦的情况是，Agent 回了一句“已经完成”，人也跟着放心了，文件究竟写到了哪里、原材料有没有被覆盖、里面漏了什么字段，全都没看。

所以这篇教程只做一件完整的事：在一个独立练习文件夹里放入一份虚构的会议记录，让 Pi 读取它并生成行动清单。任务结束后，我们不用 Pi 自己的总结作证明，直接回到命令行检查原文件校验值、输出文件、负责人和截止日期。

一、Pi 能帮普通人做什么

Pi 是一个运行在终端里的 Agent。你在某个文件夹里启动它，它可以围绕当前任务读取文件、写入文件、修改内容，也可以执行本机命令。它回复你的方式仍然像聊天，可它能继续动手，把结果真实落到电脑里。

二、安装、确认版本与登录

1. 先给第一次练习单独建个文件夹

终端 Agent 最容易被忽略的一步，发生在启动以前。别直接在桌面、下载目录或正式项目里跑。先建立一个专门的练习沙盒：

2. 从官方复制全局安装命令

使用 npm 完成官方全局包安装（带 --ignore-scripts 参数）：

3. 登录的两条路径

进入练习目录后运行 pi。认证方式支持在输入区输入 /login 通过 Claude Pro/Max、ChatGPT Plus/Pro 订阅授权，或者直接配置对应模型提供方的 API Key。

三、第一次打开 Pi，先看懂四个区域

四、完成第一个可以验收的真实任务

在 input/项目会议记录.md 中存入包含 3 位负责人、3 个日期、3 条风险提醒的会议记录，并在执行前计算 SHA-256 校验指纹：

在 Pi 输入区键入 @input/项目会议记录.md 选定材料：

读取 input/项目会议记录.md，整理成 output/行动清单.md。必须保留每个事项、负责人、截止日期和风险提醒；不要修改 input 中的原文件，不要访问当前练习目录以外的内容。完成后列出新增和修改的文件，并说明我应该怎样验收。

脱离 Agent 总结：回到命令行执行五重物理验收

五、让 Pi 理解文件和项目规则

六、会话树、分支与上下文压缩管理

Pi 具备强大的会话管理能力：

• 退出与恢复：pi -c 快速继续上次对话；pi -r 选择历史会话。
• 会话决策树：输入 /tree 可视化查看历史节点；使用 /fork 从任意历史点裂变新会话，安全尝试平行方案。
• 上下文瘦身：对话过长导致 Context 饱满时，执行 /compact 自动压缩早期历史，腾出推理空间。

七、安全边界与新手三阶进阶法