Ein-Klick-Einrichtungsskript

Ein Befehl zur vollständigen Konfiguration von Claude Code / Codex: latenzbasierte Endpoint-Auswahl, Konfigurationsdatei-Schreiben, CLI-Installation und Verbindungsprüfung — ohne sudo / Administratorrechte

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Mit einem einzigen Befehl von Null auf funktionsfähig: Das Skript wählt den schnellsten Endpoint über einen Latenztest, fragt Sie nach Ihrem API-Key, schreibt die Konfiguration, installiert bei Bedarf Node.js und die CLI und sendet anschließend eine minimale Anfrage zur Verbindungsprüfung. Wählen Sie zunächst Ihr Betriebssystem:

📖 Vor dem Ausführen holen Sie sich Ihren API-Key (beginnt mit cr_) im QCode.cc Dashboard; das Skript fordert Sie zum Einfügen auf (die Eingabe wird nicht angezeigt). Der Key wird bei jeder Option gleich verwendet. Noch nicht gewählt? Lesen Sie Den passenden Tarif wählen und holen Sie sich dann im Dashboard Ihren Key.

Sie betreiben Agenten auf einem Cloud-Server? Auf der Server-Seite steht derselbe Befehl; was danach kommt — Key setzen und Aufgaben nach dem Abbruch weiterlaufen lassen — steht in Agenten auf einem Cloud-Server betreiben.

Interfacesprache¶

Die Skripte folgen Ihrer Systemsprache und wechseln automatisch zwischen Englisch und Chinesisch. Um eine Sprache explizit zu erzwingen:

# macOS / Linux
curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --lang zh

# Windows PowerShell
$env:QCODE_LANG='zh'; irm https://qcode.cc/install/claude-code.ps1 | iex

Chinesisch ist die Standardeinstellung, wenn Ihr System-Locale Chinesisch ist; die obigen einfachen Befehle sind davon nicht betroffen. Gleiches gilt für codex.

🍎 macOS / 🐧 Linux¶

Öffnen Sie ein Terminal und fügen Sie Folgendes ein (kein sudo erforderlich):

Claude Code¶

curl -fsSL https://qcode.cc/install/claude-code.sh | bash

Codex¶

curl -fsSL https://qcode.cc/install/codex.sh | bash

Die Konfiguration wird in Ihre Shell-Konfigurationsdatei geschrieben (ein verwalteter Block in ~/.zshrc / ~/.bashrc) oder ~/.codex/; falls Node.js fehlt, wird es über nvm in Ihr Home-Verzeichnis installiert.

🪟 Windows¶

Natives PowerShell genügt — kein WSL, keine Administratorrechte. Öffnen Sie Windows Terminal oder PowerShell und fügen Sie Folgendes ein:

Claude Code¶

irm https://qcode.cc/install/claude-code.ps1 | iex

Codex¶

irm https://qcode.cc/install/codex.ps1 | iex

Kein irm oder durch die Ausführungsrichtlinie blockiert?¶

Die Skripte lockern die Ausführungsrichtlinie bereits nur für die aktuelle Ausführung (Ihre benutzer- und maschinenseitigen Einstellungen bleiben unberührt) und bevorzugen npm.cmd gegenüber der richtlinienbeschränkten npm.ps1. Für die verbleibenden Fälle:

1. In CMD (Eingabeaufforderung) oder wenn „irm is not recognized“ erscheint

irm ist ein PowerShell-Befehl und existiert in CMD nicht. Dieser funktioniert in beiden:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://qcode.cc/install/claude-code.ps1 | iex"

2. Zum Ausführen per Doppelklick oder wenn iex durch die Richtlinie blockiert wird

Laden Sie den .cmd-Bootstrapper herunter und doppelklicken Sie ihn oder führen Sie ihn in CMD aus:

curl -fsSL https://qcode.cc/install/claude-code.cmd -o "%TEMP%\qcode.cmd" && "%TEMP%\qcode.cmd"

Windows 10 1803+ bringt curl.exe mit. Die .cmd wählt PowerShell 7, falls verfügbar, erzwingt TLS 1.2 und hält das Fenster am Ende offen, sodass ein Doppelklick nicht zu schnell wieder verschwindet. Für eine chinesische Benutzeroberfläche: "%TEMP%\qcode.cmd" zh. Für Codex ersetzen Sie claude-code durch codex.

