Cline API-Key verwalten: Speicherung, Rotation, Team (2026)

Wer in Cline eigene Modelle anbindet, nutzt den Key als Zugang, aber auch als Grenze für Kosten und Sicherheit. Ein nachlässig angelegter Key führt häufig zu ungewöhnlichem Verbrauch, unklarer Zuordnung, weiterhin aktiven Keys nach einem Austritt und manchmal dazu, dass er über Konfigurationsdateien in Backups oder Repositories gelangt.

Dieser Artikel folgt der Reihenfolge „Erstellung – mehrere Modelle – Speicherung – Rotation – Rechte – Team – Fehlersuche“. Oberfläche und Speicherweise können sich mit Versionen ändern; maßgeblich sind die aktuelle Version und die offizielle Dokumentation.

Hinweis: Cline ist eine Marke von Cline Bot Inc. Dieser Artikel dient ausschließlich der technischen Erläuterung; es besteht keine Zugehörigkeit, Vertretung oder Billigung durch Cline Bot Inc. Produktfunktionen, Oberfläche und Abrechnungsregeln richten sich nach der offiziellen Cline-Dokumentation.

1. Zuerst klären, was „Cline API Key“ bedeutet

Der Begriff wird häufig für drei verschiedene Dinge verwendet:

Cline-Plattformzugang: für das eigene Kontosystem oder Plattformschnittstellen von Cline; das Kontingent legt Cline fest.
Anbieter-Key: von OpenAI, Anthropic, Google und anderen ausgestellt und im jeweiligen Anbieterfeld von Cline eingetragen.
Gateway-Key: von einem kompatiblen Dienst wie der ZSQH AI Gateway ausgestellt, beginnt meist mit sk- und ruft über das OpenAI-kompatible Protokoll mehrere Modelle auf.

Dieser Artikel behandelt die dritte Art. Sie dient nicht zur Anmeldung bei Cline und kann die Plattformschnittstellen von Cline nicht aufrufen. Der richtige Einstieg ist OpenAI Compatible, nicht ein Spezialfeld für OpenAI, Anthropic oder Azure.

2. Key erstellen: Grenzen festlegen, dann kopieren

Klären Sie vorher: Wer nutzt ihn, in welchem Projekt, und wie viel darf höchstens verbraucht werden?

Öffnen Sie die Registrierungsseite der ZSQH AI Gateway und melden Sie sich in der Konsole an.
Gehen Sie zu „API-Keys“ und legen Sie einen neuen Key an.
Der Name enthält Nutzer, Gerät und Zweck, etwa cline-zhang-macbook-daily, nicht nur test.
Legen Sie Ausgabenlimit und Ablaufdatum fest; unterstützt die Konsole einen Modellbereich, begrenzen Sie die nutzbaren Modelle nach Projekt.
Prüfen Sie Guthaben und Kontingent, damit nicht erst nach der Konfiguration auffällt, dass keine Aufrufe möglich sind.
Kopieren Sie den Key in den Passwortmanager, nicht zuerst in Chatwerkzeuge oder Tickets.

Notieren Sie ihn für Rotation und Übergabe in dieser Form:

Zweck: cline-zhang-macbook-daily
Base URL: https://ai.zhongshangqihang.com/v1
Key: sk-... (nur im Passwortmanager gespeichert)
Modell: Modell-ID laut aktueller Anzeige auf der Seite „Modellpreise“
Limit: gemäß Projektbudget
Ablauf: 2027-01-31

Der Key wird meist nur einmal vollständig angezeigt; geht er verloren, legen Sie einen neuen an und deaktivieren den alten. Modelle und Preise ändern sich; maßgeblich sind die Modellpreise.

3. Mehrere Modelle konfigurieren

In der VS-Code-Erweiterung bilden API Provider, Base URL und Modell meist eine aktuell wirksame Konfiguration; ein Modellwechsel erfolgt in den Einstellungen oder im Aufgabenauswähler. Ob sich mehrere Konfigurationen pro Projekt speichern lassen, hängt von Version und Dokumentation ab.

Die verlässlichere Multi-Modell-Verwaltung liegt auf der Gateway-Seite: unterschiedliche Keys für unterschiedliche Szenarien und die Trennung nach Limit, Modellbereich und Protokoll. Selbst wenn die Konfiguration eines Rechners verändert wird, bleibt der Schaden begrenzt.

Szenario	Modellstufe	Key-Strategie	Beachten
Alltägliche Fragen, kleine Änderungen	Leichtes, schnelles Modell	Persönlicher Key	Günstig, aber bei komplexen Aufgaben begrenzt
Hauptsächliche Codeänderung, Agent-Aufgaben	Haupt-Codemodell	Persönlicher Key	Muss Tool-Aufrufe unterstützen
Architektur, schwierige Fehlersuche	Leistungsfähiges Modell	Projekt-Key mit Freigabe	Höhere Kosten, Nutzung begrenzen
Automatisierung, CI, Skripte	Stabile Modellversion	Eigener Service-Key	Separates Limit, nicht mit persönlichem Key mischen
Kurzfristige Tests	Kostengünstiges Modell	Kurzlebiger Key	Kürzeste Ablaufzeit setzen

