API-Schlüssel und Umgebungsvariablen
Auf dieser Seite
Lektion aktualisiert am 2. November 2026 basierend auf API-Schlüsseln und Profilen: Der während der Installation eingegebene Schlüssel wird in den System-Schlüsselbund (Keychain) übernommen (die Datei
~/.vibe/.envdient nur als Fallback), und die Anmeldung über den Browser wird standardmäßig angeboten. Die Quelle für den verwendeten Schlüssel lässt sich mit/statusoder/whoamiermitteln. Quelle: API-Schlüssel und Profile.
Ihren Mistral API-Schlüssel erhalten
Um Vibe zu nutzen, benötigen Sie einen Mistral API-Schlüssel. Dieser authentifiziert Ihre Anfragen und ermöglicht es Vibe, mit den Modellen von Mistral zu kommunizieren. Ohne diesen Schlüssel installiert und gestartet das Tool zwar, ist jedoch keine Generierung möglich. Erstellen Sie den Schlüssel in sechs Schritten auf der Mistral Console:
- Gehen Sie zu console.mistral.ai
- Erstellen Sie ein Konto oder melden Sie sich an
- Navigieren Sie zum Abschnitt API Keys
- Klicken Sie auf Create new key
- Geben Sie einen beschreibenden Namen ein (z. B. “vibe-cli-dev”)
- Kopieren Sie den Schlüssel sofort – er wird nicht erneut angezeigt
Dieser letzte Punkt ist keine Formalität: Der Schlüssel ist nur einmal sichtbar. Schließen Sie den Tab zu früh, müssen Sie einen neuen Schlüssel generieren. Der Schlüssel folgt dem Format sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx und muss streng vertraulich behandelt werden. Jeder, der über den Schlüssel verfügt, kann Ihre API-Quote nutzen – und damit Ihr Budget aufbrauchen.
Drei Konfigurationsmethoden
Vibe akzeptiert drei Wege, um diesen Schlüssel bereitzustellen. Ihre Wahl hängt vollständig von Ihrem Arbeitskontext ab.
Methode 1: Interaktive Einrichtung
Dies ist die Standardmethode beim ersten Start und am einfachsten für eine persönliche Arbeitsstation. Vibe fragt Ihren Schlüssel direkt ab und speichert ihn:
vibe
# → "Please enter your Mistral API key:"
# Fügen Sie Ihren Schlüssel ein und drücken Sie Enter
Der Schlüssel wird in Ihrem System-Schlüsselbund (macOS Keychain, Windows Credential Manager…) gespeichert. Ist kein Schlüsselbund verfügbar, greift die Datei ~/.vibe/.env als Fallback, die nur für Sie lesbar ist. Beachten Sie, dass bei der ersten Anmeldung die Authentifizierung über Ihren Mistral-Account im Browser oft den Bedarf an einem Schlüssel ganz entfällt. Um zu sehen, welche Quelle Vibe tatsächlich nutzt, geben Sie während einer Sitzung /status oder /whoami ein.
# Falls der Schlüssel in der .env-Datei liegt (kein Schlüsselbund verfügbar)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...
Methode 2: Umgebungsvariable
Sobald Sie die Umgebung der persönlichen Arbeitsstation verlassen – etwa in einer CI/CD-Pipeline, einem automatisierten Skript oder auf einem geteilten Server – wird eine Umgebungsvariable bevorzugt, da sie nichts auf die Festplatte schreibt:
export MISTRAL_API_KEY="sk-your-key-here"
Machen Sie dies auf Ihrem System persistent, indem Sie diese Zeile in Ihre Shell-Konfigurationsdatei aufnehmen:
# In ~/.bashrc, ~/.zshrc oder ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"
Die Umgebungsvariable hat Vorrang vor der .env-Datei. Dies ermöglicht ein sehr praktisches Nutzungsmuster: Schlüssel können temporär gewechselt werden, ohne dauerhafte Änderungen vorzunehmen. Sie können beispielsweise mit Ihrem Entwicklungsschlüssel arbeiten und einen einzelnen Befehl dann mit einem anderen Schlüssel für eine sensible Operation voranstellen:
# Entwicklungsschlüssel
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"
# Produktionsschlüssel (temporär)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"
Methode 3: config.toml-Datei
Schließlich können Sie die Umgebungsvariable in der TOML-Konfigurationsdatei von Vibe referenzieren:
# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"
Beachten Sie, dass dieser Parameter den Schlüssel selbst nicht enthält, sondern nur den Namen der Variable, die gelesen werden soll. Diese Indirektion ist sinnvoll, wenn mit mehreren Anbietern gearbeitet wird, die jeweils ihre eigene Variable verwenden: api_key_env_var weist Vibe darauf hin, welche Variable für den Standardschlüssel zu verwenden ist.
Reihenfolge der Priorität
Wenn mehrere Methoden gleichzeitig konfiguriert sind, wendet Vibe folgende Reihenfolge an:
- Umgebungsvariable
MISTRAL_API_KEY(falls in der Shell definiert) .env-Datei in~/.vibe/.env- System-Schlüsselbund, in dem der Setup-Assistent den Schlüssel speichert
Für einen benutzerdefinierten Anbieter bezeichnet api_key_env_var in config.toml einfach die zu lesende Variable und folgt derselben Reihenfolge.
Denken Sie an die erste Zeile oben: Wenn eine Anfrage die Authentifizierung fehlschlägt, obwohl Ihre .env-Datei einen gültigen Schlüssel enthält, prüfen Sie zuerst, ob eine alte Variable in Ihrer Shell verbleibt und diese überschreibt.
Sicherheit des API-Schlüssels
Die erste Regel lautet: Geben Sie Ihren Schlüssel niemals in ein Git-Repository ein. Fügen Sie .env vor dem Erstellen der Datei in Ihre .gitignore hinzu. Ein Geheimnis, das in ein öffentliches Repository hochgeladen wurde, gilt als kompromittiert, auch wenn Sie den Commit später löschen. Nach derselben Logik teilen Sie Ihren Schlüssel niemals als Klartext in einer Nachricht oder einem Dokument. Wenn Sie einen Leckage vermuten, regenerieren Sie den Schlüssel unverzüglich.
Organisatorisch verwenden Sie getrennte Schlüssel für Entwicklung und Produktion. Wenn einer davon kompromittiert wird, können Sie ihn widerrufen, ohne den anderen zu unterbrechen. Schließlich setzen Sie auf der Mistral Console Ausgabenlimits. Dies ist das effektivste Sicherheitsnetz gegen ein sich wiederholendes Skript oder einen exponierten Schlüssel: Die Abrechnung wird automatisch gestoppt.
Prüfen, ob der Schlüssel funktioniert
Nach der Konfiguration sollten Sie nichts vorauszusetzen. Testen Sie mit einer minimalen Anfrage:
vibe "Say hello"
Ist der Schlüssel gültig, antwortet Vibe normal. Ist er ungültig oder abgelaufen, erhalten Sie eine klare Authentifizierungsfehlermeldung, was Ihnen erspart, die Ursache in der Installation zu suchen.
Wenn Sie zusätzliche Anbieter wie OpenRouter konfigurieren, benötigt jeder seinen eigenen Schlüssel. Beide koexistieren problemlos:
export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"
Die Konfiguration von Drittanbieter-Anbietern behandeln wir im Detail in einer separaten Lektion.
Kernaussagen
- Erhalten Sie Ihren Mistral API-Schlüssel unter console.mistral.ai
- Drei Konfigurationsmethoden: interaktive Einrichtung, Umgebungsvariable, config.toml
- Die Umgebungsvariable hat Vorrang vor der .env-Datei
- Geben Sie Ihren Schlüssel niemals in Git ein
- Setzen Sie Ausgabenlimits auf der Mistral Console