3. Damit claude / codex auch in künftigen PowerShell-Sitzungen unblockiert laufen

Die obige Lockerung gilt nur für die aktuelle Sitzung. Führen Sie dies einmal aus — keine Administratorrechte erforderlich, es betrifft nur Ihr eigenes Konto:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Windows-spezifische Hinweise:

• Die Konfiguration wird in Benutzer-Umgebungsvariablen geschrieben (Codex schreibt nach %USERPROFILE%\.codex\); vorherige Werte werden automatisch nach %USERPROFILE%\.qcode\ gesichert
• Falls Node.js fehlt, wird die LTS-Version über winget installiert; ohne winget erhalten Sie Anweisungen zur manuellen Installation von nodejs.org
• Nach Abschluss der Einrichtung übernehmen neu geöffnete PowerShell-/Terminalfenster die Konfiguration automatisch; Editoren wie VS Code benötigen einen Neustart
• Falls das Skript durch die Ausführungsrichtlinie blockiert wird, führen Sie zuerst Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser aus und versuchen Sie es dann erneut

Codex: Desktop-App oder CLI¶

codex.sh / codex.ps1 fragt zunächst, welchen Client Sie verwenden möchten:

1. Codex Desktop-App (Standard, einfach Enter drücken) — schreibt nur die Konfigurationsdateien; Node.js und das CLI werden weder geprüft noch installiert
2. Codex CLI — gilt auch für die App; installiert bei Bedarf Node.js und das Codex CLI

Wenn Sie nur die Desktop-App nutzen, wählen Sie 1 – Node wird dann nie angefasst. Führen Sie das Skript erneut aus und wählen Sie 2, sobald Sie später das CLI benötigen. Nicht interaktiv: --target app / --target cli (Windows: -Target app / -Target cli).

ℹ️ Ist ~/.codex/config.toml bereits vorhanden, aktualisiert das Skript nur model_provider / model / review_model / model_reasoning_effort und die Tabelle [model_providers.qcode]. Ihre MCP-Server, Profile, approval_policy und übrigen Einstellungen bleiben erhalten; die Originaldatei wird vorher weiterhin als .bak.<timestamp> im selben Verzeichnis gesichert. Nur eine fehlerhafte Datei, die sich nicht sicher zusammenführen lässt, wird komplett überschrieben — mit ausdrücklichem Hinweis. Ein profile = … auf oberster Ebene (von aktuellen Codex-Versionen nicht mehr unterstützt, sie verweigern das Laden) wird auskommentiert; um dieses Profil weiter zu nutzen, verschieben Sie die Tabelle [profiles.<Name>] nach ~/.codex/<Name>.config.toml, löschen die ursprüngliche Tabelle und führen codex --profile <Name> aus. Ist die Codex CLI installiert, lässt das Skript Codex die Konfiguration einmal laden und meldet, falls das nicht gelingt. Eine vom älteren Skript geschriebene Tabelle crs wird beim erneuten Ausführen automatisch in qcode umbenannt.

Was das Skript tut¶

1. Endpunktauswahl anhand der Latenz — sendet eine leichtgewichtige Anfrage an jeden der drei Endpunkte (api / asia / us) und empfiehlt den schnellsten (Sie können die Auswahl überschreiben)
2. Konfiguration schreiben — Claude Code: ein verwalteter Shell-Block auf macOS/Linux, benutzerbezogene Umgebungsvariablen auf Windows; Codex: ~/.codex/config.toml + auth.json (Standardmodell interaktiv wählbar, gpt-6.1-sol empfohlen)
3. Umgebung installieren (überspringbar) — prüft, ob Node.js vorhanden ist (das Claude-Code-Skript verlangt ≥ 22, das Codex-Skript ≥ 20), installiert andernfalls die LTS-Version über nvm (macOS/Linux) oder winget (Windows) und installiert anschließend das CLI per npm install -g; alles verbleibt in Ihrem Benutzerverzeichnis
4. Konnektivität prüfen — sendet mit Ihrem Key eine minimale Anfrage und gibt bei Fehlschlag gezielte Hinweise zur Fehlerbehebung anhand des HTTP-Statuscodes
5. Sicherung vor dem Schreiben — jede geänderte Datei wird zuerst als .bak.<timestamp> gesichert; auf Windows werden die bisherigen Umgebungsvariablen nach %USERPROFILE%\.qcode\ gesichert
6. Key-Bereinigung — umgebende Anführungszeichen, Leerzeichen und zusammen mit dem Key eingefügte breitformatige Satzzeichen werden automatisch entfernt; ein Key mit ungültigen Zeichen im Inneren wird direkt abgelehnt und nicht in Ihre Konfiguration geschrieben

