Einstellungen

Pi verwendet JSON Einstellungsdateien, wobei die Projekteinstellungen die globalen Einstellungen überschreiben.

Direkt bearbeiten oder /settings für allgemeine Optionen verwenden.

Beim interaktiven Start fragt pi nach, bevor es einem Projektordner vertraut, der projektlokale Einstellungen, Ressourcen oder Projekt .agents/skills enthält und keine gespeicherte Entscheidung für den Ordner oder einen übergeordneten Ordner in ~/.pi/agent/trust.json hat. Durch das Vertrauen in ein Projekt kann Pi .pi/settings.json- und .pi-Ressourcen laden, fehlende Projektpakete installieren und Projekterweiterungen ausführen.

In den nicht interaktiven Modi (-p, --mode json und --mode rpc) wird keine Vertrauensaufforderung angezeigt. Ohne eine anwendbare gespeicherte Vertrauensentscheidung verwenden sie defaultProjectTrust aus den globalen Einstellungen: ask (Standard) und never ignorieren diese Projektressourcen, während always ihnen vertraut. Übergeben Sie --approve/-a oder --no-approve/-na, um die Projektvertrauenswürdigkeit für einen Lauf zu überschreiben.

Wenn keine Erweiterung oder gespeicherte Entscheidung gilt, steuert defaultProjectTrust das Fallback-Verhalten. Stellen Sie es auf "ask", "always" oder "never" in ~/.pi/agent/settings.json ein oder ändern Sie es mit /settings.

pi config- ​​und Paketbefehle verwenden denselben Projekt-Vertrauensfluss, mit der Ausnahme, dass pi update nie dazu auffordert. Übergeben Sie --approve, um projektlokalen Einstellungen für einen Befehl zu vertrauen, oder --no-approve, um sie zu ignorieren.

Verwenden Sie /trust im interaktiven Modus, um eine Projektvertrauensentscheidung für zukünftige Sitzungen zu speichern, einschließlich der Vertrauenswürdigkeit für den unmittelbar übergeordneten Ordner. Es schreibt nur ~/.pi/agent/trust.json; Die aktuelle Sitzung wird nicht neu geladen. Starten Sie daher pi neu, damit die Änderungen wirksam werden.

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

Fügen Sie für VS-Code --wait ein, damit Pi nach dem Beenden des Editors fortgesetzt wird:

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

enableInstallTelemetry steuert nur den anonymen Installations-/Update-Ping auf https://pi.dev/api/report-install. Durch die Deaktivierung der Telemetrie werden Updateprüfungen nicht deaktiviert; Pi kann weiterhin https://pi.dev/api/latest-version abrufen, um nach der neuesten Version zu suchen.

Stellen Sie PI_SKIP_VERSION_CHECK=1 ein, um die Pi Versionsaktualisierungsprüfung zu deaktivieren. Verwenden Sie --offline oder PI_OFFLINE=1, um alle hier beschriebenen Startnetzwerkvorgänge zu deaktivieren, einschließlich Updateprüfungen, Paketaktualisierungsprüfungen und Installations-/Update-Telemetrie.

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

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

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

Wenn ein Anbieter eine Wiederholungsverzögerung von mehr als retry.provider.maxRetryDelayMs anfordert, schlägt die Anfrage sofort mit einem informativen Fehler fehl, anstatt stillschweigend zu warten. Setzen Sie es auf 0, um das Limit zu deaktivieren.

Behalten Sie retry.provider.maxRetries bei 0, es sei denn, Wiederholungsversuche auf Anbieterebene sind ausdrücklich erforderlich. Wenn Sie den Wert über 0 setzen, kann dies dazu führen, dass SDK/Provider-Wiederholungsfehler Fehler außerhalb des Nutzungslimits behandeln, bevor Pi sie erkennt, was unter bestimmten Umständen den Agenten blockieren kann, bis das Provider-Kontingent zurückgesetzt wird.

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

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

npmCommand wird für alle npm Paketmanager-Vorgänge verwendet, einschließlich Installationen, Deinstallationen und Abhängigkeitsinstallationen innerhalb von Git-Paketen. Benutzerspezifische npm-Pakete werden unter ~/.pi/agent/npm/ installiert; Projektbezogene npm-Pakete werden unter .pi/npm/ installiert. Verwenden Sie Einträge im argv-Stil genau so, wie der Prozess gestartet werden soll. Wenn npmCommand konfiguriert ist, verwenden Git-Paketabhängigkeitsinstallationen einfaches install, um npm-spezifische Flags in Wrappern oder alternativen Paketmanagern zu vermeiden.

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

Wenn mehrere Quellen ein Sitzungsverzeichnis angeben, ist die Priorität --session-dir, PI_CODING_AGENT_SESSION_DIR und dann sessionDir in Settings.json.

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

Diese Einstellungen legen fest, woher Erweiterungen, Fertigkeiten, Eingabeaufforderungen und Themen geladen werden sollen.

Pfade in ~/.pi/agent/settings.json werden relativ zu ~/.pi/agent aufgelöst. Pfade in .pi/settings.json werden relativ zu .pi aufgelöst. Absolute Pfade und ~ werden unterstützt.

Arrays unterstützen Globmuster und Ausschlüsse. Verwenden Sie !pattern zum Ausschließen. Verwenden Sie +path, um das Einschließen eines genauen Pfads zu erzwingen, und -path, um das Ausschließen eines genauen Pfads zu erzwingen.

Die Zeichenfolgenform lädt alle Ressourcen aus einem Paket:

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

Das Objektformular filtert, welche Ressourcen geladen werden sollen:

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

Einzelheiten zur Paketverwaltung finden Sie unter 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"]
}

Projekteinstellungen (.pi/settings.json) überschreiben globale Einstellungen. Verschachtelte Objekte werden zusammengeführt:

// ~/.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 }
}