Programmieragenten

Diese Anleitung verbindet Programmieragenten mit Phaseo. Wähle die Phaseo CLI für verwaltete Zugangsdaten und Konfiguration oder manuelle Anbieterwerte, um die Einrichtung im Agenten vorzunehmen.

Einrichtung wählen

Du möchtest…	Verwende
Cline, Kilo Code, oh-my-pi, Muse Code oder MiniMax Code mit isolierten temporären Einstellungen starten	`phaseo cline`, `phaseo kilo`, `phaseo omp`, `phaseo muse`, oder `phaseo minimax`
Einen installierten Agenten konfigurieren und seine Einstellungen behalten	`phaseo <integration>`
Einen Agenten ohne Phaseo CLI konfigurieren	Befolge die manuellen Anbieterschritte in der jeweiligen Anleitung

Mit der Phaseo-CLI einrichten

Melde dich einmal an und richte anschließend dein Coding-Harness ein:

phaseo login
phaseo codex

Dieser Befehl prüft, ob das Harness installiert ist. Fehlt es in einem interaktiven Terminal, zeigt Phaseo den unterstützten Installationsbefehl an und fragt vor der Ausführung nach. Anschließend erstellt Phaseo einen eigenen Schlüssel für das Harness und schreibt dessen Konfiguration. Nichtinteraktive Aufrufe geben konkrete Installationshinweise aus, ohne unbeaufsichtigt Änderungen am System vorzunehmen. OpenCode, DeepSeek Harness, Pi, Prime Agent und OpenClaw erhalten außerdem alle aktiven Textmodelle, die mit Chat Completions kompatibel sind. Verwende --skip-install, --catalog default oder --dry-run, um den Umfang einzuschränken. Verwende für dauerhafte Integrationen den Befehl mit dem Produktnamen:

phaseo codex

Supported integration names are codex, claude-code, opencode, deepseek-harness, pi, openclaw, hermes, aider, cline, roo-code, kilo-code, continue, cursor, and zed. Die isolierten CLI-Runner sind cline, kilo, omp, muse und minimax. Die CLI erstellt einen eigenen, nicht ablaufenden API-Schlüssel für den jeweiligen Assistenten. Bei Neuinstallationen konfiguriert sie Aider und Continue automatisch und schreibt auch Zeds Anbieter-/Modelleinstellungen. Bei Assistenten, die Geheimnisse ausschließlich in einer Editor-Oberfläche speichern, zeigt sie die noch fehlenden Felder an, verlinkt den passenden Leitfaden und ermöglicht das Kopieren nur dieses Assistentenschlüssels:

phaseo integrations credential codex

Zeige Dateiänderungen vor der Einrichtung in der Vorschau an und trenne die Integration später sauber:

phaseo codex --dry-run
phaseo integrations remove codex

Beim Entfernen werden Phaseo-eigene Einstellungen gelöscht und der Schlüssel des Assistenten widerrufen. Andere Einstellungen bleiben erhalten.

Manuelle Anbietereinstellungen

Verwende diese Werte, sofern das Tool keinen anderen Feldnamen verlangt:

Einstellung	Wert
Anbietertyp	OpenAI Compatible
Base-URL	`https://api.phaseo.app/v1`
API-Schlüssel	Dein Phaseo-API-Schlüssel
Modell	Eine Phaseo-Modell-ID, z. B. `openai/gpt-5-nano`

Für Anthropic-kompatible Tools verwende:

Einstellung	Wert
Base-URL	`https://api.phaseo.app`
Authentifizierungstoken	Dein Phaseo-API-Schlüssel
Modell	Eine Phaseo-Modell-ID, z. B. `anthropic/claude-sonnet-4.5`

Cursor

Cursor unterstützt benutzerdefinierte OpenAI-kompatible Endpoints über die Einstellungen für den OpenAI-API-Schlüssel.

Öffne Cursor Settings.
Öffne Models.
Aktiviere den Eintrag OpenAI API Key oder füge ihn hinzu.
Füge deinen Phaseo-API-Schlüssel ein.
Aktiviere Override OpenAI Base URL.
Setze die Base-URL auf https://api.phaseo.app/v1. Füge ein benutzerdefiniertes Modell mit einer Phaseo-Modell-ID hinzu, zum Beispiel openai/gpt-5-nano. Aktiviere das Modell und prüfe es in der Modellauswahl von Cursor.

Wenn Cursor eine Modell-ID mit / ablehnt, erstelle den ähnlichsten lokalen Alias, den die UI zulässt, und leite ihn in deiner Konfiguration auf das Phaseo-Modell, sofern der Client Aliase unterstützt.

