老金出海AI · GO GLOBAL
Pi Coding Agent活跃开源 · 稳定可用MIT

极简、透明且高度可定制的 Coding Agent

Pi（pi-coding-agent）由著名开源作者 Mario Zechner 打造。它的核心哲学是：默认只给模型 4 个基础工具（read / write / edit / bash），拒绝强制捆绑沉重的 Plan 模式或多代理黑盒，但通过 TypeScript 扩展让你可以自由改造成任意工作流。

本页更新于 2026-08-15。本站自身的全套 AI 辅助编码与部署即运行在 Pi 体系之上。

90.6k
GitHub star（快照）
11.2k
fork（快照）
活跃开源 · 稳定可用
项目状态
MIT
开源协议
打开 GitHub 仓库访问 pi.dev 官网从上手教程开始

创始人

我们收录的客观与主观信源记录。

创始人 / 核心作者

Mario Zechner

Pi Coding Agent / libGDX 创始人

创建 Pi Coding Agent 极简终端 Harness、libGDX 跨平台框架

人物页X

如何快速上手 Pi Coding Agent

3 步在终端拉起极简高效的 AI 编程助手

1

全局安装 CLI

通过 npm 安装 @earendil-works/pi-coding-agent，推荐带上 --ignore-scripts 参数。

npm install -g --ignore-scripts @earendil-works/pi-coding-agent
2

配置模型凭证 (API Key 或 Subscription)

导出对应模型的环境变量（如 ANTHROPIC_API_KEY / DEEPSEEK_API_KEY），或直接输入 `pi` 进入后运行 `/login` 进行订阅授权。

export ANTHROPIC_API_KEY=sk-ant-...
3

启动并执行开发任务

在项目根目录输入 `pi` 即可进入交互式 TUI。模型默认拥有 read、write、edit、bash 四个工具，直接对话即可修改代码或排查 bug。

pi

避坑指南 (Pitfalls)

基于我们一线开发中积累的实战边界与安全建议。

⚠️

默认没有多 Agent 编排与 Plan Mode

Pi 的哲学是保持核心极端轻量。如果你习惯了某些商业工具里繁琐的 Plan 模式或自动派发子代理，在 Pi 里需要通过安装 Extension 或使用自定义 Skill 来实现。

⚠️

npm 安装务必加 --ignore-scripts

官方推荐运行 `npm install -g --ignore-scripts @earendil-works/pi-coding-agent`，这样可以在安装全局 CLI 时跳过依赖的生命周期脚本，提升安全性和安装稳定性。

⚠️

模型权限与 Bash 执行边界

Pi 赋予模型在当前工作区执行任意 bash 命令的能力。在未容器化或生产服务器上操作时，建议配合只读目录、受限环境变量或沙箱环境使用。

4 种运行模式：满足各种集成场景

Pi 不仅仅是一个命令行工具。从日常终端交互、CI 批处理脚本，到桌面 GUI、网页版服务端和 TypeScript SDK，架构完全分层解耦。

  1. 01

    Interactive TUI

    全功能终端界面：语法高亮、快捷键队列、会话分支树（/branch）与自动压缩（/compact）。

  2. 02

    Print & JSON CLI

    命令行无界面单次执行模式（`pi -p 'task'`），专为 CI/CD 自动化与脚本管道设计。

  3. 03

    JSON-RPC Protocol

    通过 stdin/stdout 暴露结构化 JSON-RPC 协议，供网页版（pi-web）或桌面 GUI 进程无缝包装。

  4. 04

    TypeScript SDK

    将 Pi Agent 直接作为库引入 Node.js 项目中（如 openclaw），完全编程式掌控工具与状态流。

精选教程

全部教程

入门 · 2026-08-15

Pi Coding Agent 入门：4 个基础工具与极简终端工作流

不被商业黑盒和繁琐 Plan 模式绑架。用 read/write/edit/bash 4 个核心工具搭建纯净可控的开发流，一行 npm 安装并开启多模型对话。

进阶 · 2026-08-15

Pi Agent 扩展体系：编写你的第一个 TypeScript Extension 与 Skill

深入 Pi 的扩展机制：用 TypeScript 注册自定义工具、拦截生命周期事件、添加终端快捷键，并用 SKILL.md 固化团队沉淀。

进阶 · 2026-08-15

Pi Agent 与 Claude Code、Aider 架构对比：如何选型 Coding Agent

商业黑盒 vs 开源透明。从工具原子性、SDK 嵌入能力、会话状态树与扩展成本深度拆解三大主流 Coding Agent 选型。

和 Claude Code、Aider 深度对比

