Pi – 开源的终端编程 Agent，支持自定义工具与模型接入

智能 PRO 稿源：AI工具集 2026-09-05 09:45

0XU.CN

Pi是什么

Pi （Agent Harness）是极简开源的终端编程 Agent，由 Mario Zechner 推出，同时是 OpenClaw 的底层 Coding Agent。工具只给模型 read、write、edit、bash 四个基础工具，系统提示词不到 1000 token，其余功能全部交给 TypeScript 扩展。Pi支持 15+ 模型提供商、树状分叉会话、跨厂商切模型。

Pi的主要功能

极简工具集：默认只给模型 read、write、edit、bash 四个工具，搜索等操作让模型自行用 grep/find 解决，系统提示词不到 1000 token。
多模型接入：内置 15+ 提供商（Anthropic、OpenAI、Kimi、DeepSeek、MiniMax 等），支持 OAuth 订阅登录和 API Key 两种方式。
树状会话历史：会话以树形结构存储，可随时跳回任意历史节点重新提问、分叉试错，所有分支共存于一个文件。
跨厂商切模型：会话中途可通过 /model 或 Ctrl+L 切换不同厂商模型，上下文自动交接转换。
四种运行模式：交互式 TUI、Print/JSON 脚本模式、RPC 协议、Node.js SDK，满足从日常编码到程序集成的不同场景。
扩展自定制：TypeScript 扩展模块扔进目录可热加载，能注册自定义工具、命令，拦截事件，可让 Pi 现场给自己写扩展。
Skills 与 Prompt 模板：支持 Agent Skills 标准，Markdown 文件可直接变为带参数的 / 命令。
社区包生态：扩展、Skills、模板、主题可打包为 Pi packages，通过 pi install npm:xxx 或 git 仓库一键安装分享。
兼容现有配置：自动沿目录树查找并识别 AGENTS.md 和 CLAUDE.md，原有 Claude Code 配置无需迁移。
上下文工程：支持 SYSTEM.md 覆盖系统提示词、自动 Compaction 摘要、动态上下文注入，让用户精确控制进入上下文窗口的每个 token。

微信关注回复“开源”，加入AI开源项目交流群

如何使用Pi

安装：通过运行 npm install -g --ignore-scripts @earendil-works/pi-coding-agent 或 curl -fsSL https://pi.dev/install.sh | sh 在终端中安装 Pi。
启动：安装完成后，在终端输入 pi 可进入交互式 TUI 界面。
登录配置：首次使用需运行 /login，选择 OAuth 订阅登录或填入 API Key 来配置模型提供商。
进入项目：进入你的项目目录并输入 pi，Pi 会自动加载当前目录及父目录下的 AGENTS.md 或 CLAUDE.md 作为上下文。
开始对话：在交互界面直接用自然语言描述需求，使用 @ 模糊搜索文件、! 执行 Shell 命令、Ctrl+V 粘贴图片。
切换模型：如需更换模型，可随时输入 /model 或按 Ctrl+L 在不同厂商模型间切换，上下文会自动交接。
树状回溯：用 /tree 命令查看树状会话历史，可跳回任意节点重新提问或分叉试错。
扩展功能：如需扩展功能，可在 ~/.pi/agent/extensions/ 目录编写 TypeScript 扩展模块，保存后输入 /reload 热加载生效。
导出分享：会话结束后，可用 /export 导出为 HTML，或用 /share 生成 GitHub Gist 分享链接。
退出续接：按 Ctrl+C 或 Ctrl+D 即可退出当前会话，下次用 pi -c 可继续上一次的对话。

Pi的核心优势

极简高效：系统提示词加工具定义不到 1000 token，只给模型四个基础工具，响应速度极快。
精确上下文控制：支持 SYSTEM.md、AGENTS.md、动态上下文注入和自动 Compaction，你能决定每个 token 怎么进上下文。
超强扩展性：TypeScript 扩展热加载即生效，甚至可以让 Pi 现场给自己写扩展，官方不做的东西社区用包补齐。
树状会话历史：会话以树形结构存储，可随时跳回任意节点重新分叉试错，避免线性对话的沉没成本。
跨厂商无缝切换：内置 15+ 提供商，会话中途随时切换不同厂商模型，上下文自动交接转换。
零迁移成本：自动识别 CLAUDE.md 和 AGENTS.md，Skills 标准与 Claude Code、Codex 通用，原有配置直接复用。
国产模型友好：内置 DeepSeek、Kimi、智谱、Qwen、MiniMax、MiMo 等国产模型，且单独配置了中国区节点。
完全开源 MIT：代码全公开，供应链安全 hardened，社区已衍生出 Go、Rust、Python 等多个移植版本。
四种运行模式：交互 TUI、Print/JSON、RPC、SDK 覆盖从日常编码到企业集成的全场景需求。
自解释能力：Pi 能解释自己的功能和文档，甚至能直接帮你查文档、写配置，降低上手门槛。

Pi的项目地址

项目官网：https://pi.dev/
GitHub仓库：https://github.com/earendil-works/pi

Pi的同类竞品对比

维度	Pi	Claude Code
定位	极简可扩展的 Agent Harness	全功能开箱即用的 Coding Agent
系统提示词	< 1000 token，极简	上万 token，功能丰富
内置工具	仅 4 个：read、write、edit、bash	大量内置工具，含文件搜索、代码分析等
Sub-agents	不做内置，需自行用 bash spawn 或装扩展	原生支持
Plan Mode	不做内置，建议写 PLAN.md	原生支持
MCP 支持	不做内置，社区有 pi-mcp-adapter	原生支持
权限确认	默认 YOLO 模式，不弹窗	有权限弹窗确认机制
模型支持	15+ 提供商，可跨厂商切换	仅限 Anthropic Claude
会话结构	树状历史，支持分叉回溯	线性历史

Pi的应用场景

快速脚本与原型开发：在终端直接用自然语言生成、调试和运行脚本，树状会话支持快速试错不同实现方案。
代码库重构与维护：用 Pi 的代码编辑能力和跨模型切换特性，在大型项目中进行批量重构，同时通过 AGENTS.md 沉淀项目规范。
自定义开发工作流：通过编写 TypeScript 扩展，将 Pi 改造成符合团队或个人的专属工具链（如自动代码审查、文档生成、特定框架脚手架）。
开源协作与知识分享：用 /share 导出 GitHub Gist 或 /export 生成 HTML，将完整的调试和开发过程分享给协作者或用于技术博客。
远程服务器与容器化开发：在 SSH 服务器或 Docker 容器中运行 Pi，配合 tmux 实现后台持久化会话，适合云端开发、CI/CD 流水线集成等无图形界面环境。

0XU.CN