Skip to main content
Pi 走本机 pi。认证和模型留在 ~/.pi/。打开 设置 → CLI配置管理 → PI CLI 检测版本、安装，并配置凭证。

​
接入方式

  1. 在该页覆盖 pi 可执行文件路径（可选）
  2. 在 供应商认证 里填 API Key，或点 登录 走订阅授权
  3. 未安装时在该页点 安装，或按下面的终端命令安装
配置只存在你的电脑上。客户端不会把 Key 上传到 CC GUI 自己的服务器。

​
供应商认证

​
API Key

写入 ~/.pi/agent/auth.json（权限 0600），优先级高于环境变量。 常用项包括 Anthropic、OpenAI、Google Gemini、DeepSeek、xAI、OpenRouter、Groq、Mistral、智谱、Kimi For Coding、Qwen、MiniMax。其余供应商折叠在 显示全部。

​
订阅授权

点 登录：客户端打开内置终端启动 pi，再发送 /login anthropic 这类命令。也可以自己在系统终端执行 pi /login。 客户端不代你走 OAuth，只读 auth.json 状态。支持：
  • Claude Pro / Max（pi /login anthropic）
  • ChatGPT Plus / Pro (Codex)（pi /login openai）
  • GitHub Copilot
  • xAI
  • OpenRouter
  • Radius

​
解析顺序

--api-key → auth.json → 环境变量 → models.json

​
安装

备选：
应用内 安装 预览的是备选里的 npm install -g @earendil-works/pi-coding-agent。 文档：https://pi.dev/docs/latest/usage

​
能力差异

相对 Claude Code：
  • 没有规划模式
  • 不走客户端 MCP
  • 支持推理强度、会话续写与图片输入
  • 停止按钮会结束 pi 子进程
  • 历史按 runtime 隔离

​
检测失败时

见 检测与安装。

​
下一步