Einrichtungsleitfaden

Provider-Einrichtungsleitfaden

Einrichtungsschritte und Fehlerbehebung nach Tool durchsuchen.

Provider-Einrichtungsleitfaden/Übersicht über CLI-Tools

Übersicht über CLI-Tools

CLI bezeichnet ein Befehlszeilen-Tool und keine spezifische Software. Claude Code, Codex CLI, Gemini CLI, OpenClaw und OpenCode gehören alle zu dieser Kategorie: Sie geben natürliche Sprache im Terminal ein, und die Tools können Projekte einlesen, Code analysieren, Dateien erstellen, Befehle ausführen oder Sie beim Erledigen von Entwicklungsaufgaben unterstützen.

Was ist eine CLI und wozu dient sie?

CLI-Tools sind leistungsfähiger als herkömmliche Chat-Programme, können aber auch leichter fehlbedient werden. Wenn Einsteiger sie zum ersten Mal konfigurieren, sollten sie diese ausschließlich in Testprojekten ausführen und sie anfangs „nur analysieren, nicht ändern und keine Befehle ausführen“ lassen.

Was vorab vorbereitet werden sollte

VorbereitungsschritteBeschreibungWarum es wichtig ist
TerminalWindows nutzt PowerShell, macOS / Linux das TerminalDie CLI läuft vollständig im Terminal
Das Tool selbstInstallieren Sie zuerst Claude Code, Codex CLI, Gemini CLI, OpenClaw oder OpenCodeDie Konfigurationsdatei greift nur bei bereits installierten Tools
Key / AnmeldemethodeKann ein offizieller Login, ein API-Key, OAuth oder ein Provider-Key seinDie Authentifizierungsmethoden unterscheiden sich je nach CLI
Base-URLWird nur benötigt, wenn ein AI-Provider oder Proxy genutzt wirdDer Adress-Suffix kann je nach Protokoll variieren; es reicht daher nicht aus, einfach nur den Domainnamen zu ändern.
TestprojektErstellen Sie einen neuen leeren Ordner oder kopieren Sie das Projekt.Verhindert, dass bei der ersten Konfiguration ein echtes Projekt beschädigt wird
Die URLs in der Dokumentation eines Providers sind meist dessen eigene Beispiele. Wenn Sie die Werte eintragen, müssen Sie diese durch die API-Adresse und den Key Ihres eigenen Providers ersetzen. Falls dieser separate Schnittstellen für OpenAI, Claude und Gemini anbietet, dürfen die drei Adressen nicht miteinander vermischt werden.

Einstieg zu den Einzelseiten

Claude-Code-Konfiguration Key, Base-URL, Modell und settings.json für Claude Code.
Codex-CLI-Konfiguration config.toml, benutzerdefinierte Provider und Testmethoden für das Codex-Terminal-Tool.
Gemini-CLI-Konfiguration Hinweise zu Google-Login, API-Key und AI-Providern für Gemini CLI.
OpenClaw-Konfiguration Die Felder baseUrl und api von OpenClaw werden paarweise konfiguriert.
OpenCode-Konfiguration Verbindungsassistent, Speicherort der Konfigurationsdatei und Hinweise zur manuellen Konfiguration von OpenCode.

So wählen Sie die passende Seite

Was möchten Sie tun?Empfohlene SeiteBegründung
Nur mehrere CLI-Provider einheitlich verwalten und wechselnGrundlegende Schritte für CC-SwitchCC-Switch eignet sich besser für die zentrale Verwaltung von Providern und deren Verteilung auf Tools wie Claude, Codex, Gemini usw.
Nur Claude Code konfigurierenClaude-Code-KonfigurationBei Claude Code stehen die Anthropic-/Claude-bezogenen Keys, die Base-URL, der Modellname und die settings.json im Mittelpunkt
Nur Codex CLI konfigurierenCodex-KonfigurationBei Codex stehen config.toml, OpenAI-kompatible Provider, Modellnamen und Umgebungsvariablen im Fokus
Nur Gemini CLI konfigurierenGemini-KonfigurationDie Anmeldemethode, der Key sowie die Vertex-/Gemini-Schnittstellen unterscheiden sich von OpenAI-kompatiblen Schnittstellen
OpenClaw / OpenCode verwendenOpenClaw / OpenCodeDie Provider-Felder dieser beiden Tools können sich je nach Version ändern; beachten Sie die entsprechende Seite und die offizielle Dokumentation

Risiken, die vor der Konfiguration beachtet werden sollten

RisikenWo sie typischerweise auftretenEmpfehlungen
Tools können Projektdateien lesenClaude Code, Codex, Gemini, OpenClaw, OpenCodeFühren Sie das Tool beim ersten Mal in einem Testverzeichnis aus und öffnen Sie keine echten Produktionsprojekte
Modelle können Befehle ausführen oder vorschlagenAlle Coding-CLIsAktivieren Sie zuerst den Bestätigungsmodus und prüfen Sie jede Aktion sorgfältig, insbesondere beim Löschen, Verschieben, Installieren, Hochladen usw.
Konfigurationseinstellungen überschreiben sich gegenseitigSystem-Umgebungsvariablen, Projektkonfiguration, Benutzerkonfiguration, CC-SwitchWenn die Konfiguration nicht greift, prüfen Sie zuerst die Rangfolge; ändern Sie nicht mehrere Stellen gleichzeitig
Vermischung verschiedener ProtokolleOpenAI, Claude, Gemini, Vertex, kompatible Provider-SchnittstellenTragen Sie die Werte im Tool entsprechend der Schnittstelle ein, die das Backend Ihres Providers bereitstellt
Beispiele von Dritten ungeprüft kopiertDrittanbieter-Tutorials, Screenshots, veraltete DokumentationenURL, Key und Modellname aus dem Beispiel müssen zwingend durch die Angaben aus Ihrem eigenen Provider-Backend ersetzt werden

So führen Sie den ersten Sicherheitstest durch

Lassen Sie die CLI nach Abschluss der Konfiguration nicht sofort das echte Projekt bearbeiten. Erstellen Sie zunächst ein leeres Verzeichnis, legen Sie eine einfache Testdatei hinein und lassen Sie das Tool diese nur lesen und interpretieren, ohne die Datei zu verändern.

Sicherheits-Testbefehl für die CLI
Read only the current directory first. Tell me which files are here. Do not modify any files, run any commands, or install any dependencies.

Wenn dieser Schritt kein reguläres Ergebnis liefert, rufen Sie die entsprechende Seite zur Fehlerbehebung auf. Lassen Sie die CLI keinesfalls automatisch am echten Projekt arbeiten, bevor die erfolgreiche Konfiguration bestätigt ist.