#Settings

本页面是 Pi 官方文档 的中文翻译。仅供学习参考。

Pi 使用 JSON 设置文件，项目级配置优先于全局配置。

• 全局设置位置：~/.pi/agent/settings.json
• 项目设置位置：.pi/settings.json（当前目录）

可以直接编辑文件，或使用 /settings 进行常用选项配置。

#所有设置项

#模型和思维（Model & Thinking）

{
  "thinkingBudgets": {
    "minimal": 1024,
    "low": 4096,
    "medium": 10240,
    "high": 32768
  }
}

#UI 和显示

#遥测和更新检查

enableInstallTelemetry 仅控制发送到 https://pi.dev/api/report-install 的匿名安装 ping。退出遥测不会影响版本检查。禁用版本更新检查设置 PI_SKIP_VERSION_CHECK=1。禁用所有启动网络操作使用 --offline 或 PI_OFFLINE=1。

#Compaction（压缩）

#Branch Summary（分支摘要）

#Retry（重试）

#消息传递

#终端和图像

#Shell

#会话

优先级：--session-dir 标志 > PI_CODING_AGENT_SESSION_DIR 环境变量 > settings.json 中的 sessionDir。

#模型循环

{
  "enabledModels": ["claude-*", "gpt-4o", "gemini-2*"]
}

#资源

• packages —— npm/git 包
• extensions —— 本地扩展路径
• skills —— 本地 Skill 路径
• prompts —— 本地 Prompt 模板路径
• themes —— 本地主题路径
• enableSkillCommands —— 将 Skills 注册为 /skill:name 命令

#完整设置文件示例

{
  "defaultProvider": "anthropic",
  "defaultModel": "claude-sonnet-4-20250514",
  "defaultThinkingLevel": "medium",
  "theme": "dark",
  "compaction": {
    "enabled": true,
    "reserveTokens": 16384,
    "keepRecentTokens": 20000
  },
  "retry": {
    "enabled": true,
    "maxRetries": 3
  },
  "enabledModels": ["claude-*", "gpt-4o"],
  "warnings": {
    "anthropicExtraUsage": true
  },
  "packages": ["pi-skills"]
}

#项目覆盖

项目设置（.pi/settings.json）覆盖全局设置，嵌套对象会合并而非完全替换。

法律声明：本页面是 pi.dev 官方文档的中文翻译版本，仅供学习参考。本网站与 pi.dev 及 Earendil Inc. 无任何法律关系。