VS Code

In VS Code lassen sich Modelle im Editor Language Models hinzufügen, wenn der OpenAI-kompatible Anbieter in deiner VS-Code- oder Insiders-Version verfügbar ist.

Öffne die Befehlspalette.
Führe Chat: Manage Language Models aus.
Wähle OpenAI Compatible oder OAI Compatible.
Gib deinen Phaseo-API-Schlüssel ein. Setze Endpoint oder Base-URL auf https://api.phaseo.app/v1. Füge eine Phaseo-Modell-ID hinzu, zum Beispiel openai/gpt-5-nano. Wähle das neue Modell in der Chat-Modellauswahl aus.

Wenn deine VS-Code-Version keinen OpenAI-kompatiblen Anbieter anzeigt, nutze eine Erweiterung mit Unterstützung für benutzerdefinierte Anbieter, etwa Continue, Cline, Roo Code oder Kilo Code.

Continue

Continue kann Phaseo über seinen OpenAI-Anbieter mit einer benutzerdefinierten API-Basis verwenden.

name: Phaseo
version: 0.0.1
schema: v1

models:
  - name: Phaseo GPT-5 Nano
    provider: openai
    model: openai/gpt-5-nano
    apiKey: ${{ secrets.PHASEO_API_KEY }}
    apiBase: https://api.phaseo.app/v1
    roles:
      - chat
      - edit
      - apply

Wenn Continue standardmäßig Responses verwendet, dein Workflow aber Chat-Completions-Kompatibilität benötigt, setze useResponsesApi: false.

Cline, Roo Code und Kilo Code

Diese Tools bieten ähnliche Anbietereinstellungen.

Öffne die Erweiterungseinstellungen.
Wähle OpenAI Compatible als Anbieter.
Setze die Base-URL auf https://api.phaseo.app/v1.
Füge deinen Phaseo-API-Schlüssel ein.
Gib eine Phaseo-Modell-ID ein. Speichere die Einstellungen und sende eine kurze Chat-Anfrage, bevor du Dateiänderungstools verwendest.

Aider

Setze OpenAI-kompatible Umgebungsvariablen und gib das Modell beim Start an:

export OPENAI_API_BASE="https://api.phaseo.app/v1"
export OPENAI_API_KEY="your_phaseo_api_key"
aider --model openai/openai/gpt-5-nano

Aider erwartet bei benutzerdefinierten OpenAI-kompatiblen Modellen häufig das Präfix openai/. Da Phaseo-Modell-IDs bereits Anbieterpräfixe enthalten, kann die vollständige Aider-Modellzeichenfolge wie openai/openai/gpt-5-nano aussehen.

Pi, Prime Agent, OpenClaw und Hermes Agent

phaseo pi fügt eine eigene Provider-Erweiterung hinzu, die ihren Schlüssel zur Laufzeit über die Phaseo-CLI bezieht. phaseo prime-agent schreibt einen befehlsbasierten Provider nach ~/.prime/agent/models.json. Beide erhalten den kompatiblen Phaseo-Modellkatalog. phaseo openclaw registriert den kompatiblen Modellkatalog sowie eine Exec-basierte SecretRef, ohne den API-Schlüssel in openclaw.json abzulegen. phaseo hermes bietet an, bei fehlendem Hermes den offiziellen Nous-Research-Installer auszuführen und konfiguriert anschließend den installierten Agenten. Es speichert die vorherigen Hermes-Modelleinstellungen, richtet Phaseo als benutzerdefinierten Endpoint ein und verwendet den offiziellen Befehl hermes config set, um den eigenen Schlüssel in ~/.hermes/.env als OPENAI_API_KEY abzulegen. Hermes verwendet diese Klartextdatei bewusst für Anbieterzugangsdaten. Schütze sie wie jede andere API-Schlüsseldatei. Beim Entfernen werden die vorherigen Modelleinstellungen wiederhergestellt, OPENAI_API_KEY entfernt, der Phaseo-Wiederherstellungsstatus gelöscht und der Schlüssel widerrufen.

MiniMax Code

Verwende die MiniMax-Code-Anleitung für die mcode CLI. phaseo minimax erstellt einen temporären MiniMax-Anbieter mit Phaseos OpenAI-kompatiblem Endpunkt, startet die CLI und entfernt das temporäre Datenverzeichnis nach der Sitzung. MiniMax Code unterstützt auch ACP über mcode acp, wenn Editor oder Host direkt ACP verwenden.

