Pi Agent-Authentifizierung und Modellkonfiguration

Pi Agent unterstützt zwei Authentifizierungsmethoden: Abonnement-Login und API-Schlüssel. Dieses Kapitel beschreibt detailliert, wie Sie Pi Agent konfigurieren, um eine Verbindung zu KI-Modellen herzustellen.


Überblick über Authentifizierungsmethoden

AuthentifizierungsmethodeVerwendungAnwendungsfall
Abonnement-Login (OAuth)Führen Sie /login nach dem Start von pi ausSie haben bereits Abonnements für Claude Pro/Max, ChatGPT Plus/Pro, GitHub Copilot usw.
API-Key-UmgebungsvariableUmgebungsvariable setzen, dann pi startenSie haben einen API-Key und möchten ihn in der Shell-Konfiguration dauerhaft speichern
API-Key-AnmeldeinformationsdateiAPI-Key-Anbieter zur Speicherung über /login auswählenSie haben einen API-Key und möchten, dass Pi Agent ihn zentral verwaltet

Methode 1: Abonnement-Login (empfohlen)

Wenn Sie bereits Claude Pro/Max, ChatGPT Plus/Pro oder GitHub Copilot abonniert haben, ist dies die bequemste Methode.

Geben Sie nach dem Start von Pi Agent den folgenden Befehl ein:

/login

Wählen Sie dann Ihren Abonnement-Anbieter aus dem erscheinenden Menü aus:

ProviderVoraussetzungBeschreibung
Claude Pro/MaxAnthropic-AbonnementkontoWird für zusätzliche Nutzung abgerechnet, zählt nicht gegen das Plan-Kontingent
ChatGPT Plus/Pro (Codex)OpenAI Plus- oder Pro-AbonnementOpenAI hat Codex offiziell für OSS anerkannt
GitHub CopilotGitHub Copilot-AbonnementUnterstützt github.com und Enterprise-Server
xAI (Grok)X Premium-AbonnementVerwendet Grok-Modell
OpenRouterOpenRouter-KontoOAuth erstellt API-Schlüssel, vom Guthaben abgezogen

Im Authentifizierungsmodus für Claude Pro/Max-Abonnement verwendet Pi Agent zusätzliche Nutzung, wird pro Token abgerechnet und zählt nicht gegen dein Claude-Plan-Kontingent. Du kannst es inClaude-Nutzungseinstellungen nachsehen.

Nach Abschluss der Anmeldung werden die Anmeldedaten in~/.pi/agent/auth.jsongespeichert, und Pi Agent wird sie bei nachfolgenden Starts automatisch verwenden.

Zum Abmelden verwenden:

/logout

Methode 2: API-Key-Umgebungsvariable

Wenn Sie einen API-Key besitzen, können Sie die Umgebungsvariable festlegen, bevor Sie Pi Agent starten:

# 设置 Anthropic API Key
export ANTHROPIC_API_KEY=sk-ant-api03-your-key-here

# 启动 Pi Agent
pi

Pi Agent unterstützt API-Key-Umgebungsvariablen für die folgenden großen Anbieter:

ProviderUmgebungsvariableauth.json Schlüsselname
AnthropicANTHROPIC_API_KEYanthropic
OpenAIOPENAI_API_KEYopenai
Google GeminiGEMINI_API_KEYgoogle
DeepSeekDEEPSEEK_API_KEYdeepseek
GroqGROQ_API_KEYgroq
MistralMISTRAL_API_KEYmistral
xAIXAI_API_KEYxai
OpenRouterOPENROUTER_API_KEYopenrouter

DeepSeek-Anbieter konfigurieren

Pi unterstützt benutzerdefinierte Anbieter über models.json. Der Speicherort der Konfigurationsdatei:

  • Linux / macOS:~/.pi/agent/models.json
  • Windows:%USERPROFILE%\.pi\agent\models.json

Zuerst erhalten Sie einen API-Key von der DeepSeek Open Platform:https://platform.deepseek.com/api_keys。

{
  "providers": {
    "deepseek": {
      "baseUrl": "https://api.deepseek.com",
      "api": "openai-completions",
      "apiKey": "$DEEPSEEK_API_KEY",
      "models": [
        {
          "id": "deepseek-v4-pro",
          "name": "DeepSeek V4 Pro",
          "contextWindow": 1000000,
          "maxTokens": 384000,
          "input": ["text"],
          "reasoning": true,
          "cost": {
            "input": 1.74,
            "output": 3.48,
            "cacheRead": 0.145,
            "cacheWrite": 0
          },
          "compat": {
            "requiresReasoningContentOnAssistantMessages": true,
            "thinkingFormat": "deepseek",
            "reasoningEffortMap": {
              "minimal": "high",
              "low": "high",
              "medium": "high",
              "high": "high",
              "xhigh": "max"
            }
          }
        },
        {
          "id": "deepseek-v4-flash",
          "name": "DeepSeek V4 Flash",
          "contextWindow": 1000000,
          "maxTokens": 384000,
          "input": ["text"],
          "reasoning": true,
          "cost": {
            "input": 0.14,
            "output": 0.28,
            "cacheRead": 0.028,
            "cacheWrite": 0
          },
          "compat": {
            "requiresReasoningContentOnAssistantMessages": true,
            "thinkingFormat": "deepseek",
            "reasoningEffortMap": {
              "minimal": "high",
              "low": "high",
              "medium": "high",
              "high": "high",
              "xhigh": "max"
            }
          }
        }
      ]
    }
  }
}

