# Pi

Pi 是一款极简、开源的终端编程智能体（Agent），旨在让开发者能够灵活定制而非局限于单一的工作流。它集成了交互式终端界面（TUI）、多供应商模型接入、技能扩展、插件系统、提示词模板以及可脚本化的模式，适合追求高可定制性工具的开发者。

Canonical URL: https://aiidelist.com/zh/ide/pi

Language: zh

更新日期: 2026-10-06

## 概览

- 分类: Terminal / CLI Coding Agents
- Pi 是一款开源的终端编程智能体及可定制框架，为寻求轻量化、可扩展替代方案的开发者提供了除固定模式 CLI 之外的新选择。
- 编辑器基础: CLI
- 平台: macOS, Linux, Windows, Termux on Android, Node.js
- 开源: 是
- 本地模型支持: 是
- 自带 API 密钥: 是

## 简评

对于习惯终端操作并希望拥有开放、可定制 Agent 框架而非封闭助手的开发者，Pi 是极佳选择。但如果您需要精美的编辑器集成、内置沙箱或开箱即用的企业级治理功能，它可能不太适用。

## 适合场景

- 偏好在终端使用编程智能体的开发者
- 希望自定义 Agent 框架而非被动接受产品工作流的团队
- 构建自定义命令、工具、提示词和 Agent 扩展的高级用户
- 使用 JSON、RPC 或 SDK 模式的自动化 Agent 工作流
- 尝试从单个 CLI 调用多个 LLM 供应商的开发者

## 优点

- 高度可定制的终端优先编程智能体。
- 非常适合想要自主构建 Agent 工作流的开发者。
- 支持众多模型供应商及自定义配置。
- 可通过 Print、JSON、RPC 和 SDK 模式进行脚本化操作。
- 开源且遵循 MIT 协议。

## 局限

- 寻求 Cursor 或 Windsurf 等全集成 AI 原生编辑器的用户
- 需要无需额外配置即带沙箱环境的开发者
- 偏好默认开启计划模式和权限关卡的团队
- 寻找“提示词转应用”生成的非技术用户
- 需要开箱即用的托管式企业管理控制台的组织
- 并非拥有内置编辑器界面的精美 AI IDE。
- 无内置沙箱；隔离环境需手动配置。
- 默认缺少计划模式和子 Agent 等内置功能。
- 需要熟悉终端操作及相关配置。
- 成本、频率限制和隐私性取决于所选的模型供应商。

## 为什么选择 Pi？

Pi 专为希望将编程智能体纳入可定制工作流的开发者而设计。Pi 没有提供一个功能固化的封闭式助手，而是将智能体视为一个精简的核心，周围环绕着用户可控的扩展、技能、提示词、主题和包。

这种设计对高级用户非常有吸引力。团队可以从默认的终端智能体开始，逐步增加特定项目的命令、上下文注入、自定义 UI 行为、模型路由或自动化工作流，而无需等待核心产品发布新功能。其代价是 Pi 要求开发者承担更多配置责任：灵活性固然宝贵，但它不同于开箱即用的托管式 AI IDE。

## 核心工作流程

Pi 的典型工作流以终端为中心。开发者在代码仓库中启动 Pi，选择模型供应商，然后通过交互式会话进行协作。在此过程中，智能体可以检查文件、编辑代码、执行命令，并在运行过程中响应用户的引导指令。

Pi 在处理历史记录和控制权方面有着显著不同。会话采用树状结构，开发者可以回溯到之前的任何消息，开启对话分支，并在单个会话文件中保留多种可能的路径。当智能体尝试了一种看似可行但有风险的方向时，这种机制非常有用：用户可以分支并测试另一条路线，而不会丢失之前的状态。

此外，Pi 还支持非交互模式。这使其不仅是一个聊天助手，更能作为开发工作流的基础设施。脚本可以以打印模式调用 Pi，消费 JSON 事件流，或通过 RPC 和 SDK 进行集成，适用于常规 TUI 过于繁琐的自动化场景。

## 适用场景

Pi 最适合需要严格终端控制权的编程任务：重构本地仓库、生成脚本、调试失败的测试、探索陌生代码，或根据团队规范构建可重用的智能体工作流。

它也非常适合正在进行上下文工程（Context Engineering）实验的团队。通过项目指令、可重用提示词、技能和扩展，可以塑造智能体理解仓库的方式以及加载上下文的深度。当同一仓库需要在不同任务中表现出可重复的智能体行为时，这一点非常有用。

对于侧重自动化的用户，Pi 可以成为自定义工作流的基础层。开发者可以先交互式地使用 Pi 进行探索性工作，然后将可重复的部分转化为提示词模板，将其打包，或通过 JSON/RPC 模式从其他工具中调用。

## 同类工具对比

与 Claude Code、Codex CLI、Gemini CLI 和 Qwen Code 相比，Pi 不绑定于特定的模型生态系统。它的吸引力不仅在于调用模型，更在于其 Agent 框架可以通过扩展和包进行重塑。这对于经常更换供应商或希望工作流不受模型更迭影响的开发者非常有吸引力。

与 Aider 相比，Pi 的定位更广，更偏向于框架。Aider 在具备 Git 感知的终端结对编程方面享有盛誉，而 Pi 则强调会话树、可扩展性、自定义供应商和可编程模式。想要直接结对编程体验的开发者可能更倾向于 Aider；而想要构建自有 Agent 界面的开发者则可能更喜欢 Pi。