本对比基于各项目官方公开文档与开源许可，用于开发者技术选型。Pi Agent 适合希望完全掌控 Agent 行为、开发自定义扩展或将 Agent 嵌入自身系统的团队。

工具开源许可核心理念定制与扩展性嵌入与二次开发 (SDK/RPC)
Pi Agent (pi-coding-agent)MIT极简 4 工具底盘，零预设冗余，代码全透明TypeScript Extensions + Skills + Packages原生支持 TypeScript SDK 与 stdin/stdout RPC
Claude Code专有商业闭源Anthropic 官方全托管终端 Agent，开箱即用支持 Skills / hooks / MCP，内部循环不开放仅作为 CLI 工具运行，无独立二次开发 SDK
AiderApache-2.0专注于 Git 差异提交与代码重构配对编程支持自定义提示词与 repo map，无通用插件系统Python 库支持，主要面向命令行工作流

最新动态

  1. 2026-08-14 · npm & GitHub · 官方

    Pi Coding Agent 持续迭代，增强多模型流式与自定义扩展包生态

    npm 上 @earendil-works/pi-coding-agent 更新至 v0.84+，进一步完善会话树分支（branching）、自动压缩（compaction）与跨平台终端 TUI 体验。

  2. 2026-06-20 · X (@badlogicgames) · 官方

    Mario Zechner 发起开源 Coding Agent 会话共享倡议

    通过 pi-share-hf 将真实的开源编码会话数据集公开上传至 Hugging Face，推动大模型代码后训练与评测集的公开透明。

Pi Coding Agent 是什么：Mario Zechner 的极简开源 Coding Agent

老金精选推荐

90.6k ★ · 2026-08

Pi Coding Agent

Mario Zechner 开源的极简终端 coding harness：默认只给模型 4 个基础工具，零强制抽象，但靠 TypeScript 扩展、Skills 与 SDK 能改造成任何工作流。本站自身开发栈就跑在 Pi 上。

常见问题

Pi Agent（pi-coding-agent）是什么？
Pi 是一个极简、可高度定制的终端 Coding Agent 底座（Harness）。它默认只给模型 4 个基础工具（read / write / edit / bash），不强制绑定任何臃肿的 Plan Mode 或复杂的子代理抽象，但通过 TypeScript Extensions 和 Skills 允许你把 Agent 定制成任意你想要的工作流。
如何安装与启动 Pi？
一键全局安装：`npm install -g --ignore-scripts @earendil-works/pi-coding-agent`，或者使用安装脚本 `curl -fsSL https://pi.dev/install.sh | sh`。配置 API Key（如 ANTHROPIC_API_KEY / DEEPSEEK_API_KEY / OPENAI_API_KEY）或运行 `pi` 后使用 `/login` 订阅认证即可开始对话。
Pi 和 Claude Code、Cursor、Aider 有什么区别？
Claude Code 和 Cursor 是商业化黑盒产品，核心循环与内部逻辑封闭；Aider 专注于 Git 差异提交但扩展性有限。Pi 是完全开源且极度模块化的：UI、LLM 层（pi-ai）、运行时（pi-agent-core）与 CLI 解耦，并且原生支持作为 SDK 嵌入你自己的应用中。
什么是 Pi Extensions 和 Skills？
Skills 是以 SKILL.md 格式编写的流程知识（通过自然语言教 Agent 如何执行特定任务）；Extensions 是完整的 TypeScript 代码模块，可以拦截生命周期事件、注册自定义工具、监听键盘快捷键、甚至重写提示词组装。
Pi 可以在无界面的服务器或脚本中运行吗？
可以。Pi 原生支持 4 种运行模式：Interactive（交互式 TUI）、Print / JSON 模式（`pi -p 'task'` 直接输出结果退出）、RPC 模式（通过 stdin/stdout 与网页或桌面 GUI 进程通信）、以及 TypeScript SDK 嵌入。
针对企业与研发团队

需要基于 Harness 落地团队级 Agent 系统？

开源框架看似免费，但把「运行时」变成全公司都能用的「生产资产」，中间还有账号管控、RBAC权限沙箱、私有化知识库注入等无数脏活。老金出海技术团队提供商业级的 AI 底座架构与落地部署支持。

预约技术对接查看解决方案

引用本专区内容 (Cite this Hub)

我们鼓励你将本页内容沉淀至你的知识库、研究报告或直接让 AI Agent 读取。本站保持 CC BY 4.0 开放版权。

本专区如何更新

版本动态与链接在 src/content/pi-agent.ts 集中维护；新增教程、导航卡片与精选挂载到对应 slug 数组。数据快照通过 GitHub API 自动巡检更新。