Pi实战 17把 Pi 打造成 Claude Code——插件清单 配置全流程来源Pi 官方文档与 Package 目录、pi-code/tintinweb/pi-subagents/pi-permission-system等包的官方 README以及社区迁移实践。Pi 和 Claude Code 坐在定制光谱的两端Claude Code 是开箱即用的成品Pi 是只有四个工具的骨架。把 Pi 捏成 Claude Code本质就是把它故意不内置的那些能力用扩展一件件补回来。本文给你两条路线 一份从零到能用的配置全流程。一、先对齐Claude Code 有的Pi 到底缺什么Claude Code 的能力Pi 默认怎么补子代理Task 工具无tintinweb/pi-subagentsPlan mode先规划后动手无plan-mode 扩展权限弹窗 / 危险命令拦截无bash 完全放开pi-permission-systemto-do 列表 / checkpoints无pi-code记忆跨会话无pi-memoryWeb 搜索无pi-web-accessMCP 支持无pi-mcp-adapterUndo / Redo无pi-undo-redo状态栏 / 输出样式极简pi-powerline-footerGit / 代码审查内置/git-commitdiegopetrucci/pi-reviewSkills原生支持原生 badlogic/pi-skills核心心智在 Pi 里“功能” “扩展”。装一个、/reload、它就多一个能力。没有这功能坏了只有这功能我还没装/还没写。二、路线 Api-code一体化推荐先试如果你想最省事地接近 Claude Code甚至你本来就有 Claude Code 项目先装这个。装piinstallnpm:pi-code它一次干两件事读你现有的.claude/配置——rules、commands、skills、hooks、输出样式、MCP servers、agents 全部复用。你从 Claude Code 迁过来配置几乎零成本。补上 Pi 缺的 Claude Code 能力——to-do 覆盖层、checkpoints、记忆、web 搜索、子代理、goals。典型用法cd你那个带 .claude/ 的项目 pi# pi-code 自动加载 .claude/rules、commands、skills之后你在 Claude Code 里那套规则、斜杠命令、技能在 Pi 里照样生效。一个加分项它在安全上比 Claude 更严——Claude 的claude -p头次运行从不弹信任框、照样加载项目的 hooks/MCPpi-code 在无存储决策、无 UI 可问的头次运行时会拒绝加载这些。否则任何 CI 拉一下仓库就能自己跑 hooks/MCP没人能拦。提醒pi-code是个大包具体命令/用法以它加载后的提示为准想精细控制每个能力走路线 B。三、路线 B逐个能力补齐可控性最高按这张表缺哪个补哪个能力包装法子代理最贴近 Claude Code 的 Task 工具tintinweb/pi-subagentspi install npm:tintinweb/pi-subagents权限闸门 / 危险命令拦截pi-permission-systempi install npm:pi-permission-system计划模式plan-mode 扩展Pi 官方仓库也自带示例pi.dev/packages 搜plan-modeMCP 支持pi-mcp-adapterpi install npm:pi-mcp-adapter记忆pi-memorypi install npm:pi-memoryWeb 搜索 / 抓取pi-web-accesspi install npm:pi-web-accessUndo / Redopi-undo-redopi install npm:pi-undo-redo状态栏pi-powerline-footerpi install npm:pi-powerline-footer代码审查diegopetrucci/pi-review 内置/git-commitpi install npm:diegopetrucci/pi-review技能兼容 Claude Code/Codex 格式badlogic/pi-skillsgit clone到技能目录最该单独装的tintinweb/pi-subagents——并行执行、实时 widget、fleet 视图、自定义 agent 类型general-purpose/Explore/Plan、运行中纠偏steer、完成会话可 resume。这是最贴近 Claude Code 子代理手感的扩展。四、配置全流程从零到能用1. 装 Pi 认证npminstall-g--ignore-scripts earendil-works/pi-coding-agent pi /login# 或用 API key见 ~/.pi/agent/models.json2. 配模型vim~/.pi/agent/models.jsonPi 不挑模型——Claude、GPT、Gemini、GLM、Kimi、本地 Ollama 都能接。注意Claude 模型在 Pi 上走API 计费Anthropic 已禁止第三方 agent 用订阅见第六节。3. 装扩展 热重载piinstallnpm:pi-permission-system piinstallnpm:tintinweb/pi-subagents /reload# 多数扩展装完敲这个即生效无需重启4. 配权限最关键的一步Pi 默认 bash 完全放开务必装权限系统并配permissions.jsonc# 全局~/.pi/agent/permissions.jsonc# 项目cwd/.pi/agent/permissions.jsonc一份可直接改的配置allow/ask/deny三态{ read: { : allow }, edit: { /.ssh/: deny, /.gnupg/: deny, : allow }, write: { /.ssh/: deny, /.gnupg/: deny, : allow }, bash: { .: allow, // 默认允许 rm\\s-rf\\s/.: deny, // 禁止 rm -rf dropdb\\b.: ask, // dropdb 需确认 sudo\\b.: ask // sudo 需确认 } }效果read全放、.ssh/.gnupg禁写、rm -rf直接拦、sudo/dropdb弹窗问你。5. 写项目约束Pi 读AGENTS.md也兼容CLAUDE.md——把你希望它遵守的约定、规范、禁忌写进去。用pi-code的话直接把.claude/带过来即可。6. 配沙箱危险项目必做光有权限闸门不够它尽量拦不是铜墙铁壁。敏感项目把 agent 关进沙箱# 沙箱配置可选给 sandbox 类扩展用vim~/.pi/agent/sandbox.json# 或用 Docker代码不出容器dockerrun--rm-it-v$PWD:/workspace-vpi-agent-home:/root/.pi/agent镜像沙箱强度从内置sandbox扩展 → Gondolin 微 VM → Docker → Bubblewrap按需挑一层详见 05 · 本地模型 · MCP · 安全沙箱篇。五、懒人版最小可用组合不想逐个个试就这三条命令装完就是一个像样的 Claude Code 替代品piinstallnpm:pi-code# 一体化体验 复用 .claude/piinstallnpm:tintinweb/pi-subagents# 子代理piinstallnpm:pi-permission-system# 权限闸门/reload然后配好permissions.jsonc就能用了。六、避坑几句真话默认等于--dangerously-skip-permissions。Pi 的 bash 天生无限制权限扩展只是尽量拦。强烈建议危险活在沙箱或独立 VM里跑别裸跑。Claude 要花钱。Anthropic 已禁止第三方 agent 用 Claude 订阅Pi 上用 Claude 走 API 计费。这也是很多人Claude Code 做日常、Pi 做深度定制双修的原因。别一次装太满。每多一个扩展就多一份上下文和复杂度按需加。Pi 的强项是可定制不是开箱即用。想要边缘都打磨好的 universal 产品它还没到想要完全按我想法捏它无敌——缺什么功能装不到就让 Pi 自己写一个扩展这是它的招牌能力。.claude/是迁移红利。你已有的 Claude Code 投资规则、命令、技能不会被浪费pi-code直接读。参考资料Pi 官方 Package 目录https://pi.dev/packagespi-codehttps://pi.dev/packages/pi-codetintinweb/pi-subagentshttps://pi.dev/packages/tintinweb/pi-subagents GitHubhttps://github.com/tintinweb/pi-subagentspi-permission-systemhttps://pi.dev/packages/pi-permission-systempi-web-accesshttps://pi.dev/packages/pi-web-accessbadlogic/pi-skills与 Claude Code/Codex 兼容https://github.com/badlogic/pi-skills对比与迁移实践https://composio.dev/content/pi-agent-vs-claude-code https://agenticengineer.com/the-only-claude-code-competitor上一篇16 · addyosmani/agent-skills 
长河君 · 2026/10/27 17:47:46 · 阅读 1.2k Pi实战 17：把 Pi 打造成 Claude Code——插件清单 + 配置全流程
Pi实战 17把 Pi 打造成 Claude Code——插件清单 配置全流程来源Pi 官方文档与 Package 目录、pi-code/tintinweb/pi-subagents/pi-permission-system等包的官方 README以及社区迁移实践。Pi 和 Claude Code 坐在定制光谱的两端Claude Code 是开箱即用的成品Pi 是只有四个工具的骨架。把 Pi 捏成 Claude Code本质就是把它故意不内置的那些能力用扩展一件件补回来。本文给你两条路线 一份从零到能用的配置全流程。一、先对齐Claude Code 有的Pi 到底缺什么Claude Code 的能力Pi 默认怎么补子代理Task 工具无tintinweb/pi-subagentsPlan mode先规划后动手无plan-mode 扩展权限弹窗 / 危险命令拦截无bash 完全放开pi-permission-systemto-do 列表 / checkpoints无pi-code记忆跨会话无pi-memoryWeb 搜索无pi-web-accessMCP 支持无pi-mcp-adapterUndo / Redo无pi-undo-redo状态栏 / 输出样式极简pi-powerline-footerGit / 代码审查内置/git-commitdiegopetrucci/pi-reviewSkills原生支持原生 badlogic/pi-skills核心心智在 Pi 里“功能” “扩展”。装一个、/reload、它就多一个能力。没有这功能坏了只有这功能我还没装/还没写。二、路线 Api-code一体化推荐先试如果你想最省事地接近 Claude Code甚至你本来就有 Claude Code 项目先装这个。装piinstallnpm:pi-code它一次干两件事读你现有的.claude/配置——rules、commands、skills、hooks、输出样式、MCP servers、agents 全部复用。你从 Claude Code 迁过来配置几乎零成本。补上 Pi 缺的 Claude Code 能力——to-do 覆盖层、checkpoints、记忆、web 搜索、子代理、goals。典型用法cd你那个带 .claude/ 的项目 pi# pi-code 自动加载 .claude/rules、commands、skills之后你在 Claude Code 里那套规则、斜杠命令、技能在 Pi 里照样生效。一个加分项它在安全上比 Claude 更严——Claude 的claude -p头次运行从不弹信任框、照样加载项目的 hooks/MCPpi-code 在无存储决策、无 UI 可问的头次运行时会拒绝加载这些。否则任何 CI 拉一下仓库就能自己跑 hooks/MCP没人能拦。提醒pi-code是个大包具体命令/用法以它加载后的提示为准想精细控制每个能力走路线 B。三、路线 B逐个能力补齐可控性最高按这张表缺哪个补哪个能力包装法子代理最贴近 Claude Code 的 Task 工具tintinweb/pi-subagentspi install npm:tintinweb/pi-subagents权限闸门 / 危险命令拦截pi-permission-systempi install npm:pi-permission-system计划模式plan-mode 扩展Pi 官方仓库也自带示例pi.dev/packages 搜plan-modeMCP 支持pi-mcp-adapterpi install npm:pi-mcp-adapter记忆pi-memorypi install npm:pi-memoryWeb 搜索 / 抓取pi-web-accesspi install npm:pi-web-accessUndo / Redopi-undo-redopi install npm:pi-undo-redo状态栏pi-powerline-footerpi install npm:pi-powerline-footer代码审查diegopetrucci/pi-review 内置/git-commitpi install npm:diegopetrucci/pi-review技能兼容 Claude Code/Codex 格式badlogic/pi-skillsgit clone到技能目录最该单独装的tintinweb/pi-subagents——并行执行、实时 widget、fleet 视图、自定义 agent 类型general-purpose/Explore/Plan、运行中纠偏steer、完成会话可 resume。这是最贴近 Claude Code 子代理手感的扩展。四、配置全流程从零到能用1. 装 Pi 认证npminstall-g--ignore-scripts earendil-works/pi-coding-agent pi /login# 或用 API key见 ~/.pi/agent/models.json2. 配模型vim~/.pi/agent/models.jsonPi 不挑模型——Claude、GPT、Gemini、GLM、Kimi、本地 Ollama 都能接。注意Claude 模型在 Pi 上走API 计费Anthropic 已禁止第三方 agent 用订阅见第六节。3. 装扩展 热重载piinstallnpm:pi-permission-system piinstallnpm:tintinweb/pi-subagents /reload# 多数扩展装完敲这个即生效无需重启4. 配权限最关键的一步Pi 默认 bash 完全放开务必装权限系统并配permissions.jsonc# 全局~/.pi/agent/permissions.jsonc# 项目cwd/.pi/agent/permissions.jsonc一份可直接改的配置allow/ask/deny三态{ read: { : allow }, edit: { /.ssh/: deny, /.gnupg/: deny, : allow }, write: { /.ssh/: deny, /.gnupg/: deny, : allow }, bash: { .: allow, // 默认允许 rm\\s-rf\\s/.: deny, // 禁止 rm -rf dropdb\\b.: ask, // dropdb 需确认 sudo\\b.: ask // sudo 需确认 } }效果read全放、.ssh/.gnupg禁写、rm -rf直接拦、sudo/dropdb弹窗问你。5. 写项目约束Pi 读AGENTS.md也兼容CLAUDE.md——把你希望它遵守的约定、规范、禁忌写进去。用pi-code的话直接把.claude/带过来即可。6. 配沙箱危险项目必做光有权限闸门不够它尽量拦不是铜墙铁壁。敏感项目把 agent 关进沙箱# 沙箱配置可选给 sandbox 类扩展用vim~/.pi/agent/sandbox.json# 或用 Docker代码不出容器dockerrun--rm-it-v$PWD:/workspace-vpi-agent-home:/root/.pi/agent镜像沙箱强度从内置sandbox扩展 → Gondolin 微 VM → Docker → Bubblewrap按需挑一层详见 05 · 本地模型 · MCP · 安全沙箱篇。五、懒人版最小可用组合不想逐个个试就这三条命令装完就是一个像样的 Claude Code 替代品piinstallnpm:pi-code# 一体化体验 复用 .claude/piinstallnpm:tintinweb/pi-subagents# 子代理piinstallnpm:pi-permission-system# 权限闸门/reload然后配好permissions.jsonc就能用了。六、避坑几句真话默认等于--dangerously-skip-permissions。Pi 的 bash 天生无限制权限扩展只是尽量拦。强烈建议危险活在沙箱或独立 VM里跑别裸跑。Claude 要花钱。Anthropic 已禁止第三方 agent 用 Claude 订阅Pi 上用 Claude 走 API 计费。这也是很多人Claude Code 做日常、Pi 做深度定制双修的原因。别一次装太满。每多一个扩展就多一份上下文和复杂度按需加。Pi 的强项是可定制不是开箱即用。想要边缘都打磨好的 universal 产品它还没到想要完全按我想法捏它无敌——缺什么功能装不到就让 Pi 自己写一个扩展这是它的招牌能力。.claude/是迁移红利。你已有的 Claude Code 投资规则、命令、技能不会被浪费pi-code直接读。参考资料Pi 官方 Package 目录https://pi.dev/packagespi-codehttps://pi.dev/packages/pi-codetintinweb/pi-subagentshttps://pi.dev/packages/tintinweb/pi-subagents GitHubhttps://github.com/tintinweb/pi-subagentspi-permission-systemhttps://pi.dev/packages/pi-permission-systempi-web-accesshttps://pi.dev/packages/pi-web-accessbadlogic/pi-skills与 Claude Code/Codex 兼容https://github.com/badlogic/pi-skills对比与迁移实践https://composio.dev/content/pi-agent-vs-claude-code https://agenticengineer.com/the-only-claude-code-competitor上一篇16 · addyosmani/agent-skills