与 Cursor 或 Windsurf 等 AI IDE 相比，Pi 有意不介入整个编辑器体验，而是作为终端工具运行在编辑器旁。对于喜爱现有编辑器配置的用户来说，这是其优势；但对于追求代码补全、编辑器原生聊天、视觉化 Diff 和内置项目导航等一体化 GUI 体验的团队来说，这可能被视为不足。

## 最佳配置建议

实用的 Pi 配置应从受信任的本地工作区、明确的供应商凭据和清晰的模型选择策略开始。对于日常编程，建议将强大的推理模型用于复杂编辑，将低成本模型用于简单的检查、总结或脚本任务。当用户根据任务类型有意识地路由任务，而不是对所有工作都使用单一模型时，Pi 的供应商灵活性价值最高。

对于大型仓库，应尽早定义项目指令（Project Instructions）和可重用提示词。这能避免在临时聊天中重复发送引导语，并使工作流更易于分享。扩展功能应逐步添加，尤其是涉及执行命令或修改文件的扩展。

处理高风险任务时，请在容器、虚拟机或沙箱环境中运行 Pi。Pi 的本地 Agent 模式之所以强大，是因为它可以访问开发者的文件系统和工具链，但也意味着隔离边界需要由操作系统或容器层提供。

## 迁移建议

从其他 CLI 智能体迁移到 Pi 主要是工作流的迁移，而非文件格式的转换。关键步骤是确定哪些行为是必需的：模型供应商配置、仓库指令、自定义命令、编辑审批习惯、测试运行模式以及任何沙箱预期。

习惯了功能高度集成工具的用户可能需要自行重建一些默认行为。例如，如果之前的工具内置了计划模式（Plan Mode）、权限提示、子 Agent 或后台 Shell 管理，Pi 可能需要通过扩展、包、基于 tmux 的工作流或外部沙箱模式来实现类似效果。

其长远收益在于灵活性。一旦团队沉淀了自己的提示词、技能和扩展，Pi 就能成为一个便携的 Agent 环境，始终遵循团队的工作流，而非强制每个人去适应某款产品的预设逻辑。

## 功能

### 终端 Agent 框架

- 交互式终端 UI (TUI)
- 支持脚本调用的 Print 和 JSON 模式
- RPC 和 SDK 集成选项

### 定制系统

- TypeScript 扩展
- 可重用的技能组件
- 提示词模板
- 主题定制与 Pi 软件包

### 模型与供应商接入

- 支持 API Key 供应商
- 支持基于 OAuth 的订阅制供应商
- 自定义供应商与模型配置

### 会话与上下文控制

- 树状结构的会话历史
- 会话分支与共享
- 支持 AGENTS.md 及上下文文件
- 可配置的上下文压缩

## 价格

open-source

- Open Source: $0 — 永久 — 基于 MIT 协议的开源 CLI 和 Agent 框架；模型使用费需通过所选供应商另行支付。
- Model Access: Varies — 根据您的配置，支持主流订阅、API 密钥、本地模型或自定义供应商。

价格核对日期: 2026-07-08

## 支持的模型

- Anthropic
- OpenAI
- OpenAI Codex
- Claude Pro/Max
- GitHub Copilot
- Google Gemini
- Azure OpenAI
- Amazon Bedrock
- Mistral
- Groq
- Cerebras
- xAI
- Hugging Face
- OpenRouter
- Ollama
- DeepSeek

## 隐私与数据处理

Pi 在本地运行，拥有启动它的用户帐户权限。除非使用本地供应商，否则代码、提示词和命令输出可能会发送至所选的模型供应商。由于 Pi 不包含内置沙箱，处理不受信任的代码仓库或进行无人值守运行时，应使用 Docker、虚拟机或微型虚拟机进行隔离。

## 企业功能

- 可自托管的本地 CLI 工作流
- 支持 BYOK（自带密钥）配置
- 支持基于 OAuth 的订阅供应商
- 针对本地 Pi 资源的项目信任控制
- 完善的容器化与沙箱化方案文档
- 支持自定义供应商、扩展、技能和提示词模板

## 替代工具

- Claude Code
- OpenAI Codex CLI
- Gemini CLI
- Aider
- OpenCode
- Qwen Code

## 资料来源

- [官方网站](https://pi.dev/)
- [项目文档](https://pi.dev/docs/latest)
- [供应商配置文档](https://pi.dev/docs/latest/providers)
- [安全说明文档](https://pi.dev/docs/latest/security)
- [容器化指南](https://pi.dev/docs/latest/containerization)
- [模型库](https://pi.dev/models)
- [GitHub 仓库](https://github.com/earendil-works/pi)
- [媒体资料包](https://pi.dev/press-kit)

最近核对日期: 2026-08-29

## 更新记录

- 2026-07-08: 确认 Pi 为开源终端编程智能体及框架，支持扩展、技能、提示词模板及多供应商接入，并提供安全/容器化指南。
- 2026-08-29: 更新 Pi 编程智能体速查表至 v0.84.4：现已支持 clear\_queue、ui\_prompt\_start/ui\_prompt\_end、终端功能覆盖、全屏选中复制、DeepSeek V4 Flash Vision 以及请求前的上下文压缩行为。