Pi Coding Agent

Pi Coding Agent 是一个以终端为主要界面的开源 AI 编码代理，也是一套可扩展的 Agent Harness。它没有把所有工作流固定在产品内部，而是提供精简核心，再让开发者通过 TypeScript 扩展、Skills、Prompt 模板、主题和 Pi Packages 组合自己的工具链。

第一次运行怎样完成

1. 安装命令行：官方文档提供 npm install -g --ignore-scripts @earendil-works/pi-coding-agent；官网也列出 curl、PowerShell、pnpm 与 Bun 等入口，实际使用时优先选自己能审计的安装方式。
2. 连接模型：进入 Pi 后可用 /login 登录受支持的订阅服务，也可以通过对应环境变量提供 API Key。
3. 从项目目录启动：先让 Pi 读取仓库说明和少量明确任务，再逐步增加扩展与自动化，便于判断每一项权限是否必要。

Pi 本身采用 MIT 许可证，但模型调用、订阅额度和 API 费用由所选服务商决定，不能把“开源命令行工具”直接等同于“模型使用永久免费”。

四种模式对应不同工作流

如果只是本地辅助编程，从 Interactive 开始最直接；要接入自动化流水线，应优先评估 Print/JSON 或 RPC，而不是依赖终端界面模拟点击。

定制不是单一插件系统

• Extensions：用 TypeScript 注册工具、命令、事件和自定义界面，适合改变运行行为。
• Skills：按需加载任务说明与工具知识，适合复用有明确边界的工作流程。
• Prompt templates：把常用提示保存为 Markdown，并通过斜杠命令展开。
• Pi Packages：把扩展、Skills、提示模板和主题打包，经 npm 或 Git 分发。

需要自定义模型时可以通过 models.json 配置兼容接口；需要新的认证流程或 API 行为时，则应使用自定义 Provider 扩展。官网当前列出 Anthropic、OpenAI、Google、Azure、Bedrock、OpenRouter、Ollama 等多类服务，具体清单以最新文档为准。

会话历史适合分支探索

Pi 将会话保存为树状结构，可通过 /tree 回到较早节点并从那里继续，不必覆盖原分支；会话默认按工作目录保存为 JSONL，也可用 --no-session 运行不落盘的临时会话。导出或分享前仍应检查记录中是否包含源码、文件路径、工具输出与凭据片段。项目级 AGENTS.md、系统提示和上下文压缩机制则用于控制代理在当前仓库中看到什么、怎样保留较长任务的上下文。

默认没有的能力要先看清

Pi 官网明确把“原语优先”作为取向：核心默认不内置子代理、计划模式、权限弹窗、后台 Bash、待办系统或 MCP。这些能力可以通过扩展、第三方包、容器或外部工具补充，但首次使用者不应假设它们已经提供统一的审批和隔离机制。

尤其要注意，扩展可以获得本机完整权限并执行任意代码。安装第三方包前应检查来源、依赖和维护状态；在不熟悉的仓库中启用项目级扩展时，应先确认项目信任提示。处理敏感代码或高风险命令时，可参考官方安全与容器化文档，在 Docker、Gondolin 或其他隔离环境中运行。

谁更适合选择 Pi

Pi 更适合愿意在终端工作、需要自己决定模型与上下文结构，并希望把编码代理嵌入脚本或产品的开发者。若你需要开箱即用的图形 IDE、统一权限确认和固定团队流程，则应先评估定制成本；Pi 的优势来自可塑性，也意味着工作流治理需要由使用者主动设计。官网：https://pi.dev/