AI
Pi 学习总结与 CLI 工具对比
Nanlan2026年8月5日编辑于 2026年8月6日7 min
Pi 是什么
Pi 是一个运行在终端里的 AI 编程工具。它的核心很轻，主要负责连接模型、项目文件和终端工具；具体工作方式则可以通过规则、提示模板、Skill 和 TypeScript Extension 自行调整。
它不是一个大模型，而是承载大模型工作的编程代理框架。Pi 支持 DeepSeek、OpenAI、Claude、Gemini、Kimi、OpenRouter、llama.cpp 等多种模型来源，适合希望自由选择模型、自己搭工作流的人。
主要内容
- 配置 DeepSeek API Key，通过
/model切换模型。 - 使用
@文件名把文件明确加入上下文。 - 使用
!命令执行 Shell 命令并把结果交给模型；!!命令只在本地显示结果。 - 通过工具白名单限制 Pi，例如只开放
read、grep、find和ls。 - 使用
/name、/session、/resume、/tree、/fork和/clone管理会话。 - 在
AGENTS.md中保存项目规则，让新会话继续遵守。 - 在
.pi/prompts/中创建 Prompt Template，把常用提示变成斜杠命令。 - 在
.pi/skills/中创建 Skill，封装代码审查等可复用流程。 - 在
.pi/extensions/中编写 TypeScript Extension，添加/hello、/project-info等命令。 - 使用
/compact压缩长对话，保留重要进度并释放上下文。 - 使用
/settings管理模型、思考等级、主题和项目配置。
可以把 Pi 的定制方式理解成四层：
| 方式 | 用途 |
|---|---|
AGENTS.md | 保存项目约定与长期规则 |
| Prompt Template | 复用一段固定提示词 |
| Skill | 复用完整的专业工作流程 |
| Extension | 添加真正的新命令、工具、事件和界面 |
Pi、Codex CLI 与 Claude Code 的区别
| 对比项 | Pi | Codex CLI | Claude Code |
|---|---|---|---|
| 核心定位 | 小核心、可编程的多模型终端代理 | OpenAI 官方终端编程代理 | Anthropic 官方终端编程代理 |
| 模型选择 | 最自由，可接多家云模型、本地模型和自定义供应商 | 以 OpenAI/Codex 模型体系为主 | 以 Claude 模型体系为主，也可通过 Bedrock、Vertex AI 等部署渠道使用 Claude |
| 开箱体验 | 需要自己理解和组合配置 | 功能完整，安装后即可处理本地仓库 | 功能完整，安装后即可处理本地仓库 |
| 项目规则 | AGENTS.md 或 CLAUDE.md | 主要使用 AGENTS.md | 主要使用 CLAUDE.md |
| 扩展能力 | TypeScript Extensions、Skills、Prompt Templates、Themes、Pi Packages | Skills、MCP、Plugins、Hooks、配置文件与非交互模式 | Skills、MCP、Hooks、Subagents、Commands 与 Plugins |
| 会话特点 | 会话树、/tree、/fork、/clone 和可定制压缩很突出 | 更强调任务执行、代码审查、沙箱、自动化和脚本集成 | 更强调 Claude 原生工作流、权限系统、Hooks 和团队配置 |
| 安全方式 | 有项目信任和工具白名单；核心刻意保持精简，扩展可拥有完整系统权限，需要主动审查或配合容器 | 内置权限选择、审批和沙箱机制，默认控制更完整 | 内置权限规则、审批与沙箱能力，可细分允许或拒绝的操作 |
| 编程接口 | Node.js SDK、RPC、JSON 事件流、完整扩展 API | SDK、App Server、MCP Server、codex exec 和 GitHub Action | SDK、非交互模式、MCP、Hooks 及插件体系 |
| 更适合谁 | 喜欢多模型、低层定制和研究 Agent 工作流的人 | 已使用 OpenAI，希望稳妥完成工程任务与自动化的人 | 主要使用 Claude，希望获得成熟原生体验与团队工作流的人 |
怎么选择
如果只想快速完成开发任务，不想花时间维护配置，Codex CLI 或 Claude Code 更省心。两者的区别主要取决于你更愿意使用 OpenAI 还是 Claude 的模型和生态。
如果希望在 DeepSeek、Kimi、OpenAI、Claude 或本地模型之间自由切换，并且愿意自己组合工具与流程，Pi 更合适。它的优势不是“默认功能最多”，而是核心透明、模型开放、扩展自由。
对目前的使用方式来说，可以把 Pi 当作主学习环境，先用好文件引用、Shell、会话恢复和 AGENTS.md。只有某段提示或流程反复出现时，再把它整理成 Template 或 Skill；只有确实需要新程序能力时，才编写 Extension。
参考资料
本文依据 2026 年 8 月 3 日的官方文档整理。三款工具迭代较快，具体命令和能力以最新文档为准。