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

发布于 2026-09-04 · Pi （Agent Harness）是极简开源的终端编程 Agent，由 Mario Zechner 推出，同时是 OpenClaw 的底层 Coding Agent。工具只给模型 read、write、edit、bash 四个基础工具，系统提示词不到 1000 token，其余功能全部交给 TypeScript 扩展。

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 怎么进上下文窗口由你决定。

如何使用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，把模型提供商配好。
进入项目：cd 到项目目录，输入 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：代码全部公开，供应链安全做过加固，社区已经衍生出 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的应用场景

快速脚本与原型开发：在终端用自然语言生成、调试、运行脚本，树状会话方便快速试几种不同实现。
代码库重构与维护：靠代码编辑能力和跨模型切换，在大型项目里做批量重构，顺手把项目规范沉淀到 AGENTS.md。
自定义开发工作流：写 TypeScript 扩展，把 Pi 改成团队或个人专用的工具链，比如自动代码审查、文档生成、特定框架的脚手架。
开源协作与知识分享：用 /share 导出 GitHub Gist 或 /export 生成 HTML，把整个调试和开发过程发给协作者，或者写进技术博客。
远程服务器与容器化开发：在 SSH 服务器或 Docker 容器里跑 Pi，配 tmux 让会话在后台常驻，云端开发、CI/CD 流水线这类没图形界面的环境都合适。