Pi 命令速查表 - earendil 终端多模型编码代理 CLI
Pi 终端编码代理命令都在这里了，从安装认证到交互/无头模式、从会话管理到模型切换，按场景分类整理，复制即用。
安装与认证 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。
常见问题
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日，内容持续校对官方文档。