Nicht interaktiver Modus (CI / ohne Rückfragen)¶

macOS / Linux:

curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --key cr_xxx --yes

Windows mit Parametern (analog zur Tabelle oben: -Key, -Domain, -Model, -Lang, -Target, -Yes, -NoInstall, -NoVerify, -DryRun, -Uninstall):

& ([scriptblock]::Create((irm https://qcode.cc/install/claude-code.ps1))) -Key cr_xxx -Yes

(Gleiches Muster für codex.ps1.)

Erst den Plan ansehen: --dry-run¶

Mit --dry-run (Windows: -DryRun) gibt das Skript nur seinen Plan aus: in welche Datei die Einstellungen kommen, den vollständigen verwalteten Block (der Key maskiert als cr_**** plus die letzten vier Zeichen), welche Schlüssel es in ~/.claude/settings.json abgleichen würde, config.toml und auth.json für Codex, die zu installierende Software und die Prüfanfrage, die es senden würde. Es schreibt keine Dateien, installiert nichts und sendet keine Prüfanfrage; es misst nur die Latenz (mit --domain entfällt auch das). Ohne Key zeigt es den Plan mit einem Platzhalter und hält nicht an, um danach zu fragen.

Deinstallieren: --uninstall¶

--uninstall (Windows: -Uninstall) entfernt die Einstellungen, die dieses Skript geschrieben hat und deren Werte noch so sind, wie es sie geschrieben hat. Node und das CLI bleiben installiert; am Ende zeigt es den passenden Befehl npm uninstall -g …, den Sie bei Bedarf selbst ausführen. Zuerst listet es die zu ändernden Dateien auf und fragt nach; --yes (Windows: -Yes) überspringt die Rückfrage, zusammen mit --dry-run listet es nur auf und ändert nichts.

curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --dry-run
curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --uninstall
curl -fsSL https://qcode.cc/install/codex.sh | bash -s -- --uninstall --yes

& ([scriptblock]::Create((irm https://qcode.cc/install/claude-code.ps1))) -DryRun
& ([scriptblock]::Create((irm https://qcode.cc/install/claude-code.ps1))) -Uninstall
& ([scriptblock]::Create((irm https://qcode.cc/install/codex.ps1))) -Uninstall -Yes

• Claude Code (macOS / Linux): der verwaltete Block # >>> qcode.cc claude-code >>> in Ihren Shell-Konfigurationsdateien (bei fish derselbe Block in conf.d/qcode.fish); im env von ~/.claude/settings.json ein ANTHROPIC_BASE_URL auf qcode.cc und das zugehörige ANTHROPIC_AUTH_TOKEN.
• Claude Code (Windows): die vom Skript gesetzten Benutzer-Umgebungsvariablen, sofern ihr Wert noch übereinstimmt; die alten Werte werden zuvor in %USERPROFILE%\.qcode\ gesichert. ANTHROPIC_MODEL bleibt erhalten; entfernen Sie es bei Bedarf selbst.
• Codex: die Tabelle [model_providers.qcode] und die von diesem Skript geschriebenen Top-Level-Schlüssel in config.toml (Schlüssel mit abweichendem Wert bleiben und werden gemeldet) sowie das von diesem Skript geschriebene OPENAI_API_KEY in auth.json.

Adresse und Key eines anderen Anbieters, Ihre übrigen Einstellungen und die PATH-Einstellung des CLI bleiben erhalten; jede geänderte Datei wird vorher als .bak.<Zeitstempel> gesichert. Gibt es nichts zu entfernen, meldet das Skript „No settings written by this script were found.“ und beendet sich normal. In bereits geöffneten Terminals verschwinden die Umgebungsvariablen erst in einem neuen Terminal.

Welche Dateien geschrieben werden / Rollback¶

Ein erneutes Ausführen des Skripts ist jederzeit sicher: Der verwaltete Block wird in-place aktualisiert, und Konfigurationsdateien werden vor dem Aktualisieren gesichert. Um die Einstellungen dieses Skripts auf einmal zu entfernen, verwenden Sie --uninstall (siehe oben).

FAQ¶

• Verifizierung liefert 401 — ungültiger oder abgelaufener Key: Prüfen Sie ihn im Dashboard (stellen Sie sicher, dass das Präfix cr_ vollständig übernommen wurde), und führen Sie das Skript erneut aus
• Verifizierung liefert 404 — falsche Endpoint-URL: Die BASE_URL sollte für Claude Code https://{domain}/api und für Codex https://{domain}/openai lauten, ohne abschließenden Schrägstrich
• Netzwerk-Timeout — führen Sie das Skript mit einem anderen Endpoint erneut aus (z. B. --domain asia); den Live-Status jedes Endpoints finden Sie unter probe.qcode.cc
• Befehl claude / codex nach der Installation unter Windows nicht gefunden — öffnen Sie ein neues PowerShell-Fenster (der PATH wird nur in neuen Sitzungen aktualisiert)
• Das Skript soll Node nicht installieren — fügen Sie --no-install (Windows: -NoInstall) hinzu, um nur die Konfiguration zu schreiben
• Skript vorher prüfen möchten — öffnen Sie https://qcode.cc/install/claude-code.sh und lesen Sie den Quellcode; das Skript benötigt weder sudo noch Administratorrechte und schreibt niemals in Systemverzeichnisse
• „The API key contains invalid characters“ — Anführungszeichen, Leerzeichen oder typografische Zeichen wurden zusammen mit dem Key eingefügt. Das Skript entfernt umgebende Anführungszeichen und Leerzeichen automatisch, Zeichen im Inneren werden jedoch weiterhin verworfen; kopieren Sie den Key erneut aus dem Dashboard
• „You are running this script with sudo“ — das Skript benötigt kein sudo. Mit sudo ausgeführt schreibt es die Konfiguration in das Home-Verzeichnis von root, von wo Ihre eigene Shell sie niemals lesen wird; führen Sie es erneut ohne sudo aus
• „Config was written, but verification did not pass“ — die Konfigurationsdateien sind bereits vorhanden; nur die abschließende Verbindungsprüfung ist fehlgeschlagen. Folgen Sie dem Statuscode in der Meldung (401 → Key erneut prüfen, 404 → Adresse prüfen, Timeout → anderen Endpoint versuchen), und führen Sie das Skript erneut aus
• „The env block in settings.json points Claude Code at a different endpoint“ — Sie haben zuvor einen anderen Relay-Dienst oder CC Switch genutzt. Der env-Block von ~/.claude/settings.json hat Vorrang vor Umgebungsvariablen, Claude Code würde also weiterhin dorthin verbinden (die Verbindungsprüfung des Skripts liest ihn nicht und wäre trotzdem erfolgreich). Lassen Sie das Skript diese Schlüssel auf QCode umstellen: Es sichert die Datei und ändert nur die Endpunkt-Schlüssel. Lehnen Sie ab, endet die Zusammenfassung gelb mit Exit-Code 1
• Codex wird immer langsamer und zeigt fortwährend „Reconnecting… / stream disconnected“ — in der Regel hat sich die Sitzung mit Screenshots/Bildern vollgesogen: Codex lädt bei jeder Runde die gesamte Konversation (einschließlich aller Bilder) erneut hoch, sodass Dutzende Screenshots einige Dutzend MB pro Request bedeuten — bei einer langsameren Verbindung nicht rechtzeitig abzuschließen. Starten Sie eine neue Sitzung mit /new (fassen Sie die Aufgabe in wenigen Sätzen zusammen); wenn die Sitzung bereits sehr groß ist, vermeiden Sie /compact — die Komprimierungsanfrage muss den gesamten Verlauf ebenfalls einmal vollständig hochladen. Künftig: weniger Screenshots pro Sitzung einfügen oder diese vorher verkleinern

Enterprise →