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
| Authentifizierungsmethode | Verwendung | Anwendungsfall |
|---|---|---|
| Abonnement-Login (OAuth) | Führen Sie /login nach dem Start von pi aus | Sie haben bereits Abonnements für Claude Pro/Max, ChatGPT Plus/Pro, GitHub Copilot usw. |
| API-Key-Umgebungsvariable | Umgebungsvariable setzen, dann pi starten | Sie haben einen API-Key und möchten ihn in der Shell-Konfiguration dauerhaft speichern |
| API-Key-Anmeldeinformationsdatei | API-Key-Anbieter zur Speicherung über /login auswählen | Sie 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:
| Provider | Voraussetzung | Beschreibung |
|---|---|---|
| Claude Pro/Max | Anthropic-Abonnementkonto | Wird für zusätzliche Nutzung abgerechnet, zählt nicht gegen das Plan-Kontingent |
| ChatGPT Plus/Pro (Codex) | OpenAI Plus- oder Pro-Abonnement | OpenAI hat Codex offiziell für OSS anerkannt |
| GitHub Copilot | GitHub Copilot-Abonnement | Unterstützt github.com und Enterprise-Server |
| xAI (Grok) | X Premium-Abonnement | Verwendet Grok-Modell |
| OpenRouter | OpenRouter-Konto | OAuth 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:
| Provider | Umgebungsvariable | auth.json Schlüsselname |
|---|---|---|
| Anthropic | ANTHROPIC_API_KEY | anthropic |
| OpenAI | OPENAI_API_KEY | openai |
| Google Gemini | GEMINI_API_KEY | |
| DeepSeek | DEEPSEEK_API_KEY | deepseek |
| Groq | GROQ_API_KEY | groq |
| Mistral | MISTRAL_API_KEY | mistral |
| xAI | XAI_API_KEY | xai |
| OpenRouter | OPENROUTER_API_KEY | openrouter |
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:
- CLI-Parameter --api-key (höchste Priorität)
- Anmeldeinformationen in der Datei auth.json
- Umgebungsvariablen
- Schlüssel von einem benutzerdefinierten Anbieter in models.json
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.
| Denkstufe | Beschreibung | Anwendungsfall |
|---|---|---|
| off | Zeigt keinen Denkprozess an | Einfache Fragen und Antworten, Codeformatierung |
| minimal | Minimales Reasoning | Grundlegende Programmieraufgaben |
| low | Geringes Reasoning | Allgemeine Programmierprobleme |
| mittel | Mittleres Nachdenken (standardmäßig empfohlen) | Tägliche Entwicklungsaufgaben |
| hoch | Hohes Reasoning | Komplexes Architekturdesign, Debugging |
| xhigh | Extrahohes Reasoning | Schwierige Algorithmusprobleme |
| max | Maximales Reasoning | Extrem komplexe Logikanalyse |
Die Rahmenfarbe des Editors ändert sich mit der Denkstufe, sodass Sie die aktuelle Reasoning-Tiefe intuitiv erkennen können.
Andere Erweiterungen