Für die Kommandozeile lässt sich cline auth verwenden, um Anbieter, Key, Modell und Base URL zu konfigurieren; die Parameter können sich je nach Version ändern, prüfen Sie vorher die lokale Hilfe:

export ZSQH_API_KEY="sk-... (aus dem Passwortmanager, nicht ins Skript schreiben)"
cline auth -p <provider-id> -k "$ZSQH_API_KEY" \
  -m <model-id> -b https://ai.zhongshangqihang.com/v1

Beachten Sie, dass der über -k übergebene Key als dauerhafte Konfiguration des Anbieters gespeichert werden kann. Verwenden Sie dies nur auf vertrauenswürdigen Rechnern und stellen Sie sicher, dass Shell-Historie, Prozessliste und Protokolle keinen Klartext enthalten. Die CLI unterstützt --config, --data-dir oder CLINE_DIR und CLINE_DATA_DIR, um Konfigurationsverzeichnisse zu isolieren.

4. Wo der Key gespeichert wird

Neuere Versionen legen die globalen Einstellungen unter ~/.cline/data/settings/ ab:

providers.json: Anbieterkonfiguration; laut offizieller Dokumentation einschließlich API-Key.
global-settings.json: allgemeine globale Einstellungen.
cline_mcp_settings.json: MCP-Server-Einstellungen, möglicherweise mit Tokens für Drittdienste.

Projektbezogene Konfigurationen liegen üblicherweise im Ordner .cline/ des Repository-Stamms, darunter Regeln, Workflows, Hooks und Agenten. Je nach Version kommen VS-Code-Schlüsselspeicher oder ein einheitliches Datenverzeichnis zum Einsatz; eine Verschlüsselung des Keys darf nicht vorausgesetzt werden.

Behandeln Sie die Dateien daher als sensible lokale Dateien:

Festplattenverschlüsselung und Sperrbildschirm-Passwort aktivieren, lokale Rechte begrenzen.
~/.cline nicht in öffentliche Cloud-Laufwerke, Repositories oder gemeinsame Backups aufnehmen.
Vor dem Commit .vscode/, .cline/, .clinerules und Skripte prüfen, ob sie Keys enthalten.
Tokens in MCP-Konfigurationen ebenfalls als Keys behandeln.
Bei Screenshots, Bildschirmaufnahmen und Fernwartung die Einstellungsseite abdecken.
Vor der Synchronisierung von Konfigurationen Umfang und Verschlüsselung klären und dann entscheiden, ob Key-Dateien einbezogen werden.

5. Rotation und Sperrung

Empfohlen ist eine Rotation alle 90 Tage oder sofort bei Personalwechsel, Gerätewechsel oder Verdacht auf Offenlegung. Rotieren heißt parallel aufbauen und dann umstellen, nicht löschen und neu erstellen.

Einen neuen Key mit gleichen Rechten und Datumssuffix anlegen.
In den Cline-Einstellungen den Key ersetzen oder die Anbieterkonfiguration der CLI aktualisieren.
Eine Testanfrage senden und prüfen, ob im Gateway-Protokoll der neue Key erscheint.
Eine Zeit lang Fehlerquote und Verbrauch beobachten, um vergessene Clients zu erkennen.
Den alten Key deaktivieren und erst nach einer Weile löschen.

Bei Verdacht auf Offenlegung gilt die umgekehrte Reihenfolge: zuerst deaktivieren oder löschen, dann auffällige Nutzung, Quelle und Zeitraum prüfen, anschließend das Team informieren sowie Repository und Protokolle kontrollieren. Bei Austritt oder Gerätewechsel noch am selben Tag deaktivieren, nicht bis zur nächsten Prüfung warten.

Bestandsaufnahme vor der Rotation: VS-Code-Erweiterung, CLI, CI, andere Editoren und temporäre Skripte. Wer nur den Key in der IDE austauscht, lässt möglicherweise einen alten Key in automatisierten Aufgaben weiterlaufen.

6. Minimale Rechte und Teamregeln

Ein Key pro Person: Ein gemeinsamer Key erlaubt keine Zuordnung und erschwert bei Offenlegung die Eingrenzung. Gemeinsame Dienste erhalten einen eigenen Key.
Ein Key pro Zweck: Alltagsentwicklung, Automatisierung und kurzfristige Tests trennen, um Limits und Deaktivierung zu erleichtern.
Obergrenzen setzen: Limit, Ablaufdatum und Modellbereich, wo möglich; mindestens die ersten beiden.
Zentraler Eingang: Möglichst über ein einheitliches Gateway anbinden, um Mitglieder-, Modell- und Verbrauchsprotokolle für Audit und Kostenzuordnung zu behalten.
Verzeichnis pflegen: Nur Key-Name, Inhaber, Zweck, Erstellungs- und Ablaufdatum erfassen, nie den vollständigen Key.
Regelmäßig prüfen: Monatlich ungenutzte Keys, überzogene Keys und auffällig steigende Authentifizierungsfehler kontrollieren.
Ein- und Austrittsprozess: Erstellung, Übergabe und Deaktivierung in die Onboarding- und Offboarding-Checklisten aufnehmen.
Datenklassifizierung: Festlegen, welche Repositories welche Modelle und Kanäle nutzen dürfen; sensible Projekte vorher bewerten.
Agent-Rechte begrenzen: Automatische Freigabe und YOLO-Modus verstärken Fehlbedienung und Prompt-Injection; Standardrechte und Ausnahmegenehmigungen definieren.
Erweiterungen und MCP prüfen: Nur aus vertrauenswürdigen Quellen installieren; Hooks, Plugins und MCP-Server können Code ausführen oder auf das Netzwerk zugreifen.

