Pi Settings — 配置参考

配置文件位置

文件	作用域
~/.pi/agent/settings.json	全局（所有项目）
.pi/settings.json	项目级（需项目信任才加载）

项目级配置会覆盖全局配置。

常用配置项

{
  "defaultThinkingLevel": "low",
  "theme": "dark",
  "autoCompact": true,
  "defaultProjectTrust": "ask",
  "steeringMode": "one-at-a-time",
  "followUpMode": "one-at-a-time",
  "transport": "auto",
  "enableInstallTelemetry": true,
  "npmCommand": ["mise", "exec", "node@20", "--", "npm"]
}

字段	取值	说明
defaultThinkingLevel	off/minimal/low/medium/high/xhigh	默认 thinking level
theme	dark/light/自定义	终端主题
autoCompact	true/false	是否自动压缩 context
defaultProjectTrust	ask/always/never	未知项目的默认信任策略
steeringMode	one-at-a-time/all	转向消息投递模式
followUpMode	one-at-a-time/all	后续消息投递模式
transport	sse/websocket/auto	Provider 传输偏好
enableInstallTelemetry	true/false	安装/更新遥测及 Provider 归因
npmCommand	字符串数组	自定义 npm 命令（Node 版本管理器场景）

交互式配置

在 pi 中输入 /settings 进行可视化配置（thinking level、主题、消息投递方式、传输协议）。

遥测与版本检查

Pi 有两个独立的启动特性：

1. 版本检查：访问 https://pi.dev/api/latest-version，用 PI_SKIP_VERSION_CHECK=1 禁用
2. 安装遥测：首次安装或更新后发送匿名 ping 到 https://pi.dev/api/report-install，同时控制 OpenRouter、Cloudflare、NVIDIA NIM 的可选 Provider 归因 header。用 enableInstallTelemetry: false 或 PI_TELEMETRY=0 关闭

全部禁用：--offline 或 PI_OFFLINE=1

System Prompt 自定义

文件	说明
.pi/SYSTEM.md	替换默认 system prompt（项目级）
~/.pi/agent/SYSTEM.md	替换默认 system prompt（全局）
APPEND_SYSTEM.md	在默认 system prompt 后追加

相关页面：quick-start | cli-reference | sessions