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

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 来配置模型提供商。
• 进入项目 ：进入你的项目目录并输入 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

Pi的应用场景

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