Kostenbetrachtungen richten sich nach den Modellpreisen. Beurteilen Sie Preise nicht nach dem Eindruck einer einzelnen Aufgabe, sondern nach Anfragenzahl, Kontextlänge und Modellstufe.

7. Fehlersuche

401 oder Invalid API Key: Key falsch, deaktiviert oder beim Einfügen mit Leerzeichen und Zeilenumbrüchen versehen. Löschen und vollständig neu kopieren.
403: Kontingent erschöpft, Key-Rechte unzureichend oder Modell nicht im erlaubten Bereich.
404 oder Model Not Found: Base-URL-Pfad falsch oder Modell-ID existiert nicht. Die Adresse bei /v1 belassen, ohne zusätzliches /chat/completions.
429: Rate Limit erreicht oder Key-Kontingent erschöpft. Verbrauch und Limits in der Konsole prüfen.
Timeout: Endpunkt nicht erreichbar, Netzwerkpfad gestört oder Proxy blockiert. Zuerst mit einer einfachen Anfrage die Erreichbarkeit prüfen.
Kontextüberschreitung: Prüfen, ob das Kontextfenster in Cline der tatsächlichen Modellspezifikation entspricht, und den Aufgabenumfang verkleinern.
Chat funktioniert, Agent-Aktionen scheitern: Zuerst prüfen, ob das Modell Tool-Aufrufe unterstützt, statt einen Key-Fehler anzunehmen.
CLI funktioniert, Erweiterung nicht: Beide können unterschiedliche Konfigurationsverzeichnisse lesen; ~/.cline und die Projektkonfiguration getrennt prüfen.
Fehler direkt nach dem Key-Wechsel: Prüfen, ob das Speichern erfolgreich war, und im Gateway-Protokoll kontrollieren, ob der neue Key Anfragen erhält.

Häufige Fragen

Wo liegt der Cline-Key, und ist das sicher?

In neueren Versionen unter ~/.cline/data/settings/providers.json, einschließlich Anbieterkonfiguration und API-Key; MCP-Einstellungen können weitere Tokens enthalten. Die offizielle Dokumentation sagt keine Verschlüsselung zu; behandeln Sie die Datei als sensibel, aktivieren Sie Festplattenverschlüsselung und vermeiden Sie die Synchronisierung an öffentliche Orte.

Kann ein Key für mehrere Modelle verwendet werden?

Üblicherweise ja, solange das Gateway dem Key diese Modelle erlaubt. Ob sich der Modellbereich einschränken lässt, hängt von der Konsole ab; falls nicht, begrenzen Sie den Schaden mindestens über Limits und Protokolle und legen für teure Modelle einen eigenen Key an.

Wie teilt ein Team Modelle, ohne Keys preiszugeben?

Geben Sie nicht denselben Key an alle weiter. Besser ist ein eigener Key pro Person im Gateway, einheitliche Base URL und Modellzuordnung sowie zentrale Verwaltung von Limits, Protokollen und Deaktivierung durch Administratoren. Gemeinsame Dienste erhalten einen eigenen Key mit eigenem Limit.

Beeinflusst eine Key-Rotation laufende Aufgaben?

Bereits gesendete Anfragen sind möglicherweise nicht betroffen, spätere Anfragen verwenden den neuen Key. Wechseln Sie in einer ruhigen Phase, senden Sie direkt danach eine Testanfrage und deaktivieren Sie erst dann den alten Key. Bei langen Aufgaben vorher klären, ob sie unterbrochen werden können.

Was ist bei einer Key-Offenlegung zuerst zu tun?

Zuerst den Key deaktivieren oder löschen, um den Schaden zu begrenzen, dann auffällige Nutzung und Aufrufquellen prüfen. Klären Sie nicht zuerst den Offenlegungsweg. Anschließend Repository, Protokolle, Chatverläufe und Backups kontrollieren und bei Bedarf weitere Zugangsdaten rotieren.

Fazit

Die Key-Konfiguration in Cline ist nicht kompliziert; schwierig ist die langfristige Verwaltung: nachvollziehbare Namen, begrenzte Kontingente, geschützte Speicherung und die Fähigkeit, bei einer Offenlegung den Schaden zu begrenzen. Registrieren Sie sich bei der ZSQH AI Gateway, legen Sie einen Cline-spezifischen Key an und ziehen Sie die Rechte anschließend schrittweise gemäß der Teamrichtlinie an. Prüfen Sie die Kosten regelmäßig anhand der Modellpreise.