Настройки

Pi использует файлы настроек JSON, в которых настройки проекта переопределяют глобальные настройки.

Редактируйте напрямую или используйте /settings для общих опций.

При интерактивном запуске pi спрашивает, прежде чем доверять папке проекта, которая содержит локальные настройки проекта, ресурсы или проект .agents/skills и не имеет сохраненного решения для этой папки или родительской папки в ~/.pi/agent/trust.json. Доверие к проекту позволяет pi загружать ресурсы .pi/settings.json и .pi, устанавливать недостающие пакеты проекта и выполнять расширения проекта.

В неинтерактивных режимах (-p, --mode json и --mode rpc) запрос доверия не отображается. Без применимого сохраненного решения о доверии они используют defaultProjectTrust из глобальных настроек: ask (по умолчанию) и never игнорируют эти ресурсы проекта, а always доверяют им. Нажмите --approve/-a или --no-approve/-na, чтобы отменить доверие проекта на один запуск.

Если никакое расширение или сохраненное решение не применимо, defaultProjectTrust управляет резервным поведением. Установите его на "ask", "always" или "never" в ~/.pi/agent/settings.json или измените его с помощью /settings.

pi config и команды пакета используют один и тот же поток доверия проекта, за исключением того, что pi update никогда не запрашивает. Нажмите --approve, чтобы доверять локальным настройкам проекта для одной команды, или --no-approve, чтобы игнорировать их.

Используйте /trust в интерактивном режиме, чтобы сохранить решение о доверии проекта для будущих сеансов, включая доверие к непосредственной родительской папке. Пишется только ~/.pi/agent/trust.json; текущий сеанс не перезагружается, поэтому перезапустите pi, чтобы изменения вступили в силу.

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

Для VS Code добавьте --wait, чтобы pi возобновил работу после выхода из редактора:

{
  "externalEditor": "code --wait"
}

enableInstallTelemetry контролирует только анонимный пинг установки/обновления до https://pi.dev/api/report-install. Отказ от телеметрии не отключает проверку обновлений; Pi по-прежнему может получить https://pi.dev/api/latest-version для поиска последней версии.

Установите PI_SKIP_VERSION_CHECK=1, чтобы отключить проверку обновления версии Pi. Используйте --offline или PI_OFFLINE=1, чтобы отключить все описанные здесь сетевые операции при запуске, включая проверки обновлений, проверки обновлений пакетов и телеметрию установки/обновления.

{
  "httpProxy": "http://127.0.0.1:7890"
}

{
  "warnings": {
    "anthropicExtraUsage": false
  }
}

{
  "compaction": {
    "enabled": true,
    "reserveTokens": 16384,
    "keepRecentTokens": 20000
  }
}

Когда провайдер запрашивает задержку повтора дольше, чем retry.provider.maxRetryDelayMs, запрос немедленно завершается с ошибкой, а не молча ждет. Установите его на 0, чтобы отключить ограничение.

Оставьте retry.provider.maxRetries на 0, если повторные попытки на уровне поставщика явно не требуются. Установка значения выше 0 может привести к тому, что SDK/повторные попытки поставщика будут обрабатывать ошибки превышения лимита использования до того, как Pi увидит их, что может заблокировать агент до тех пор, пока в некоторых обстоятельствах квота провайдера не будет сброшена.

{
  "retry": {
    "enabled": true,
    "maxRetries": 3,
    "baseDelayMs": 2000,
    "provider": {
      "timeoutMs": 3600000,
      "maxRetries": 0,
      "maxRetryDelayMs": 60000
    }
  }
}

{
  "npmCommand": ["mise", "exec", "node@20", "--", "npm"]
}

npmCommand используется для всех операций менеджера пакетов npm, включая установку, удаление и установку зависимостей внутри пакетов git. Пакеты npm на уровне пользователя устанавливаются в ~/.pi/agent/npm/; Пакеты npm в рамках проекта устанавливаются в .pi/npm/. Используйте записи в стиле argv именно так, как должен быть запущен процесс. Когда настроен npmCommand, при установке зависимостей пакетов git используется простой install, чтобы избежать использования флагов, специфичных для npm, в оболочках или альтернативных менеджерах пакетов.

{ "sessionDir": ".pi/sessions" }

Если несколько источников указывают каталог сеанса, приоритет имеет значение --session-dir, PI_CODING_AGENT_SESSION_DIR, а затем sessionDir в файле settings.json.

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

Эти настройки определяют, откуда загружать расширения, навыки, подсказки и темы.

Пути в ~/.pi/agent/settings.json разрешаются относительно ~/.pi/agent. Пути в .pi/settings.json разрешаются относительно .pi. Поддерживаются абсолютные пути и ~.

Массивы поддерживают шаблоны glob и исключения. Используйте !pattern, чтобы исключить. Используйте +path, чтобы принудительно включить точный путь, и -path, чтобы принудительно исключить точный путь.

Строковая форма загружает все ресурсы из пакета:

{
  "packages": ["pi-skills", "@org/my-extension"]
}

Форма объекта фильтрует, какие ресурсы загружать:

{
  "packages": [
    {
      "source": "pi-skills",
      "skills": ["brave-search", "transcribe"],
      "extensions": []
    }
  ]
}

См. packages.md для получения подробной информации об управлении пакетами.

{
  "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/agent/settings.json (global)
{
  "theme": "dark",
  "compaction": { "enabled": true, "reserveTokens": 16384 }
}

// .pi/settings.json (project)
{
  "compaction": { "reserveTokens": 8192 }
}

// Result
{
  "theme": "dark",
  "compaction": { "enabled": true, "reserveTokens": 8192 }
}