Pi 快速上手指南

安装

# npm 全局安装（推荐加 --ignore-scripts 禁用依赖生命周期脚本）
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
 
# 或使用安装脚本
curl -fsSL https://pi.dev/install.sh | sh

认证

API Key（最简单）：

export ANTHROPIC_API_KEY=sk-ant-...
pi

OAuth 订阅（Claude Pro/Max / ChatGPT Plus/Pro / GitHub Copilot）：

pi
/login   # 选择 Provider，按提示完成 OAuth 认证

第一次运行

启动 pi 进入交互模式，直接对话：

pi
> What files are in the current directory?

Pi 默认配备四个工具：read、write、edit、bash。

非交互用法

# 打印模式（输出后退出）
pi -p "Summarize README.md"
 
# 管道输入
cat README.md | pi -p "Summarize this"
 
# 继续最近的会话
pi -c
 
# 指定模型
pi --provider anthropic --model claude-opus-4-5

常用配置

编辑 ~/.pi/agent/settings.json：

{
  "defaultThinkingLevel": "low",
  "theme": "dark",
  "autoCompact": true,
  "defaultProjectTrust": "ask"
}

或在交互模式中用 /settings 进行可视化配置。

项目级配置

在项目根目录创建 .pi/settings.json（需项目信任才加载）或 AGENTS.md 提供项目上下文。

添加扩展能力

# 安装第三方 pi 包
pi install npm:@foo/pi-tools
 
# 临时加载本地扩展
pi -e ./my-extension.ts
 
# 查看已安装包
pi list
 
# 启用/禁用包中的资源
pi config

相关页面：cli-reference | settings | providers