Pi Agent：一个更轻、更快、更适合本地工作的 AI Agent

最近我已经变成 Pi Agent 的重度使用用户了。一开始只是试一下，结果越用越喜欢。它给我的感觉不是"又一个 Claude Code 平替"，而是另一种完全不同的 Agent 思路。

Pi 和 Claude Code 有什么区别

Claude Code 更像一个大而全的产品。它把很多东西都提前给你准备好了：权限控制、子智能体、计划模式、任务列表、MCP、Web 工具、各种默认规则。你拿起来就能用，但也不可避免地带来一个问题：系统越来越重，提示词越来越长，上下文越来越复杂。

Pi Agent 刚好走了另一条路。它的核心非常小。系统提示词非常短。默认工具非常少。很多功能不是硬塞进核心里，而是交给 skill、extension、package、脚本和你自己的工作流来组合。Pi 很轻，很快，也很适合日常任务。

安装与配置

npm install -g --ignore-scripts @earendil-works/pi-coding-agent
cd /path/to/project
pi
# 首次配置：/login 或设置 ANTHROPIC_API_KEY

Pi 不是绑定某一个模型的工具，它更像一个开放的 Agent 外壳。支持 Anthropic、OpenAI、Google、OpenRouter、Ollama 等多种模型提供商。

核心功能

• AGENTS.md 项目规则：在项目根目录写 AGENTS.md，Pi 自动读取并遵守你的工程规范
• Skill 系统：可复用能力包，按需加载，不占用核心上下文
• Package 生态：通过 npm/git 分发的扩展包，支持 web search、subagents、MCP adapter 等
• Extension 扩展：可以注册命令、修改 UI、监听事件、改变上下文注入方式

实用场景

• 项目体检：先让 Pi 只读分析项目结构，输出报告后再动手
• 内容生产：通过 wechat-article skill 把资料整理成公众号文章
• 本地自动化：整理目录、批量重命名、PDF 转 Markdown、录音转文字等
• 多 skill 串联：web 搜索 → GitHub 阅读 → code review → 写文章 → 生成封面

设计哲学

Pi 的核心设计理念：核心越小，控制越强；默认越少，组合越灵活。

不是所有任务都需要开重型 Agent。有些任务只是读一下文件、改一个小 bug、生成一个脚本、整理一个文档、跑一下测试。这种时候，Pi 的轻量感非常舒服。

使用建议

1. 先在只读任务上试用
2. 引入 AGENTS.md 让项目规则固化
3. 按需安装少量 skills
4. 把重复任务沉淀成自己的 skill
5. 再考虑 package 和 extension