Zed

Führe phaseo zed aus und befolge die angezeigten Schritte, um in den Zed-Einstellungen einen OpenAI-kompatiblen Anbieter hinzuzufügen. Verwende den generierten Schlüssel nur im Zugangsdatenfeld von Zed.

Codex

Nutze den eigenen Codex-Leitfaden für Codex-CLI, Codex-App und die Codex-IDE-Erweiterung. Kurz gesagt:

model = "openai/gpt-5.5"
model_provider = "phaseo"

[model_providers.phaseo]
name = "Phaseo"
base_url = "https://api.phaseo.app/v1"
env_key = "PHASEO_API_KEY"
wire_api = "responses"

Benutzerdefinierte Codex-Anbieter verwenden das Responses-Wire-Protokoll.

OpenCode

Wenn OpenCode Phaseo über einen benutzerdefinierten OpenAI-kompatiblen Anbieter aufrufen soll, nutze den eigenen OpenCode-Leitfaden.

Claude Code

Nutze den eigenen Claude-Code-Leitfaden. Claude Code verwendet Anthropic-kompatible Gateway-Umgebungsvariablen:

export ANTHROPIC_BASE_URL="https://api.phaseo.app"
export ANTHROPIC_AUTH_TOKEN="your_phaseo_api_key"
export ANTHROPIC_API_KEY=""

Starte Claude Code anschließend in derselben Shell:

claude

Claude Desktop

Claude Desktop unterstützt MCP-Server, bietet aber nicht dieselbe Einrichtung benutzerdefinierter Modellanbieter wie Coding-Assistenten à la Cursor, Codex oder Claude Code. Mit Docs MCP fügst du Claude Desktop Kontext aus der Phaseo-Dokumentation hinzu. Verwende Claude Code, wenn Phaseo als Modell-Gateway dienen soll.

Deep Agents CLI und LangChain-Tools

Verwende dieselbe Base-URL und denselben API-Schlüssel wie für LangChain. Wenn das Tool OpenAI-Umgebungsvariablen ausliest, setze:

export OPENAI_API_KEY="your_phaseo_api_key"
export OPENAI_BASE_URL="https://api.phaseo.app/v1"

Gib anschließend im Modellfeld des Tools eine Phaseo-Modell-ID an.

Hinweise

Coding-Assistenten behandeln Schrägstriche in Modell-IDs unterschiedlich. Wenn die UI openai/gpt-5-nano ablehnt, erstelle einen lokalen Alias, sofern das Tool Aliase unterstützt.
Teste Dateiänderungsabläufe sorgfältig. phaseo:apply_patch funktioniert nur mit Responses.
Füge Docs MCP hinzu, wenn der Assistent während einer Sitzung Phaseo-Dokumentation lesen soll.
Bevorzuge Chat Completions bei älteren Coding-Tools, sofern das Tool Responses-Ereignisse und Server-Tools nicht ausdrücklich unterstützt.

Übersicht

Modelle und Routing

Funktionen

Integrationen

Arbeitsbereiche und Zugriff

Zuverlässigkeit und Betrieb

Plattform und Forschung

Migrationsleitfäden

Community

Einrichtung wählen

Mit der Phaseo-CLI einrichten

Manuelle Anbietereinstellungen

Cursor

VS Code

Continue

Cline, Roo Code und Kilo Code

Aider

Pi, Prime Agent, OpenClaw und Hermes Agent

MiniMax Code

Zed

Codex

OpenCode

Claude Code

Claude Desktop

Deep Agents CLI und LangChain-Tools

Hinweise

Verwandte Links

​Einrichtung wählen

​Mit der Phaseo-CLI einrichten

​Manuelle Anbietereinstellungen

​Cursor

​VS Code

​Continue

​Cline, Roo Code und Kilo Code

​Aider

​Pi, Prime Agent, OpenClaw und Hermes Agent

​MiniMax Code

​Zed

​Codex

​OpenCode

​Claude Code

​Claude Desktop

​Deep Agents CLI und LangChain-Tools

​Hinweise

​Verwandte Links

Einrichtung wählen

Mit der Phaseo-CLI einrichten

Manuelle Anbietereinstellungen

Cursor

VS Code

Continue

Cline, Roo Code und Kilo Code

Aider

Pi, Prime Agent, OpenClaw und Hermes Agent

MiniMax Code

Zed

Codex

OpenCode

Claude Code

Claude Desktop

Deep Agents CLI und LangChain-Tools

Hinweise

Verwandte Links