Ihre Coding-Tools einrichten
npx uberllm init
Der Befehl findet die Coding-Tools auf Ihrem Computer und richtet jedes davon für die Verwendung von UberLLM ein. Sie benötigen Node.js 18 oder neuer. Es wird nichts anderes installiert.
Was passiert, wenn Sie es ausführen:
- Es listet die gefundenen Tools auf.
- Ihr Browser öffnet sich. Melden Sie sich an (oder erstellen Sie ein Konto) und drücken Sie Verbinden. Dadurch wird ein API key für diesen Computer erstellt.
- Der Schlüssel wird in
~/.uberllm/keygespeichert, einer Datei, die nur Sie lesen können. - Die eigene Konfigurationsdatei jedes Tools wird geändert, um UberLLM zu verwenden. Eine Kopie jeder Datei wird zuerst gespeichert.
- Es prüft, ob der Schlüssel funktioniert, und teilt Ihnen mit, was Sie neu starten müssen.
Wenn alles bereits eingerichtet ist, ändert sich nichts, wenn Sie es erneut ausführen.
Änderungen zuerst ansehen
npx uberllm init --dry-run
Dies druckt jede Datei, die es ändern würde, und die Zeilen, die es hinzufügen würde. Es öffnet den Browser nicht und schreibt nichts.
Was jedes Tool erhält
| Tool | Datei, die es ändert | Wie das Tool Ihren Schlüssel liest |
|---|---|---|
| Claude Code | ~/.claude/settings.json |
apiKeyHelper liest ~/.uberllm/key |
| Codex CLI | ~/.codex/config.toml |
der auth Befehl des Anbieters liest ~/.uberllm/key |
| OpenCode | ~/.config/opencode/opencode.json |
{file:~/.uberllm/key} |
| Kilo Code | ~/.config/kilo/kilo.jsonc |
die UBERLLM_API_KEY Variable |
| Goose | ~/.config/goose/custom_providers/uberllm.json |
die UBERLLM_API_KEY Variable |
| Aider | ~/.aider.conf.yml, ~/.aider.model.settings.yml |
eine private env-Datei in ~/.uberllm |
| Continue | ~/.continue/config.yaml |
~/.continue/.env (Continues eigene Secrets-Datei) |
Kilo Code und Goose lesen einen Schlüssel nur aus der Umgebung. Für diese wird eine Zeile zu Ihrem Shell-Profil hinzugefügt (~/.zshrc, ~/.bashrc oder fish). Diese Zeile liest die Schlüsseldatei; der Schlüssel selbst wird nicht in das Profil geschrieben. Unter Windows gibt der Befehl stattdessen diesen einen Schritt aus, den Sie ausführen müssen.
Claude Code fragt immer wieder nach seinen eigenen Claude-Modellen. Die anderen Tools erhalten ein Standardmodell: das erste Coding-Modell auf der Modellliste, das Anfragen entgegennimmt, wenn Sie den Befehl ausführen. Um es selbst auszuwählen:
npx uberllm init --model deepseek/deepseek-v4.1-flash
Tools, die innerhalb der App eingerichtet werden
Cursor, Cline und Roo Code speichern diese Einstellungen im Editor, nicht in einer Datei, die ein Befehl ändern kann. Für diese gibt der Befehl die drei zu befolgenden Schritte aus, wobei die Adresse und die Modell-ID ausgefüllt sind. Siehe Cursor, Cline und Roo Code.
Gemini CLI kommuniziert nur mit Servern, die Googles Gemini API sprechen, welche UberLLM nicht bedient. Um Gemini-Modelle über UberLLM zu verwenden, richten Sie OpenCode oder Codex mit einer Gemini-Modell-ID ein: npx uberllm init --tool opencode --model <id>.
Optionen
| Option | Was es bewirkt |
|---|---|
--tool <names> |
Nur diese Tools, durch Kommas getrennt: claude-code, codex, opencode, kilo-code, goose, aider, continue, cursor, cline, roo-code, gemini-cli. Richtet auch ein Tool ein, das nicht gefunden wurde. |
--project [dir] |
Nur dieses Projekt (Standard: der aktuelle Ordner). |
--model <id> |
Das festzulegende Standardmodell. |
--key <key> |
Diesen Schlüssel verwenden und den Browser überspringen. |
--relink |
Einen neuen Schlüssel im Browser abrufen, auch wenn bereits einer gespeichert oder festgelegt ist. |
--dry-run |
Anzeigen, was sich ändern würde. Nichts ändern. |
--undo |
Alles zurücksetzen. |
Welcher Schlüssel verwendet wird: --key, wenn Sie ihn übergeben, dann der bereits in
~/.uberllm gespeicherte Schlüssel, dann UBERLLM_API_KEY aus der Umgebung, dann der Browser.
Nur ein Projekt
cd my-project
npx uberllm init --project
Nur dieser Ordner läuft auf UberLLM; Ihre anderen Projekte bleiben unverändert. Dies funktioniert
für Tools, die eine projektbezogene Konfiguration haben: Claude Code
(.claude/settings.local.json), OpenCode (opencode.json) und Aider
(.aider.conf.yml). Es wird kein Schlüssel in den Projektordner geschrieben. Codex CLI, Kilo
Code, Goose und Continue werden pro Maschine eingerichtet, daher werden sie hier übersprungen.
Unter Windows wird Claude Code nicht pro Projekt eingerichtet, da dies den
Schlüssel in den Projektordner legen würde. Führen Sie den Befehl dort ohne --project aus.
Rückgängig machen
npx uberllm init --undo
- Eine Datei, die Sie seitdem nicht bearbeitet haben, wird genau so wiederhergestellt, wie sie war. Eine vom Befehl erstellte Datei wird entfernt.
- Eine Datei, die Sie seitdem bearbeitet haben, behält Ihre Änderungen. Nur das, was der Befehl hinzugefügt hat, wird entfernt, und die Einstellungen, die er ersetzt hat, werden wiederhergestellt. Die Kopie von vor der Ausführung des Befehls bleibt in
~/.uberllm/backups/. - Die gespeicherte Schlüsseldatei wird entfernt, wenn dieser Befehl sie erstellt hat und kein von ihm eingerichtetes Tool sie noch verwendet. Eine Schlüsseldatei vom Claude Code Installer bleibt bestehen. Um den Schlüssel ebenfalls zu deaktivieren, löschen Sie ihn auf Ihrer Schlüsselseite.
Machen Sie ein Tool mit --undo --tool codex rückgängig, oder ein Projekt mit
--undo --project. Kilo Code und Goose teilen sich die Zeile in Ihrem Shell-Profil, daher
bleibt sie bestehen, bis beide rückgängig gemacht wurden.
Wo Dinge aufbewahrt werden
| Pfad | Was es ist |
|---|---|
~/.uberllm/key |
Ihr Schlüssel. Nur Sie können ihn lesen (Modus 600). |
~/.uberllm/backups/ |
Eine Kopie jeder Datei von vor ihrer Änderung. |
~/.uberllm/init.json |
Die Liste der Dateien, die der Befehl geändert hat, verwendet von --undo. |
Der Schlüssel wird an api.uberllm.dev und nirgendwo anders hin gesendet. Er wird niemals gedruckt.
Wenn eine Datei unberührt bleibt
Der Befehl überschreibt keine Datei, die er beschädigen könnte. Er informiert Sie und gibt die Schritte aus, die manuell ausgeführt werden müssen. Dies geschieht, wenn:
- eine JSON-Konfiguration Kommentare enthält (
opencode.jsonc,kilo.jsonc), da ein Überschreiben diese verlieren würde; - eine JSON-Konfiguration nicht gelesen werden kann;
- Continues
models:in einer Zeile geschrieben ist; - mit
--projecteine Konfigurationsdatei ein Link zu einer Datei außerhalb des Projekts ist.
Das Tool wird dann am Ende des Durchlaufs als „noch nicht eingerichtet“ aufgeführt.
Fehlerbehebung
| Was Sie sehen | Was zu tun ist |
|---|---|
No supported coding tool was found |
Installieren Sie zuerst das Tool, oder benennen Sie es: npx uberllm init --tool codex. |
The gateway did not accept the key |
Führen Sie npx uberllm init --relink aus, um einen neuen key zu erhalten. |
| Ein Tool verwendet noch seinen alten Anbieter | Starten Sie es neu. Für Kilo Code und Goose öffnen Sie zuerst ein neues Terminal, damit die neue Variable geladen wird. |
ANTHROPIC_API_KEY is set in your shell |
Claude Code verwendet diese Variable vor dem gespeicherten key. Entfernen Sie sie aus Ihrem shell profile. |
402 wenn ein Tool eine request sendet |
Fügen Sie Guthaben auf der Guthabenseite hinzu. |