Pi Coding Agent 入门：4 个基础工具与极简终端工作流

为什么选择极简的 Pi Agent

大多数商业 Coding Agent 越来越沉重：强行绑定的 Plan 模式、复杂的子代理派发，以及不透明的内部提示词。

Pi（pi-coding-agent）由著名开源开发者 Mario Zechner 创建，它的设计哲学极其务实：**默认只给模型 4 个基础工具（read, write, edit, bash）**。模型靠这 4 个原子能力读写代码、运行命令、排查报错。没有隐藏的多余抽象，一切由开发者通过扩展自由掌控。

第一步：全局安装与快速拉起

官方推荐在全局安装时加上 --ignore-scripts 以规避非必要的生命周期脚本风险：

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

或者直接使用官方一键脚本：

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

第二步：配置模型凭证

你可以直接配置任意主流大模型的 API Key：

```bash export ANTHROPIC_API_KEY=sk-ant-...

或 export DEEPSEEK_API_KEY=sk-...

或 export OPENAI_API_KEY=sk-...

`

进入交互终端后，也可以通过 /login 使用你的官方账号（如 Anthropic 订阅等）进行授权。

第三步：在项目中开始对话

进入任意代码仓库根目录，输入 pi：

bash pi

在 TUI 界面中，直接用自然语言描述你的任务，例如：

检查当前仓库的测试用例并修复所有失败的 TS 类型报错

Pi 会调用 read 阅读源码，用 bash 执行 npm test，然后用 edit 精准替换修复。你可以随时按 Ctrl+C 中断或使用 /compact 压缩上下文。

4 大核心特性速览

1. **会话树与分支 (/branch)**：探索不同重构方向时随时保存分支，随时切换，永不丢失历史。
2. **上下文自动压缩 (/compact)**：长会话超出 token 限制时，保留核心事实摘要，无缝续写。
3. 无缝多模态：直接支持粘贴图片、截图让视觉模型解读 UI。
4. 多模式运行：支持终端交互、单次批处理命令 (pi -p 'task')、JSON-RPC 和 TypeScript SDK。

专区入口：/zh/pi-agent。

官方来源：Pi Coding Agent 官方 Quickstart 文档。本文为实战导读。