Pi 命令速查表 - earendil 终端多模型编码代理 CLI
Pi 的定位是终端里的多模型编码代理,与单模型 CLI 的区别在于同一会话内可以随时换模型而不丢上下文:探索阶段用便宜快的模型试方向,确定要落地的那一步再切到强模型重做,省下的不是 token 而是等待时间。这张表按安装与认证、交互会话、无头模式与脚本、会话与模型四组铺开。什么时候该翻它:你想把编码任务接进 CI 或 shell 管道,那就看无头模式那一组,-p 配合 --mode json 输出结构化事件是脚本友好的形态;如果你只是想在终端里边翻文件边让它解释,那交互会话那一组的 @ 引用和 / 命令就够。需要注意的判断标准是上下文成本:会话变长之后每次往返都按全量上下文计费,长改动前先压缩比事后补救便宜。
安装与认证 5
npm install -g @earendil-works/pi-coding-agent全局安装 Pi 编码代理
pi在项目目录启动交互会话
export ANTHROPIC_API_KEY=sk-ant-...用 API Key 认证后启动
/login交互式 OAuth 登录(Claude Pro/Max、ChatGPT Plus、Copilot)
/logout清除 OAuth 凭证
交互会话 4
pi @README.md "Summarize this"@ 引用文件作上下文
pi @src/app.ts @src/app.test.ts "Review these together"同时引用多个文件
!npm run lint会话内前缀 ! 直接跑 shell 命令
/new开新会话,清空上下文
无头模式与脚本 7
pi -p "Summarize this codebase"单次非交互执行后退出
cat README.md | pi -p "Summarize this text"管道传入内容交给 Pi
pi -p @screenshot.png "What is in this image?"无头模式处理图片
pi --mode json输出 JSON 事件流,便于程序解析
pi --mode rpc用 stdin/stdout 做进程集成
pi --name "my task"启动时给会话起名
pi --session <id>打开指定会话
会话与模型 7
pi -c继续最近一次会话
pi -r浏览并选择历史会话
/model切换模型
/compact [prompt]手动压缩上下文释放 token
/fork从某条消息 Fork 出新会话分支
/clone复制当前会话到新文件
/reload重载上下文文件与扩展
提示
- Pi 是多模型架构:用
/model或 Ctrl+L 随时切换,探索用便宜快模型、落地用强模型,同一会话上下文不丢。 pi -p无头模式配合--mode json输出结构化事件,是接进脚本和 CI 的事实标准。- @ 引用文件比把内容粘进提示词更准更省;大改动前用
/compact先压缩上下文释放 token。 - 会话里用
!npm run lint直接执行 shell 命令,验证改动比让它口头确认可靠。 pi -p @screenshot.png可直接把图片作为输入,做视觉类问答比先转文字再问更快。--mode rpc面向长驻进程的多轮调用,比反复起pi -p省掉每次冷启动。
常见问题
Pi 支持哪些模型提供商?
Pi 在 API 层统一了 OpenAI、Anthropic、Google 等主流厂商,支持 Claude Pro/Max、ChatGPT Plus/Pro(Codex)、GitHub Copilot 的订阅登录,也能用 ANTHROPIC_API_KEY、OPENAI_API_KEY、GEMINI_API_KEY 等 API Key 直连。
pi -p 和交互式会话有什么区别?
-p 是非交互的单次执行:命令一次性运行后直接输出结果并退出,适合脚本与流水线;交互式 pi 适合探索性开发,可多轮对话并修改文件。
由 巧匠 维护
公开更新于 2026年8月26日,内容持续校对官方文档。