Legen Sie die Umgebungsvariable fest:

Linux-/Mac-Benutzer:

export DEEPSEEK_API_KEY="<你的 DeepSeek API Key>"

Windows-Benutzer:

$env:DEEPSEEK_API_KEY="<你的 DeepSeek API Key>"

Wechseln Sie in das Projektverzeichnis und führen Sie den Befehl pi aus:

cd /path/to/my-project
pi

Wenn Sie die Umgebungsvariable nicht jedes Mal manuell festlegen möchten, können Sie den export-Befehl in Ihre Shell-Konfigurationsdatei (z. B. ~/.zshrc oder ~/.bashrc) schreiben, um ihn dauerhaft zu machen.


Methode 3: API-Key-Anmeldeinformationsdatei

Sie können auch den Befehl /login verwenden, um einen API-Key-Anbieter auszuwählen und Anmeldeinformationen zu speichern.

Der Speicherort ist~/.pi/agent/auth.json, mit dem folgenden Format:

{
  "anthropic": { "type": "api_key", "key": "sk-ant-api03-your-key" },
  "openai": { "type": "api_key", "key": "sk-your-openai-key" },
  "deepseek": { "type": "api_key", "key": "sk-your-deepseek-key" }
}

Die Anmeldeinformationsdatei wird automatisch auf0600Berechtigungen (nur vom Benutzer lesbar und schreibbar) gesetzt, was ein grundlegendes Sicherheitsniveau bietet.


Auflösungsreihenfolge der Anmeldeinformationen

Wenn Pi Agent einen API-Schlüssel abrufen muss, sucht er in der folgenden Prioritätsreihenfolge:

  1. CLI-Parameter --api-key (höchste Priorität)
  2. Anmeldeinformationen in der Datei auth.json
  3. Umgebungsvariablen
  4. Schlüssel von einem benutzerdefinierten Anbieter in models.json

Pi Agent 凭证解析优先级链

Mit anderen Worten: Wenn Sie sowohl eine Umgebungsvariable als auch auth.json festlegen, hat der Wert in auth.json Vorrang.


Erweiterte Funktionen von auth.json

auth.json unterstützt nicht nur das Speichern von Klartext-Schlüsseln, sondern auch die folgende erweiterte Verwendung:

Schlüssel über die Befehlszeile abrufen

Verwenden Sie das!Präfix, um einen Befehl zum Abrufen des Schlüssels auszuführen; geeignet zum Auslesen aus einem Passwortmanager:

{
  "anthropic": {
    "type": "api_key",
    "key": "!security find-generic-password -ws 'anthropic-api-key'"
  },
  "openai": {
    "type": "api_key",
    "key": "!op read 'op://vault/item/credential'"
  }
}

Das obige Beispiel zeigt, wie der Schlüssel aus macOS Keychain und der 1Password CLI abgerufen wird.

Interpolation von Umgebungsvariablen

Verwenden Sie das$Präfix, um auf Umgebungsvariablen zu verweisen:

{
  "anthropic": {
    "type": "api_key",
    "key": "$MY_ANTHROPIC_KEY"
  }
}

Modelle wechseln

Nach der Konfiguration der Authentifizierung kannst du das verwendete KI-Modell jederzeit wechseln:

Verwende im interaktiven Modus den/modelBefehl oder drückeCtrl+L, um die Modellauswahl zu öffnen.

VerwendeCtrl+P / Shift+Ctrl+P, um durch die konfigurierten Modelle zu wechseln.

Gib das Modell über die Kommandozeile an:

# 指定提供商和模型
$ pi --provider anthropic --model claude-sonnet-4-20250514

# 使用 provider/model 格式
$ pi --model openai/gpt-4o "帮我重构这段代码"

# 指定推理等级(thinking level)
$ pi --model sonnet:high "解决这个复杂问题"

Die Denkstufe steuert, wie tief das Modell nachdenkt, bevor es antwortet. Die Stufen reichen von Aus bis Max. Tieferes Nachdenken kann qualitativ hochwertigere Antworten liefern, verbraucht aber mehr Tokens.

DenkstufeBeschreibungAnwendungsfall
offZeigt keinen Denkprozess anEinfache Fragen und Antworten, Codeformatierung
minimalMinimales ReasoningGrundlegende Programmieraufgaben
lowGeringes ReasoningAllgemeine Programmierprobleme
mittelMittleres Nachdenken (standardmäßig empfohlen)Tägliche Entwicklungsaufgaben
hochHohes ReasoningKomplexes Architekturdesign, Debugging
xhighExtrahohes ReasoningSchwierige Algorithmusprobleme
maxMaximales ReasoningExtrem komplexe Logikanalyse

Die Rahmenfarbe des Editors ändert sich mit der Denkstufe, sodass Sie die aktuelle Reasoning-Tiefe intuitiv erkennen können.

Andere Erweiterungen