> ## Documentation Index > Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # Phaseo-CLI > Installiere die offizielle Phaseo-CLI, konfiguriere Programmierumgebungen und verwalte Phaseo im Terminal. Die Phaseo-CLI wird als `@phaseo/cli` veröffentlicht. Sie verbindet Programmierumgebungen mit Phaseo und bietet einen offiziellen Terminal-Workflow für die Phaseo-Steuerungsebene. Verwende sie, wenn du Folgendes tun möchtest: * dich als Phaseo-Benutzer in einer lokalen oder entfernten Shell oder einer Agentenlaufzeit anzumelden * API-Schlüssel oder Verwaltungsschlüssel zu erstellen und zu rotieren * Workspaces, Presets, Einstellungen und Guardrails zu verwalten * den OAuth-Flow der offiziellen CLI zu nutzen, während benutzereigene OAuth-Apps noch privat getestet werden * Modelle, Anbieter, Preise, Guthaben, Aktivitäten, Analysen und Generierungen einzusehen ## Installation ```bash title="npm" theme={null} npm install -g @phaseo/cli ``` ```bash title="pnpm" theme={null} pnpm add -g @phaseo/cli ``` ```bash title="yarn" theme={null} yarn global add @phaseo/cli ``` ```bash title="bun" theme={null} bun add -g @phaseo/cli ``` ## Installierte Version prüfen ```bash theme={null} phaseo --version phaseo version phaseo version --json ``` * `phaseo --version` zeigt die installierte Version an. * `phaseo version` zeigt die Version und den empfohlenen Aktualisierungsbefehl für den aktuellen Paketmanager an. * Interaktive Aufrufe zeigen außerdem einen Aktualisierungshinweis an, wenn eine neuere Version veröffentlicht wurde. Der ältere Befehl `phaseo` bleibt als Kompatibilitätsalias verfügbar. ## Anmelden Beginne mit: ```bash theme={null} phaseo login ``` Die CLI unterstützt zwei offizielle Anmeldeabläufe: * **Mit Phaseo anmelden**: Browser-OAuth mit Authorization Code und PKCE * **Mit Gerätecode anmelden**: ideal für SSH, CI, Headless-Shells und Agentenumgebungen Du kannst einen der beiden Wege erzwingen: ```bash theme={null} phaseo login --browser phaseo login --device-code ``` Remote und nicht interaktive Umgebungen bevorzugen automatisch den Gerätecode. ## Terminalausgabe Interaktive Terminals verwenden Phaseos Farben und visuelle Hierarchie und zeigen während der Einrichtung kurzlebige Spinner an. Spinner schreiben auf `stderr` und löschen ihre Zeile nach Abschluss. Ein `stderr` ohne TTY und `TERM=dumb` deaktivieren Animationen; `NO_COLOR` deaktiviert Farben. Befehle mit `--json` liefern immer unverzierten strukturierten Output für Agenten und Automatisierung. Verwende `FORCE_COLOR=1` nur, wenn ein Terminal-Wrapper Farben unterstützt, sich aber nicht als TTY meldet. ## Identität bestätigen ```bash theme={null} phaseo whoami phaseo whoami --json ``` Der Befehl gibt deinen aktuellen Phaseo-Benutzer, Scopes, den aktiven Workspace und verfügbare Workspaces zurück. ## Schlüssel erstellen ```bash theme={null} phaseo keys create --name "Local CLI Key" phaseo keys create --name "Agent Sandbox Key" --json phaseo keys current ``` Verwende `--json`, wenn ein Agent oder eine Automatisierung den neu erstellten Schlüssel einmalig im Rohformat benötigt. ## Workspaces und Guardrails verwalten ```bash theme={null} phaseo workspaces list phaseo workspaces members phaseo guardrails list phaseo guardrails create --name "Production Safety" --body-json '{"enabled":true}' ``` Die CLI soll die nützlichen Funktionen des Phaseo-Dashboards und der Verwaltungs-APIs im Terminal verfügbar machen. ## Unterstützte Programmierumgebungen starten Dauerhafte Integrationen verwenden direkt den Produktnamen: ```bash theme={null} phaseo codex phaseo claude-code phaseo deepseek-harness phaseo opencode phaseo pi phaseo prime-agent phaseo openclaw phaseo aider phaseo roo-code phaseo kilo-code phaseo continue phaseo cursor phaseo zed ``` Verwende bei Bedarf `--model`, `--catalog all|default` oder `--dry-run`. Die ältere Form `phaseo integrations setup ` bleibt aus Kompatibilitätsgründen verfügbar, ist aber nicht erforderlich. Die CLI startet Cline, Kilo Code, oh-my-pi, Muse Code und MiniMax Code mit temporärer Anbieterkonfiguration und eigenem Phaseo-Schlüssel. Jedes Werkzeug hat eine Anleitung mit Einrichtung und Fehlerbehebung: [Cline](./cline), [Kilo Code](./kilo-code), [oh-my-pi](./oh-my-pi), [Muse Code](./muse-code) und [MiniMax Code](./minimax-code). ```bash theme={null} phaseo cline --model openai/gpt-5.6-terra -- --tui phaseo kilo --model openai/gpt-5.6-terra -- phaseo omp --model openai/gpt-5.6-terra -- phaseo muse --model meta/muse-spark-1.3 -- phaseo minimax --model openai/gpt-5.6-terra -- ``` Verwende `phaseo run ` für die explizite Form. Phaseo-Optionen stehen vor `--`, Werkzeugoptionen danach. Mit `--catalog all` synchronisierst du alle aktiven Phaseo-Text-/Chatmodelle; eine Vorschau ohne Zugangsdaten zu erstellen erhältst du mit: ```bash theme={null} phaseo cline --model openai/gpt-5.6-terra --dry-run --json ``` Fehlende Installationen von Cline, Kilo Code und oh-my-pi werden interaktiv angeboten. Muse Code und MiniMax Code verwenden ihre offiziellen Installationsprogramme, wenn der Befehl fehlt. Unter Windows nutzt MiniMax Code den offiziellen PowerShell-Installer; verwende `--skip-install`, wenn du die Werkzeuge separat verwaltest. Bestehende Konfigurationen von Cline, Kilo, oh-my-pi, Muse Code oder MiniMax Code werden nicht überschrieben. ## OAuth-Apps Phaseo verwendet einen OAuth-Autorisierungsserver für die offizielle CLI, benutzererstellte Anwendungen und dynamisch registrierte MCP-Clients. Die CLI nutzt die Anmeldung per Browser oder Gerätecode mit rotierenden Refresh-Tokens. Drittanbieter-Clients verwenden den Authorization-Code-Flow mit PKCE, expliziten Scopes und Workspace-Einwilligung, widerrufbare delegierte Zugriffstokens und optional eine Bindung an geschützte Ressourcen. Die gehostete Phaseo-API aktiviert OAuth für Drittanbieter. Bei selbst gehosteten oder Vorschau-Deployments der API bleibt es deaktiviert, sofern `PHASEO_THIRD_PARTY_OAUTH_ENABLED` nicht auf einen Wahrheitswert gesetzt wird. Akzeptiert werden `1`, `true`, `yes` und `on`, ohne Beachtung der Groß-/Kleinschreibung und nach Entfernen von Leerzeichen. Die Aktivierung ermöglicht die Verwaltung benutzererstellter OAuth-Apps und die dynamische Client-Registrierung. Prüfe deshalb Redirect-URIs, Einwilligung, Client-Secrets, Rate-Limits und Workspace-Autorisierung sorgfältig. ```bash title=".env" theme={null} PHASEO_THIRD_PARTY_OAUTH_ENABLED=true ``` ```bash title="Docker" theme={null} docker run -e PHASEO_THIRD_PARTY_OAUTH_ENABLED=true phaseo ``` ```yaml title="Kubernetes" theme={null} env: - name: PHASEO_THIRD_PARTY_OAUTH_ENABLED value: "true" ``` ## Sicherheitsmodell CLI-Sitzungen erfordern standardmäßig einen sicheren, vom Betriebssystem bereitgestellten Speicher. Setze `PHASEO_SESSION_BACKEND=file` nur ausdrücklich, wenn kein Credential Store des Betriebssystems verfügbar ist; Refresh-Tokens werden dann in einer Klartextdatei mit eingeschränkten Dateirechten gespeichert. * `phaseo logout` widerruft das gespeicherte Refresh-Token, bevor der lokale Zustand gelöscht wird. * Verwaltungsschlüssel erfordern ausdrücklich festgelegte Fähigkeiten. * Normale Inferenzschlüssel beruhen auf Guardrails, Routing-Richtlinien und Workspace-Einstellungen statt auf einem eigenen Scope-Modell. ## Aktualisieren ```bash title="npm" theme={null} npm install -g @phaseo/cli@latest ``` ```bash title="pnpm" theme={null} pnpm add -g @phaseo/cli@latest ``` ```bash title="yarn" theme={null} yarn global add @phaseo/cli@latest ``` ```bash title="bun" theme={null} bun add -g @phaseo/cli@latest ``` ## Nächste Schritte * [API-Verwaltungsschlüssel](../../developers/management-api-keys.mdx) * [Authentifizierung](../../developers/authentication.mdx) * [Codex](./codex.mdx) * [Claude Code](./claude-code.mdx) * [Cline](./cline) * [Kilo Code](./kilo-code) * [oh-my-pi](./oh-my-pi) * [Muse Code](./muse-code) * [MiniMax Code](./minimax-code) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.