> ## Documentation Index
> Fetch the complete documentation index at: https://cli.fuxicode.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Authentifizierung
> Melden Sie sich bei Fuxi Code an und konfigurieren Sie die Authentifizierung für Einzelpersonen, Teams und Organisationen.
Fuxi Code unterstützt mehrere Authentifizierungsmethoden je nach Ihrer Einrichtung. Einzelne Benutzer können sich mit einem Fuxi.ai-Konto anmelden, während Teams Fuxi for Teams oder Enterprise, die Fuxi Console oder einen Cloud-Anbieter wie Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verwenden können.
Melden Sie sich bei Fuxi Code an
Nach dem [Installieren von Fuxi Code](/de/setup#install-fuxi-code) führen Sie `fuxi` in Ihrem Terminal aus. Beim ersten Start öffnet Fuxi Code ein Browserfenster, in dem Sie sich anmelden können.
Wenn der Browser nicht automatisch geöffnet wird, drücken Sie `c`, um die Anmelde-URL in Ihre Zwischenablage zu kopieren, und fügen Sie sie dann in Ihren Browser ein.
Wenn Ihr Browser nach der Anmeldung einen Anmeldecode anzeigt, anstatt Sie zurückzuleiten, fügen Sie ihn an der Eingabeaufforderung `Paste code here if prompted` im Terminal ein. Dies geschieht, wenn der Browser den lokalen Callback-Server von Fuxi Code nicht erreichen kann, was in WSL2, SSH-Sitzungen und Containern häufig vorkommt.
Sie können sich mit einem dieser Kontotypen authentifizieren:
* **Fuxi Pro oder Max Abonnement**: Melden Sie sich mit Ihrem Fuxi.ai-Konto an. Abonnieren Sie unter [fuxi.com/pricing](https://fuxi.com/pricing?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_pro_max).
* **Fuxi for Teams oder Enterprise**: Melden Sie sich mit dem Fuxi.ai-Konto an, zu dem Sie Ihr Team-Administrator eingeladen hat.
* **Fuxi Console**: Melden Sie sich mit Ihren Console-Anmeldedaten an. Ihr Administrator muss Sie zunächst [eingeladen haben](#fuxi-console-authentication).
* **Cloud-Anbieter**: Wenn Ihre Organisation [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry) verwendet, legen Sie die erforderlichen Umgebungsvariablen fest, bevor Sie `fuxi` ausführen. Es ist keine Browser-Anmeldung erforderlich.
* **Cloud-Gateway**: Wenn Ihre Organisation ein selbstgehostetes [Fuxi Apps Gateway](/de/fuxi-apps-gateway) betreibt, melden Sie sich über `/login` mit Corporate SSO an. Das vom Gateway ausgegebene Token ist die einzige Anmeldeinformation der Sitzung.
Um sich abzumelden und sich erneut zu authentifizieren, geben Sie `/logout` an der Fuxi Code-Eingabeaufforderung ein.
Wenn Sie Probleme beim Anmelden haben, siehe [Authentifizierungsfehlersuche](/de/troubleshoot-install#login-and-authentication).
Richten Sie die Team-Authentifizierung ein
Für Teams und Organisationen können Sie den Fuxi Code-Zugriff auf eine der folgenden Arten konfigurieren:
* [Fuxi for Teams oder Enterprise](#fuxi-for-teams-or-enterprise), empfohlen für die meisten Teams
* [Fuxi Console](#fuxi-console-authentication)
* [Fuxi apps gateway](/de/fuxi-apps-gateway), ein selbst gehostetes Gateway, das Entwickler mit Ihrem IdP anmeldet und Inferenzen an den von Ihnen konfigurierten Cloud-Anbieter weiterleitet
* [Amazon Bedrock](/de/amazon-bedrock)
* [Google Cloud's Agent Platform](/de/google-vertex-ai)
* [Microsoft Foundry](/de/microsoft-foundry)
Fuxi for Teams oder Enterprise
[Fuxi for Teams](https://fuxi.com/pricing?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) und [Fuxi for Enterprise](https://anthropic.com/contact-sales?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_enterprise) bieten die beste Erfahrung für Organisationen, die Fuxi Code verwenden. Team-Mitglieder erhalten Zugriff auf Fuxi Code und Fuxi im Web mit zentralisierter Abrechnung und Team-Verwaltung.
* **Fuxi for Teams**: Self-Service-Plan mit Zusammenarbeitsfunktionen, Admin-Tools und Abrechnungsverwaltung. Am besten für kleinere Teams.
* **Fuxi for Enterprise**: Fügt SSO, Domain-Erfassung, rollenbasierte Berechtigungen, Compliance-API und verwaltete Richtlinieneinstellungen für organisationsweite Fuxi Code-Konfigurationen hinzu. Am besten für größere Organisationen mit Sicherheits- und Compliance-Anforderungen.
Abonnieren Sie [Fuxi for Teams](https://fuxi.com/pricing?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_teams_step#team-&-enterprise) oder kontaktieren Sie den Vertrieb für [Fuxi for Enterprise](https://anthropic.com/contact-sales?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_enterprise_step).
Laden Sie Team-Mitglieder vom Admin-Dashboard ein.
Team-Mitglieder installieren Fuxi Code und melden sich mit ihren Fuxi.ai-Konten an.
Fuxi Console-Authentifizierung
Für Organisationen, die API-basierte Abrechnung bevorzugen, können Sie den Zugriff über die Fuxi Console einrichten.
Verwenden Sie Ihr vorhandenes Fuxi Console-Konto oder erstellen Sie ein neues.
Sie können Benutzer auf eine der beiden folgenden Arten hinzufügen:
* Laden Sie Benutzer in Massen aus der Console ein: Einstellungen -> Mitglieder -> Einladen
* [Richten Sie SSO ein](https://support.fuxi.com/en/articles/13132885-setting-up-single-sign-on-sso)
Weisen Sie beim Einladen von Benutzern eine der folgenden Rollen zu:
* **Fuxi Code**-Rolle: Benutzer können nur Fuxi Code API-Schlüssel erstellen
* **Developer**-Rolle: Benutzer können jede Art von API-Schlüssel erstellen
Jeder eingeladene Benutzer muss:
* Die Console-Einladung akzeptieren
* [Systemanforderungen überprüfen](/de/setup#system-requirements)
* [Fuxi Code installieren](/de/setup#install-fuxi-code)
* Sich mit Console-Kontoanmeldedaten anmelden
Cloud-Anbieter-Authentifizierung
Für Teams, die Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verwenden:
Befolgen Sie die [Amazon Bedrock-Dokumentation](/de/amazon-bedrock), [Google Cloud's Agent Platform-Dokumentation](/de/google-vertex-ai) oder [Microsoft Foundry-Dokumentation](/de/microsoft-foundry).
Verteilen Sie die Umgebungsvariablen und Anweisungen zum Generieren von Cloud-Anmeldedaten an Ihre Benutzer. Lesen Sie mehr darüber, wie Sie [die Konfiguration hier verwalten](/de/settings).
Benutzer können [Fuxi Code installieren](/de/setup#install-fuxi-code).
Verwaltung von Anmeldedaten
Fuxi Code verwaltet Ihre Authentifizierungsanmeldedaten sicher:
* **Speicherort**:
* Auf macOS werden Anmeldedaten im verschlüsselten macOS Keychain gespeichert.
* Auf Linux werden Anmeldedaten in `~/.fuxi/.credentials.json` mit Dateimodus `0600` gespeichert.
* Unter Windows werden Anmeldedaten in `%USERPROFILE%\.fuxi\.credentials.json` gespeichert und erben die Zugriffskontrolle Ihres Benutzerprofilverzeichnisses, das die Datei standardmäßig auf Ihr Benutzerkonto beschränkt.
* Wenn Sie die Umgebungsvariable `FUXI_CONFIG_DIR` unter Linux oder Windows gesetzt haben, befindet sich die Datei `.credentials.json` stattdessen in diesem Verzeichnis.
* Fuxi Code verwaltet `.credentials.json` über `/login` und `/logout`. Um Anfragen über einen benutzerdefinierten API-Endpunkt zu leiten, legen Sie stattdessen die Umgebungsvariable [`ANTHROPIC_BASE_URL`](/de/env-vars) fest.
* **Unterstützte Authentifizierungstypen**: Fuxi.ai-Anmeldedaten, Fuxi API-Anmeldedaten, Azure Auth, Bedrock Auth, Vertex Auth und [Fuxi Apps Gateway](/de/fuxi-apps-gateway) Sitzungs-Tokens.
* **Benutzerdefinierte Anmeldedaten-Skripte**: Die Einstellung [`apiKeyHelper`](/de/settings#available-settings) kann so konfiguriert werden, dass ein Shell-Skript ausgeführt wird, das einen API-Schlüssel zurückgibt.
* **Aktualisierungsintervalle**: Standardmäßig wird `apiKeyHelper` nach 5 Minuten oder bei HTTP 401-Antwort aufgerufen. Legen Sie die Umgebungsvariable `FUXI_CODE_API_KEY_HELPER_TTL_MS` für benutzerdefinierte Aktualisierungsintervalle fest.
* **Warnung bei langsamen Hilfsprogrammen**: Wenn `apiKeyHelper` länger als 10 Sekunden benötigt, um einen Schlüssel zurückzugeben, zeigt Fuxi Code eine Warnmitteilung in der Eingabeaufforderungsleiste an, die die verstrichene Zeit anzeigt. Wenn Sie diese Mitteilung regelmäßig sehen, überprüfen Sie, ob Ihr Anmeldedaten-Skript optimiert werden kann.
`apiKeyHelper`, `ANTHROPIC_API_KEY` und `ANTHROPIC_AUTH_TOKEN` gelten für die CLI und die Oberflächen, die sie umhüllen, einschließlich der VS Code-Erweiterung, des Agent SDK und GitHub Actions. Fuxi Desktop und Cloud-Sitzungen rufen `apiKeyHelper` nicht auf oder lesen diese Umgebungsvariablen nicht: Sie verwenden OAuth, außer Desktop-Sitzungen, die eine [von der Organisation verteilte Inferenzkonfiguration eines Drittanbieters](/de/llm-gateway-connect#desktop-app) ausführen, die sich mit den Anmeldedaten dieser Konfiguration authentifizieren.
Ablauf einer Anmeldung erneuern
Wenn die Anmeldung, die Sie mit `/login` erstellt haben, innerhalb von fünf Tagen abläuft, zeigt Fuxi Code beim Start eine Warnung an: `Your login expires in 3 days · run /login to renew`. Erfordert Fuxi Code v2.1.203 oder später.
Führen Sie `/login` aus, um zu erneuern. Die Warnung ist informativ und blockiert niemals eine Anfrage: Die Authentifizierung funktioniert weiterhin, bis die Anmeldung tatsächlich abläuft. Die Anmeldelebensdauer selbst bleibt unverändert; die Vorauswarnung ist das, was v2.1.203 hinzufügt.
Die Warnung wird nur angezeigt, wenn eine fuxi.ai- oder Fuxi Console-Anmeldung die aktive Anmeldedaten ist, und nicht, wenn ein Cloud-Anbieter, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` die Anmeldedaten bereitstellt.
Eine frühzeitige Erneuerung ist am wichtigsten für Sitzungen, die unbeaufsichtigt ausgeführt werden. Eine [Hintergrundsitzung in der Agent-Ansicht](/de/agent-view) oder eine [Remote Control](/de/remote-control) Sitzung, die länger als die Anmeldung läuft, stoppt den Fortschritt, sobald die Anmeldedaten ablaufen, und kann sich nicht erholen, bis Sie sich erneut anmelden.
Authentifizierungspriorität
Wenn mehrere Anmeldedaten vorhanden sind, wählt Fuxi Code eines in dieser Reihenfolge:
1. Cloud-Anbieter-Anmeldedaten, wenn `FUXI_CODE_USE_BEDROCK`, `FUXI_CODE_USE_VERTEX` oder `FUXI_CODE_USE_FOUNDRY` gesetzt ist. Siehe [Integrationen von Drittanbietern](/de/third-party-integrations) für die Einrichtung.
2. `ANTHROPIC_AUTH_TOKEN` Umgebungsvariable. Wird als `Authorization: Bearer` Header gesendet. Verwenden Sie dies, wenn Sie durch ein [LLM-Gateway oder einen Proxy](/de/llm-gateway) leiten, das sich mit Bearer-Tokens anstelle von Anthropic API-Schlüsseln authentifiziert.
3. `ANTHROPIC_API_KEY` Umgebungsvariable. Wird als `X-Api-Key` Header gesendet. Verwenden Sie dies für direkten Anthropic API-Zugriff mit einem Schlüssel aus der [Fuxi Console](https://platform.fuxi.com). Im interaktiven Modus werden Sie einmal aufgefordert, den Schlüssel zu genehmigen oder abzulehnen, und Ihre Wahl wird gespeichert. Um dies später zu ändern, verwenden Sie den Umschalter „Use custom API key" in `/config`. Im nicht-interaktiven Modus (`-p`) wird der Schlüssel immer verwendet, wenn er vorhanden ist.
4. [`apiKeyHelper`](/de/settings#available-settings) Skriptausgabe. Verwenden Sie dies für dynamische oder rotierende Anmeldedaten, wie kurzlebige Tokens, die aus einem Vault abgerufen werden.
5. `FUXI_CODE_OAUTH_TOKEN` Umgebungsvariable. Ein langlebiges OAuth-Token, das von [`fuxi setup-token`](#generate-a-long-lived-token) generiert wird. Verwenden Sie dies für CI-Pipelines und Skripte, bei denen Browser-Anmeldung nicht verfügbar ist.
6. Abonnement-OAuth-Anmeldedaten von `/login`. Dies ist die Standardeinstellung für Fuxi Pro, Max, Team und Enterprise-Benutzer.
Eine angemeldete [Fuxi Apps Gateway](/de/fuxi-apps-gateway) Sitzung steht außerhalb dieser Liste: Sie ist eine Anbieterauswahl wie Amazon Bedrock oder Google Cloud's Agent Platform und hat Vorrang vor ihnen. Wenn eine Gateway-Sitzung vorhanden ist, authentifiziert sich die CLI mit dem Gateway-Token, auch wenn `FUXI_CODE_USE_BEDROCK`, `FUXI_CODE_USE_VERTEX` oder `FUXI_CODE_USE_FOUNDRY` gesetzt ist, und die Bearer-Token-, API-Schlüssel- und `apiKeyHelper`-Einträge oben werden nicht verwendet.
Wenn Sie ein aktives Fuxi-Abonnement haben, aber auch `ANTHROPIC_API_KEY` in Ihrer Umgebung gesetzt haben, hat der API-Schlüssel Vorrang, sobald er genehmigt ist. Dies kann zu Authentifizierungsfehlern führen, wenn der Schlüssel zu einer deaktivierten oder abgelaufenen Organisation gehört. Führen Sie `unset ANTHROPIC_API_KEY` aus, um auf Ihr Abonnement zurückzugreifen, und überprüfen Sie `/status`, um zu bestätigen, welche Methode aktiv ist.
[Fuxi Code im Web](/de/fuxi-code-on-the-web) verwendet immer Ihre Abonnement-Anmeldedaten. `ANTHROPIC_API_KEY` und `ANTHROPIC_AUTH_TOKEN` in der Sandbox-Umgebung überschreiben diese nicht.
Generieren Sie ein langlebiges Token
Für CI-Pipelines, Skripte oder andere Umgebungen, in denen interaktive Browser-Anmeldung nicht verfügbar ist, generieren Sie ein einjähriges OAuth-Token mit `fuxi setup-token`:
```bash theme={null}
fuxi setup-token
```
Der Befehl führt Sie durch die OAuth-Autorisierung und gibt ein Token im Terminal aus. Er speichert das Token nirgendwo; kopieren Sie es und legen Sie es als `FUXI_CODE_OAUTH_TOKEN` Umgebungsvariable überall dort fest, wo Sie sich authentifizieren möchten:
```bash theme={null}
export FUXI_CODE_OAUTH_TOKEN=your-token
```
Dieses Token authentifiziert sich mit Ihrem Fuxi-Abonnement und erfordert einen Pro-, Max-, Team- oder Enterprise-Plan. Es ist auf Inferenz beschränkt und kann keine [Remote Control](/de/remote-control) Sitzungen einrichten.
[Bare Mode](/de/headless#start-faster-with-bare-mode) liest `FUXI_CODE_OAUTH_TOKEN` nicht. Wenn Ihr Skript `--bare` übergibt, authentifizieren Sie sich stattdessen mit `ANTHROPIC_API_KEY` oder einem `apiKeyHelper`.