DEV Community: boluo

🔍 4 Befehle, mit denen ich prüfe, ob mein Claude-Code-Gateway wirklich läuft

boluo — Wed, 30 Sep 2026 06:23:12 +0000

🤖 AI-Hinweis: Beim Strukturieren und Formulieren dieses Beitrags habe ich ein Sprachmodell eingesetzt. Alle Befehle, Ausgaben und Versionsnummern habe ich auf meiner eigenen Maschine tatsächlich ausgeführt und überprüft.

TL;DR

Claude Code lässt sich auf ein eigenes Inference-Gateway umbiegen – es sind genau 6 Umgebungsvariablen.
claude --version beweist nur, dass der Client installiert ist. Nichts weiter. 🙃
Die beiden Base-URLs sind nicht symmetrisch: ANTHROPIC_BASE_URL ohne /v1, OPENAI_BASE_URL mit.
Das Panel in der Desktop-App ist standardmäßig unsichtbar – es steckt hinter dem Developer Mode.
Der eigentliche Test ist ein echter Request mit max_tokens=16. Alles davor ist Aufwärmen.
Nach der Konfiguration ein neues Terminal-Fenster. Im alten ist „command not found" das erwartete Ergebnis.

Gemessen habe ich alles auf:


Claude Code	`2.1.283`
Node.js	`v24.21.0`
OS	Windows 10 Pro 22H2 (build 19045)
Git	nicht installiert

Die letzte Zeile ist kein Tippfehler. Dazu komme ich am Ende. 👇

Das Problem: „installiert" ist nicht „läuft"

Ich wollte die Inference-Requests von Claude Code auf ein anderes Gateway umleiten. Die Konfiguration selbst war unspektakulär – ein paar Umgebungsvariablen, fertig.

Gehangen hat es danach.

Ich tippe claude --version, bekomme eine saubere Versionsnummer zurück und denke: passt. 🎉

Nur beweist das genau eine Sache – dass der Client auf der Platte liegt. Ob der Endpoint erreichbar ist, ob der Key gültig ist, ob das Modell überhaupt antwortet? Davon ist nichts geprüft.

Das ist der Punkt, an dem die meisten Anleitungen aufhören. Und genau da fangen die Probleme an.

0️⃣ Was hier technisch überhaupt passiert

Falls du das zum ersten Mal machst, kurz das Mentalmodell – ohne das sind die Fehlermeldungen später nicht lesbar.

Claude Code ist ein Client. Er muss zwei Dinge wissen: wohin der Request geht und womit er sich ausweist. Beides liest er beim Start aus dem Environment (oder, in der Desktop-App, aus den App-Settings). Dann baut er einen ganz normalen HTTPS-Request und schickt ihn los.

Mehr passiert nicht. Keine Magie, kein Daemon, keine Registrierung irgendwo.

Deshalb gibt es auch genau drei Stellen, an denen es schiefgehen kann:

Der Wert steht nicht da, wo der Client hinschaut. → Er nimmt den Default oder gar nichts.
Der Wert steht da, ist aber falsch formatiert. → Der Request geht raus und läuft ins Leere.
Der Wert ist korrekt, aber die Gegenseite lehnt ab. → Key abgelaufen, Quota leer, Modell unbekannt.

Und jetzt der Clou: Die Befehle, die alle als Erstes tippen, prüfen ausschließlich Kategorie 1 – und nicht mal die vollständig. Kategorie 2 und 3 sind für sie unsichtbar.

1️⃣ Erst rausfinden, in welcher Situation du bist

claude --version

Ausgabe	Welches Skript
Versionsnummer kommt	`configure` – schreibt nur die Config
Command not found	`setup` – installiert erst die Dependencies

Gute Nachricht: die configure-Variante hat einen Hard-Check eingebaut. Sie sucht als Erstes claude im PATH und bricht sofort ab, wenn sie nichts findet. Falsch gewählt = nichts kaputt, das Skript verweigert einfach den Dienst. 👍

Umgekehrt gilt das nicht. setup auf einer schon eingerichteten Maschine installiert die Dependencies neu. Also: diesen Schritt nicht überspringen.

2️⃣ Skript laufen lassen

Claude Code ist schon da – nur konfigurieren:

curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-claude-code/main/configure.sh | bash

irm https://raw.githubusercontent.com/xujfcn/crazyrouter-claude-code/main/windows/configure.ps1 | iex

Noch gar nichts da? Im selben Repo-Verzeichnis liegt die Full-Install-Variante – einfach configure im Befehl durch setup ersetzen (setup.sh bzw. windows/setup.ps1). Die installiert erst Git, Node.js und Claude Code und schreibt dann die Config.

Umgekehrt bitte nicht: setup auf einer schon eingerichteten Maschine installiert die Dependencies neu.

⚠️ Öffne die Links vorher im Browser und lies drüber. Das hat nichts damit zu tun, wer das Skript geschrieben hat – bei allem in der Form | bash oder | iex gehört das dazu. Die Details unten habe ich genau so aus dem Quellcode gelesen.

Das Skript fragt genau drei Dinge

Frage	Pflicht	Verhalten
Token	ja	Die Eingabe wird nicht angezeigt. Nach dem Einfügen bleibt der Bildschirm leer – das ist normal, nicht dreimal reinpasten 😅 Leer lassen = Fehler und Abbruch
Base URL	nein	Default vorhanden, entfernt einen überzähligen Slash am Ende automatisch
Modell	nein	Default vorhanden, später jederzeit änderbar

Zwei Dinge, die man nur durchs Lesen des Quellcodes erfährt:

Beim Token gibt es einen Format-Precheck (Prefix sk- / cr- / rk-), aber ein Mismatch erzeugt nur eine Warnung und blockt nicht. Warning gesehen? Erst weiterlesen, ob danach ein echter Fehler kommt.
Die Skript-Ausgabe ist auf Englisch. Ein Bildschirm voll Englisch ist also erwartbar.

Was passiert, wenn man mittendrin abbricht?

Habe ich getestet, weil ich es wissen wollte. Ich habe das Skript nicht-interaktiv laufen lassen: Es lädt sauber runter, meldet [OK] Claude Code detected: 2.1.283, kommt zum Token-Prompt – und steigt dort mit Exit-Code 1 aus, weil in einem nicht-interaktiven Subprozess nichts zu lesen ist.

Danach habe ich alle sechs Variablen einzeln kontrolliert: keine einzige verändert. 🙌

Das Skript sammelt also erst alle drei Antworten und schreibt dann. Ein Abbruch hinterlässt keine halbe Config. Praktisch heißt das: Wenn etwas schiefgeht, einfach nochmal starten – kein manuelles Aufräumen nötig.

Unattended auf dem Server

Wenn du nicht interaktiv sein kannst, Token vorher ins Environment:

export CRAZYROUTER_TOKEN="dein-token"
curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-claude-code/main/configure.sh | bash

(Bare-Metal-Server ohne Claude Code? Auch hier configure → setup.)

Ein Detail, das dieses Skript richtig macht: curl | bash läuft üblicherweise in einer Non-Login-Shell, und die kennt die npm-Global-Pfade oft nicht. Das Skript sucht deshalb aktiv in /usr/local/bin, ~/.local/bin und ~/.npm-global/bin nach claude. Und selbst wenn es nichts findet, schreibt es die Config trotzdem fertig und gibt Diagnose-Output aus – statt auf halber Strecke zu sterben.

Noch ein Wort zum Windows-`setup`

Weil das der Teil ist, der auf älteren Maschinen entscheidet, ob es klappt: Das Skript versucht zuerst winget. Ist kein winget da, fällt es auf Direct Download zurück (Node.js über einen fixierten LTS-Installer, Git über das offizielle Release). Und für PowerShell 5.1 aktiviert es explizit TLS 1.2 und 1.3 – ohne das scheitern die Downloads auf unpatchten Systemen mit einer Fehlermeldung, die überhaupt nicht nach TLS aussieht.

3️⃣ Nachsehen, was tatsächlich geschrieben wurde

Sechs Umgebungsvariablen auf User-Ebene:

ANTHROPIC_BASE_URL     Gateway-Adresse (OHNE /v1)
ANTHROPIC_AUTH_TOKEN   Token
ANTHROPIC_MODEL        Default-Modell
CLAUDE_MODEL           Default-Modell
OPENAI_API_KEY         derselbe Token
OPENAI_BASE_URL        Gateway-Adresse (MIT /v1)

Warum zwei Sets? Claude Code liest die Anthropic-Konvention, viele OpenAI-kompatible Tools die andere. Ein Token deckt beide Seiten ab.

Und hier kommt die Falle, die mich am meisten gekostet hat: die beiden Adressen sind nicht symmetrisch. Bei ANTHROPIC_BASE_URL gehört nur die Root-Domain rein – der Client baut /v1/messages selbst dran. Wer das /v1 manuell ergänzt, landet bei /v1/v1/messages – und das ist falsch. Ein Gateway, das strikt nach Pfad routet, antwortet darauf mit 404. Darauf verlassen kann man sich aber nicht: mein eigenes habe ich nachgemessen, es liefert auf diesen Pfad weiterhin 200. Der zweite Fall ist der unangenehmere, weil auf dem Bildschirm gar kein Fehler auftaucht.

OPENAI_BASE_URL braucht das /v1 dagegen zwingend.

Das Perfide daran: In diese Falle tappen ausgerechnet die ordentlichen Leute. Zwei Felder zeigen auf denselben Server, also bringt man sie in dieselbe Form. Der Instinkt ist völlig richtig – der Fall ist nur asymmetrisch. Es gibt keinen Linter dafür, weil syntaktisch beide Werte einwandfrei sind. Ergebnis: Claude Code läuft, die anderen Tools kommen nicht durch – meist mit 404, aber was genau zurückkommt, hängt vom Gateway ab. Oder umgekehrt. 🤦

Wo die Werte landen

Unter Windows direkt als User-Umgebungsvariablen. Unter macOS/Linux in einer env-Datei im Home-Verzeichnis plus eine Load-Zeile in der Shell-Startdatei.

Nettes Detail: die Startdatei wird nach der echten Login-Shell ausgewählt, nicht danach, welche Datei existiert. Auf Servern liegt gerne mal eine ungenutzte .bashrc rum, während der Login tatsächlich über zsh läuft – wer dort reinschreibt, schreibt ins Nichts. echo $SHELL, bevor du irgendwas anfasst.

Alternative: pro Projekt

Wer das System-Environment nicht anfassen will, legt eine .claude/settings.json ins Projekt-Root:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.crazyrouter.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-dein-token",
    "ANTHROPIC_MODEL": "claude-opus-4-8"
  }
}

Gilt nur für dieses Projekt – super, wenn verschiedene Repos über verschiedene Gateways laufen sollen. Aber: Das ist genauso Klartext wie die Umgebungsvariablen, nur deutlich leichter versehentlich zu committen. Wenn du diesen Weg gehst, sofort in die .gitignore. 🔐

Die drei Wege im Vergleich

	Skript	Desktop-GUI	`settings.json`
Scope	ganze Maschine	nur Desktop-App	nur dieses Projekt
URL-Normalisierung	ja (Trailing Slash weg)	nein	nein
Gut für	neue Maschine, Server, Wiederholbarkeit	Einzelplatz, gelegentlich ändern	mehrere Gateways parallel
Commit-Risiko	niedrig	niedrig	hoch ⚠️

4️⃣ Desktop-App: das versteckte Panel

Mit der Desktop-App brauchst du die Umgebungsvariablen nicht anzufassen. Aber das Panel ist standardmäßig nicht sichtbar. Es hängt unter dem Developer Mode.

Help → Troubleshooting → Enable Developer Mode

Danach startet die App einmal neu, und erst dann erscheint im Menü oben links ein Eintrag Developer:

Darunter dann Configure third-party inference:

Links Connection wählen. So sieht es bei mir konfiguriert aus:

ℹ️ Fairness-Hinweis: Auf meiner Maschine war der Developer Mode von vorher schon aktiv. Dass das Panel ohne ihn nicht sichtbar ist, habe ich aus der offiziellen Doku – selbst nachgestellt habe ich es nicht. Den Menüpfad gebe ich als dokumentiert weiter, nicht als reproduziert.

Feld für Feld:

Credential kind → Static API key. Bedeutet: Credential-Quelle festnageln. Danach wird nicht mehr auf Login-Status oder Umgebungsvariablen zurückgefallen. Für das Debugging ist das wertvoll, weil es das Szenario „ich dachte, ich gehe über mein Gateway, in Wahrheit bin ich auf den Default zurückgefallen" komplett ausschließt. Kehrseite: Wenn Requests trotz Konfiguration weiter zur alten Adresse gehen – hier zuerst schauen.
Gateway base URL → Das GUI räumt das Format nicht auf, anders als das Skript. Kein Slash am Ende, kein selbst ergänztes /v1, keine Query-Parameter.
Gateway API key → Nach dem Einfügen aufs Auge-Icon klicken und drüberschauen. Aus dem Browser kopierte Keys schleppen gerne ein unsichtbares Leerzeichen mit, und der Fehler sieht danach genau wie „Key ungültig" aus.
Gateway auth scheme → bearer oder x-api-key. Bestimmt, ob als Authorization: Bearer xxx oder als x-api-key: xxx gesendet wird.
Artifact preview iframe origin → leer lassen, wenn du keinen speziellen Bedarf hast.

Reihenfolge der Buttons beachten: zuerst oben rechts Test connection, und erst wenn das durch ist, unten rechts Apply Changes. Der Test läuft auch auf noch nicht angewendeten Werten durch – „getestet und Fenster zu" ist also eine zuverlässige Methode, nichts zu speichern. 💾

Noch eine Debug-Richtung: links gibt es außerdem Sandbox & workspace und Egress. Die Desktop-App sandboxt Tool-Traffic. Wenn alle Felder stimmen und Test connection trotzdem scheitert, lohnt ein Blick in die Liste der erlaubten Egress-Hosts. Bei mir ist das nie aufgetreten (die aktuelle Config geht direkt durch) – ich notiere es nur als Richtung, nicht als reproduzierten Fall.

5️⃣ Die vier Befehle 🎯

Eins – ist der Client da?

claude --version

Beweist: Im PATH liegt eine ausführbare Datei. Das ist der komplette Geltungsbereich. Bei mir: 2.1.283

Zwei – ist die Runtime da?

node --version

Beweist: Node.js ist installiert. Auch schon alles. Bei mir: v24.21.0

Drei – ist die Config wirklich geschrieben? Nicht „ich habe sie eingegeben", sondern „ich habe sie zurückgelesen".

env | grep -E 'ANTHROPIC|OPENAI'

'ANTHROPIC_BASE_URL','ANTHROPIC_AUTH_TOKEN','ANTHROPIC_MODEL','CLAUDE_MODEL','OPENAI_API_KEY','OPENAI_BASE_URL' |
  ForEach-Object { "{0,-22} {1}" -f $_, [Environment]::GetEnvironmentVariable($_,'User') }

Zwei Dinge prüfen: alle sechs vorhanden, und /v1 nur bei OPENAI_BASE_URL.

Vier – Endpoint, Key und Modell gleichzeitig ⬅️ der eigentliche Test

curl -s https://api.crazyrouter.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "reply with: pong"}]
  }'

max_tokens: 16 ist Absicht: Der Inhalt der Antwort ist irrelevant, relevant ist nur, dass es eine gibt. Eine erfolgreiche Antwort etabliert drei Fakten gleichzeitig – Endpoint erreichbar, Key akzeptiert, Modell antwortet.

Warum die ersten drei genau dort blind sind, wo es zählt

Alle drei inspizieren den Zustand deiner lokalen Maschine. Keiner von ihnen redet mit dem Gateway.

Diese Failure Modes sind für sie also komplett unsichtbar:

🔑 Key abgelaufen
📉 Quota leer
🏷️ Modell-ID wird vom Gateway nicht erkannt
🌐 Proxy oder VPN routet die Domain woandershin
🚧 Gateway-Domain nicht in der Egress-Whitelist

Alles davon geht durch Befehl 1–3 ohne eine einzige Warnung und fällt erst bei Nummer 4 um.

Dass die ersten drei durchgehen und der vierte scheitert, ist also nicht der Randfall – es ist die Normalform dieses Fehlers. Drei Viertel der üblichen Prüfung sind strukturell unfähig, das zu finden, was am wahrscheinlichsten kaputt ist. Wenn du nur einen Befehl machst: mach den vierten.

Zum Auth-Header noch: ich habe mit beiden Varianten je einen echten Request geschickt. Auf diesem Gateway antworten bearer und x-api-key mit 200. Das ist aber keine allgemeine Regel – die meisten Gateways akzeptieren nur eines, und die Fehlermeldung bei der falschen Wahl ist von „Key kaputt" praktisch nicht zu unterscheiden. Doku des Anbieters lesen.

🧰 Fehlermeldungen, die ich gesehen habe (und was sie wirklich bedeuten)

„command not found" direkt nach erfolgreicher Konfiguration

Umgebungsvariablen greifen nur für neu gestartete Prozesse. Im alten Fenster zu prüfen scheitert immer, und das ist das erwartete Ergebnis, keine Fehlkonfiguration. Fenster komplett schließen; ein neuer Tab reicht unter Windows nicht. Die erste Next-Step-Zeile des Skripts ist übrigens genau Open a NEW PowerShell window – geht in der englischen Ausgabe nur leicht unter.

„no token provided" – obwohl der Token gesetzt ist

Das hat mich am meisten Zeit gekostet, und ich war schon dabei, einen neuen Key auszustellen. Der Key war völlig in Ordnung. Die Prüfung lief in einem Subprozess, und in dessen Environment war $env:ANTHROPIC_AUTH_TOKEN einfach leer.

Aus Serversicht sind die zwei Fälle nicht unterscheidbar: Es kam ein Request ohne Key an. Woher soll der Server wissen, ob du keinen hast oder ob er unterwegs verloren ging? Die Meldung war präzise und schlimmer als nutzlos, weil sie mit voller Überzeugung auf die falsche Hypothese zeigte.

In PowerShell lieber explizit aus der User-Scope lesen statt auf $env: zu vertrauen:

[Environment]::GetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN','User')

404, obwohl die URL richtig aussieht

/v1 doppelt. Siehe oben. Das ist die häufigste Ausprägung der Asymmetrie.

Validierungsfehler bei der Endpoint-Adresse

Aus einem Share-Link kopiert? Dann hängt am Ende vermutlich ein ?utm_source=.... Im Browser egal, als API-Endpoint bestenfalls ignoriert, schlimmstenfalls Validierungsfehler.

Git-Installation scheitert – alles hinwerfen?

Nein. Auf dieser Maschine ist Git überhaupt nicht installiert, trotzdem läuft claude und trotzdem geht Befehl vier durch. Git ist keine Runtime-Dependency von Claude Code. Das Full-Setup-Skript installiert es für die Arbeit danach, nicht als Voraussetzung.

Und weil das die zweite Stelle war, an der ich mir selbst reingefallen bin: Ich hatte „kein Git" kurzzeitig als Ursache meines Problems abgehakt und angefangen, von dieser Annahme aus zu debuggen. Genau derselbe Fehler wie mit der Versionsnummer – ich habe einen Zustand erschlossen, den ich nicht beobachtet hatte, und bin dann selbstsicher weitergelaufen.

Takeaways

Die drei Dinge, die ich mir gemerkt habe:

ANTHROPIC_BASE_URL ohne /v1, OPENAI_BASE_URL mit. Vereinheitlichen ist falsch – und gibt nicht zwangsläufig einen 404.
Nach der Konfiguration ein neues Terminal-Fenster.
Endpoint-Adressen müssen sauber sein – keine Query-Parameter aus kopierten Links.

Und das übergeordnete: Die Disziplin liegt nicht in den Checks, sondern in der Bereitschaft, laut zu sagen, was ein Signal eigentlich beweist. Nicht worauf es hindeutet, sondern was es etabliert. Eine Versionsnummer etabliert, dass eine Datei auf der Platte liegt. Ein grünes Dashboard etabliert, dass ein Check gelaufen ist und unter einem Threshold blieb. Grüne Tests etablieren, dass die Assertions erfüllt sind, die du geschrieben hast.

Keins davon heißt „läuft". Alle sind deutlich billiger zu bekommen als „läuft" – deshalb sammeln sie sich an, und deshalb lassen wir sie das Ergebnis ersetzen.

Und zur Sicherheit: Token nicht ins Git committen, nicht in Screenshots reinrutschen lassen, beim Maschinenwechsel den alten Key widerrufen. Klingt banal – mir ist aber genau während dieses Debuggings aufgefallen, wie oft mein Key einfach im Klartext auf meinem eigenen Bildschirm lag. 🔐

Und bei euch? 💬

Mich interessiert vor allem eines: welcher der vier Befehle ist bei euch zuletzt gescheitert?

Ich habe den Verdacht, dass Nummer vier bei fast allen der Stolperstein ist – aber aus unterschiedlichen Gründen. Falsches Auth-Scheme? Proxy dazwischen? Modell-ID, die das Gateway nicht kennt? Schreibt es in die Kommentare, ich ergänze gern eine Fehlerliste.

Codex CLI unter Windows

boluo — Tue, 29 Sep 2026 08:15:16 +0000

„Die Installation ist fertig“ ist eine schlechte Abnahmebedingung für einen Coding-Agenten. Sie sagt nichts darüber aus, ob der richtige Dienst angesprochen wird oder ob das Ergebnis im Projekt landet. Für diese Anleitung beginnen wir deshalb mit einer kleinen Spezifikation: Eine lokale HTML-Seite soll einen Zähler anzeigen, ihn erhöhen und wieder auf null setzen können.

Wir richten dafür Codex CLI unter Windows ein und verbinden den Client über einen eigenen Provider mit Crazyrouter. Die Verbindung bleibt Teil der technischen Aufgabe: Schlüsselquelle, Modell-ID und Responses-Endpunkt werden ausdrücklich geprüft. Preisversprechen, Empfehlungen für unbekannte Konten oder behauptete erfolgreiche Modellaufrufe ersetzen diese Prüfung nicht.

Der Text ist auf Deutsch; die Protokollfelder und Befehle bleiben in ihrer tatsächlichen Schreibweise. Du kannst den gesamten Ablauf ohne Framework nachvollziehen. Eine installierte CLI brauchst du nicht erneut einzurichten, nur um jeden Absatz der Anleitung abzuarbeiten.

1. Erst festlegen, woran die Aufgabe scheitern könnte

Bevor ein Agent etwas baut, sollte klar sein, was du selbst überprüfen kannst. Für unseren Zähler gelten drei sichtbare Anforderungen: Beim Öffnen steht dort null; ein Klick erhöht den Wert um eins; Zurücksetzen stellt unabhängig vom bisherigen Wert null her. Speichern zwischen Browserbesuchen gehört ausdrücklich nicht zum Auftrag.

Diese Begrenzung macht einen Unterschied. Würden wir gleichzeitig Speicherung, Anmeldung und Synchronisation verlangen, könnte ein Fehler an vielen zusätzlichen Stellen entstehen. Ein einzelnes HTML-Dokument reicht dagegen aus, um Dateizugriff, generierten Code und Browserinteraktion zu untersuchen.

Prüfung	Beobachtung, die wir benötigen	Was dadurch noch offenbleibt
Programmstart	Version und Hilfe erscheinen	Zugang zum Modell
API-Probe	Ein kurzer Text wird tatsächlich geliefert	Vollständiges Agentenverhalten
CLI-Dialog	Antwort über den vorgesehenen Provider	Schreibberechtigung
Datei	`index.html` liegt im Übungsordner	Korrekte Bedienung
Interaktion	Erhöhen und Zurücksetzen funktionieren	Eignung für andere Projekte

Die Tabelle enthält Sollbedingungen, keine vorab ausgefüllten Testergebnisse. Ohne eigene gültige Zugangsdaten lässt sich der entfernte Teil nicht als bestanden markieren. Auch ein lokal simulierter HTTP-Responder könnte lediglich die Form eines Skripts prüfen, nicht dein Konto authentifizieren.

Lege dir eine kurze Notiz mit Version, Modell-ID und beobachtetem Ergebnis an. Damit kannst du nach einer Änderung dieselbe Aufgabe wiederholen. Die API-Key-Zeichenfolge gehört nicht in diese Notiz.

2. Den Windows-Unterbau vorbereiten

Wenn du noch nie mit PowerShell gearbeitet hast, führe diesen Abschnitt vollständig durch. Er erklärt auch Eingabeaufforderung und Zeilenumbrüche. Wenn die Werkzeuge bereits vorhanden sind, reichen die beschriebenen Versions- und Pfadprüfungen.

PowerShell öffnen und Befehle richtig einfügen

Suche im Windows-Startmenü nach PowerShell und öffne zunächst ein normales Fenster. Im Windows Terminal kannst du ein PowerShell-Profil auswählen. Ein Administratorfenster ist keine allgemeine Voraussetzung für jede Zeile dieser Anleitung; zusätzliche Rechte werden erst behandelt, wenn ein bestimmter Einrichtungsschritt sie verlangt.

Die Zeile mit PS und dem aktuellen Pfad ist die Eingabeaufforderung. Sie gehört nicht zum Befehl. Kopiere ausschließlich den Inhalt eines Codeblocks und drücke Enter.

Beginne mit einer Zeile, warte auf das Ergebnis und fahre dann fort. Wenn zwei Installationsbefehle ohne Zeilenumbruch aneinandergeraten, entsteht daraus kein gültiger längerer Befehl. Bei mehrzeiligen Blöcken mit Klammern muss dagegen der vollständige Block zusammenbleiben.

Zum Einfügen funktioniert häufig Strg + V, alternativ die rechte Maustaste oder Strg + Umschalt + V. Erscheint statt des normalen Prompts ein >>, erwartet PowerShell möglicherweise das Ende einer Zeichenkette oder eines Ausdrucks. Mit Strg + C kannst du diese unvollständige Eingabe abbrechen und sauber neu beginnen.

Die Endung .cmd verwenden wir bewusst. npm installiert unter Windows verschiedene Starter. PowerShell kann sonst einen Starter mit .ps1 auswählen, dessen Ausführung durch eine Richtlinie blockiert wird. Mit npm.cmd und codex.cmd benennen wir ausdrücklich die Windows-Befehlsdatei. Dafür muss nicht pauschal die Skriptrichtlinie gelockert werden.

Eine weitere Grenze wirst du später sehen: In PowerShell stehen Systembefehle, im geöffneten Codex-Dialog stehen deine Aufgaben in natürlicher Sprache. Vor jeder Eingabe lohnt sich ein kurzer Blick darauf, welches der beiden Programme gerade auf Text wartet.

Node.js installieren und die Umgebung kontrollieren

Bereits vorhandene Installation erkennen

node --version
npm.cmd --version

Führe die beiden Zeilen einzeln aus. Wenn Node und npm jeweils eine Versionsnummer liefern, kannst du direkt zum nächsten Abschnitt wechseln. Es ist nicht nötig, eine zweite Kopie zu installieren, nur weil ein Screenshot eine andere Nummer zeigt.

Die Oberfläche im Bild ist chinesisch. Relevant ist die fehlgeschlagene Programmsuche, noch nicht die spätere API-Verbindung.

Wird node nicht erkannt, ist entweder Node.js noch nicht vorhanden oder das Fenster kennt den neuen Suchpfad noch nicht. An dieser Stelle helfen Änderungen an Modellnamen und API-Schlüsseln nicht, denn die Anfrage erreicht noch keinen Anbieter.

Den passenden Windows-Download auswählen

Öffne die Node.js-Downloadseite. Wähle LTS, Windows und die passende Architektur. Ob dein Rechner x64 oder ARM64 verwendet, lässt sich in den Windows-Systeminformationen beziehungsweise unter „Info“ nachsehen.

Gesucht ist ein Installationspaket mit der Endung .msi. Befehle für Docker beschreiben eine andere Betriebsart und gehören nicht zu diesem Windows-Ablauf. Du musst weder einen Container starten noch dafür erst eine zusätzliche Entwicklungsumgebung aufbauen.

Lass im Installationsassistenten npm und die Einbindung in PATH aktiviert. Die zusätzlichen Werkzeuge zum Kompilieren nativer Module sind für diese Einführung nicht erforderlich. Lies die angebotenen Komponenten, statt vorsorglich jede optionale Entwicklungsumgebung mitzuinstallieren.

Ein neues Fenster ist Teil der Prüfung

Schließe nach der Installation das bisherige Terminal und öffne es neu. Bei einem Terminal innerhalb eines Editors kann ein Neustart des Editors nötig sein, weil dessen Prozesse die alte Umgebung weitergeben.

Die abgebildete Nummer ist ein Beispiel. npm muss zusätzlich geprüft werden.

Wiederhole die Versionsabfragen. Bleibt die Programmsuche erfolglos, kontrolliere den tatsächlichen Installationsordner und PATH. Ändere dabei nicht gleichzeitig Netzwerk, Schlüssel und Provider, sonst lässt sich eine Verbesserung später keinem einzelnen Schritt zuordnen.

Codex installieren und den Starter finden

npm.cmd install -g @openai/codex@latest

codex.cmd --version
codex.cmd --help

Warte, bis die npm-Installation beendet ist, bevor du die beiden Prüfkommandos ausführst. -g richtet das Paket als globales npm-Werkzeug ein. Es bedeutet nicht, dass der gesamte spätere Arbeitsablauf mit Administratorrechten laufen soll. latest bezeichnet ein Veröffentlichungslabel und keine dauerhaft feste Versionsnummer.

Eine Ausgabe mit codex-cli bestätigt, dass sich der Starter ausführen lässt. Die Hilfe zeigt außerdem, welche Unterbefehle die installierte Ausgabe kennt. Keine dieser beiden Abfragen testet bereits eine Modellantwort.

Hinweise mit notice oder WARN sollten gelesen werden, sind aber nicht automatisch ein Abbruch. Für eine Diagnose sind der eigentliche Fehlertext und die anschließende Funktionsprüfung aussagekräftiger als die bloße Farbe oder Sprache der Ausgabe.

Wenn Windows den Starter nach der Installation weiterhin nicht findet, öffne ein frisches Fenster und prüfe:

Get-Command codex.cmd -ErrorAction SilentlyContinue
npm.cmd config get prefix

Der npm-Präfix zeigt den globalen Werkzeugordner. Öffne ihn im Explorer und suche codex.cmd. Existiert die Datei, aber die erste Abfrage findet nichts, kontrolliere den Benutzer-Path. Fehlt auch die Datei, lies die Installationsergebnisse erneut.

Ergänzt wird der Ordner, nicht der vollständige Dateiname. Bestehende Path-Einträge bleiben erhalten. Nach einer Änderung ist wiederum ein neuer Terminalprozess nötig. Bei mehreren Installationsmethoden kann später Get-Command codex* -All helfen, versehentlich verwendete ältere Starter zu erkennen.

Danach sollte Windows die CLI starten können. Noch wurde kein Zähler gebaut und keine bestimmte API-Berechtigung nachgewiesen. Halte diese lokale Prüfung im Protokoll getrennt von den nächsten Schritten.

3. Einen eindeutigen Arbeitsbereich für das Experiment schaffen

$projectDir = Join-Path $env:USERPROFILE 'CodexProjects\crazyrouter-demo'
New-Item -ItemType Directory -Path $projectDir -Force | Out-Null
Set-Location -LiteralPath $projectDir
Get-Location

Prüfe den ausgegebenen Pfad. Für einen Test ist der Ort ein Teil der Ausgangsbedingungen: Eine Datei in einem anderen Ordner zählt nicht automatisch als Ergebnis dieser Aufgabe. Der Verzeichnisname richtet übrigens keinen Provider ein; er dient nur deiner Organisation.

Existiert die Übungsmappe bereits, sieh zuerst nach ihren Dateien. -Force in diesem Block löscht ihren Inhalt nicht. Wenn dort eine ältere index.html liegt, entscheide bewusst, ob sie ersetzt werden darf. Sonst könntest du nach einer gescheiterten Neuerstellung versehentlich eine alte funktionierende Seite prüfen.

Lass das PowerShell-Fenster offen. $projectDir und die folgenden Testvariablen gelten für diese Sitzung. Ein neuer Tab erhält nicht automatisch die temporären Werte aus einem anderen Tab. Bei einem Neustart führst du die benötigten Vorbereitungsblöcke erneut aus.

Du musst Codex nicht in diesen Ordner installieren. Die globale npm-Installation stellt das Werkzeug bereit; der aktuelle Ordner bestimmt das Projekt. Diese Unterscheidung bleibt auch später bei mehreren Projekten nützlich.

4. Die Testdaten aus dem eigenen Konto beziehen

Der API-Key und der Modellbezeichner sind Eingaben, keine Konstanten aus einem Screenshot. Erzeuge einen eigenen Token im Crazyrouter-Konto und kontrolliere dessen Rechte. Die Dokumentation zum Einstieg beschreibt den Zugang zur Tokenverwaltung.

Eine ChatGPT-Anmeldung ist kein Ersatz für diesen Token. Ebenso gehört ein offizieller OpenAI-Key zu einem anderen Kontozugang. Für unseren Provider müssen Aussteller, Zieladresse und Authentifizierungsverfahren zusammenpassen.

$crazySecret = Read-Host 'Crazyrouter API Key' -AsSecureString
$env:CRAZYROUTER_API_KEY = [System.Net.NetworkCredential]::new('', $crazySecret).Password
$crazySecret.Dispose()
Remove-Variable crazySecret
[bool]$env:CRAZYROUTER_API_KEY

Die verdeckte Eingabe verhindert, dass der rohe Wert als Bestandteil eines eingegebenen Shellbefehls erscheint. Die abschließende boolesche Abfrage meldet nur, ob der Prozess einen Wert enthält. Sie kann auch bei einer falschen Zeichenfolge True liefern.

Der Schlüssel wird hier nicht dauerhaft in den Benutzereinstellungen gespeichert. Das ist für diesen Versuch beabsichtigt: Wir wissen genau, aus welcher vorbereiteten Sitzung Codex gestartet werden soll. Umgebungsvariablen sind deshalb trotzdem kein universeller Geheimnisspeicher; veröffentliche ihren Inhalt nicht.

$crazyBase = 'https://api.crazyrouter.com/v1'
$crazyHeaders = @{ Authorization = "Bearer $env:CRAZYROUTER_API_KEY" }
$crazyModels = Invoke-RestMethod -Method Get -Uri "$crazyBase/models" -Headers $crazyHeaders
$crazyModels.data | Select-Object -ExpandProperty id

$crazyModel = Read-Host 'Model ID'

Übernimm bei Model ID die genaue Kennung eines für Codex und Responses geeigneten Modells, das dein Konto nutzen darf. Ein Eintrag im Modellkatalog belegt zunächst nur die Sichtbarkeit. Die Probe im nächsten Teil muss zeigen, ob eine konkrete Generierung funktioniert.

Besonders bei gemischten Katalogen lohnt sich dieser Zwischenschritt: Ein Bild- oder Audiomodell ist nicht allein wegen seines Vorkommens in der Liste für einen Coding-Agenten geeignet. Ein vertrauter Produktname wiederum muss nicht der exakte API-Identifier sein.

Wenn du nach der Abfrage den Key austauschst, führe auch die Zuweisung des Headers erneut aus. $crazyHeaders enthält den Wert vom Zeitpunkt seiner Erstellung. Es ist keine dauerhafte Verknüpfung, die bei jeder Änderung der Umgebungsvariable automatisch neu berechnet wird.

5. Die Verbindung als überprüfbare Konfiguration speichern

$codexConfigDir = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE '.codex' }
New-Item -ItemType Directory -Path $codexConfigDir -Force | Out-Null
$codexConfigFile = Join-Path $codexConfigDir 'config.toml'
if (Test-Path -LiteralPath $codexConfigFile) {
    $backupFile = $codexConfigFile + '.' + (Get-Date -Format 'yyyyMMdd-HHmmss') + '.bak'
    Copy-Item -LiteralPath $codexConfigFile -Destination $backupFile
}
notepad.exe $codexConfigFile

Der Block sucht den Benutzerkonfigurationsort über CODEX_HOME beziehungsweise den üblichen Home-Pfad. Vorhandene Inhalte bekommen eine Sicherung mit Zeitstempel. Bearbeite die betreffenden Einträge und erhalte andere Einstellungen; ein vollständiger Austausch deiner Konfiguration ist nicht nötig.

model = "MODEL_ID_FROM_YOUR_ACCOUNT"
model_provider = "crazyrouter"

[model_providers.crazyrouter]
name = "Crazyrouter"
base_url = "https://api.crazyrouter.com/v1"
env_key = "CRAZYROUTER_API_KEY"
wire_api = "responses"
requires_openai_auth = false

Ersetze MODEL_ID_FROM_YOUR_ACCOUNT durch den eben ausgewählten Identifier. Die Eingabe in $crazyModel schreibt ihn nicht von selbst in diese Datei. Für den Vergleich von direkter Anfrage und CLI müssen beide Stellen übereinstimmen.

Ich würde diese Datei bei einer technischen Durchsicht mit vier Fragen lesen: Welche Tabelle wird ausgewählt? Welche Adresse steht darin? Woher kommt das Geheimnis? Welches Protokoll erwartet der Client? Die Antwort darf nicht aus dem hübschen Anzeigenamen abgeleitet werden, sondern aus den tatsächlichen Feldern.

Kontrollpunkt	Erwartete Beziehung
`model_provider`	Entspricht dem Namen hinter `model_providers.`
`base_url`	API-Basis mit einmaligem `/v1`, ohne Artikelparameter
`env_key`	Exakter Variablenname aus dem PowerShell-Block
`wire_api`	`responses` für den hier beschriebenen Weg
`requires_openai_auth`	`false` für den dienstspezifischen Variablenzugang

Bei requires_openai_auth = true verwendet Codex OpenAI-Authentifizierung und ignoriert env_key. Das wäre eine andere Strategie. Übernimm diesen Wert daher nicht zusätzlich aus einem Beispiel für eine offizielle Anmeldung.

Die ersten beiden Schlüssel gehören auf die oberste TOML-Ebene, vor Tabellenüberschriften. Doppelte Schlüssel oder wiederholte Provider-Tabellen sind kein Verfahren zum Überschreiben. Aktualisiere vorhandene Einträge und kontrolliere, dass der Editor wirklich config.toml gespeichert hat, nicht config.toml.txt.

Provider- und Authentifizierungseinstellungen gehören hier in die Benutzerkonfiguration. Eine gleichnamige Datei im Übungsprojekt ist kein beliebiger Ersatz. Nach dem Speichern wird eine alte Sitzung beendet und neu gestartet, damit der Test nicht noch den alten Zustand verwendet.

6. Einen kleinen API-Smoke-Test ausführen

Dieser Aufruf verwendet echte Kontoressourcen und kann nach den Bedingungen des Dienstes Nutzung verursachen. Er setzt die zuvor erstellten Variablen voraus:

$crazyPayload = @{
    model = $crazyModel
    input = 'Reply with OK.'
    stream = $false
} | ConvertTo-Json -Depth 6

$crazyResponse = Invoke-RestMethod -Method Post -Uri "$crazyBase/responses" -Headers $crazyHeaders -ContentType 'application/json' -Body $crazyPayload
$crazyResponse | Select-Object id, status, error
$crazyResponse.output | ConvertTo-Json -Depth 8

Der Test ist bewusst unspektakulär. Die Antwort muss keine komplizierte Lösung enthalten; wir wollen die Verbindung mit einer kleinen Eingabe beobachten. Notiere die tatsächliche Antwort-ID, den Status, einen möglichen Fehler und die vorhandene Textausgabe.

Ein fehlerfreier HTTP-Transport allein erfüllt die Abnahmebedingung nicht. Wenn der zurückgegebene Inhalt eine fehlgeschlagene Verarbeitung beschreibt, bleibt der Test fehlgeschlagen. Bei einer abweichenden Antwortstruktur wird zuerst die aktuelle Dokumentation mit dem realen Körper verglichen.

Diese Probe verwendet stream = false. Sie ist deshalb kein vollständiger Test für das Streaming und die Werkzeuge der CLI. Aus Chat-Completions-Kompatibilität lässt sich ebenfalls nicht automatisch die gesamte benötigte Responses-Funktionalität ableiten.

Wenn die Anfrage scheitert, halte die restlichen Bedingungen konstant. Ein anderer Key, eine andere Basisadresse und ein anderes Modell im selben Versuch machen den Vergleich wertlos. Beginne beim Fehlertext: 401 deutet auf die Authentifizierungsebene, 403 verlangt eine Prüfung des Ablehnungsgrunds, 404 auf Pfad oder Auswahl, 429 auf die erläuterten Limits. Keiner dieser Codes ersetzt das Lesen der Antwort.

7. Den Agenten starten und seine Schreibrechte einordnen

Set-Location -LiteralPath $projectDir
codex.cmd

Frage zunächst: „Was ist eine HTML-Datei? Antworte in einem Satz und verwende keine Dateien oder Befehle.“ Kontrolliere außerdem, ob die Sitzung den gewünschten Provider und das Modell anzeigt. Die direkte Anfrage verwendet Skriptvariablen; die CLI verwendet ihre geladene Konfiguration. Das sind zwei verschiedene Zugriffswege, die übereinstimmen müssen.

Die Oberfläche ist chinesisch. Lies die entsprechende Beschreibung deiner Version; Modellanzeige und Schaltflächenpositionen sind keine Empfehlung für eine bestimmte Auswahl.

Bei einer Vertrauensabfrage gehört der angezeigte Pfad zur Prüfung. Wenn dort ein anderer Ordner steht, beende die Sitzung und korrigiere die Startposition. Ein Vertrauensklick auf das gesamte Benutzerprofil wäre keine genaue Umsetzung unseres begrenzten Auftrags.

Für den Zähler brauchen wir genau eine lokale Datei. Eine vorgeschlagene Installation zusätzlicher Pakete sollte deshalb erklärt werden, bevor sie ausgeführt wird. Du kannst den Agenten nach betroffenen Dateien und dem Zweck eines Befehls fragen. Rechte pauschal zu erweitern ist keine Voraussetzung dieses Beispiels.

Die Windows-Sandbox kann eigene Einrichtungsschritte benötigen. Beachte deren Beschreibung und die Vorgaben verwalteter Geräte. Wenn die Modellantwort ankommt, aber das Speichern verweigert wird, untersuche diese lokale Grenze. Ein neu ausgestellter API-Key ändert keine Dateiberechtigung.

8. Den Zähler mit konkreten Abnahmekriterien bauen lassen

Erstelle im aktuellen Übungsordner ausschließlich index.html.
Die deutsche Seite trägt die Überschrift „Mein erster Zähler“.
Beim Laden steht der sichtbare Wert auf 0.
Ein Button „Erhöhen“ addiert pro Klick genau 1.
Ein Button „Zurücksetzen“ setzt jeden erreichten Wert auf 0.
Nutze echte HTML-Buttons, die auch mit der Tastatur bedient werden können.
Kein Speichern über Seitenaufrufe hinweg, keine externen Ressourcen oder Pakete.
CSS und JavaScript stehen in derselben Datei. Keine zusätzlichen Netzwerkaufrufe.
Melde den tatsächlich gespeicherten Pfad und nenne die manuell prüfbaren Funktionen.
Wenn Schreiben nicht möglich ist, beschreibe den Grund statt eine fertige Datei zu behaupten.

Hier steckt bereits eine einfache Prüfliste im Auftrag. „Pro Klick genau eins“ verhindert eine unklare Erwartung an den Zähler. „Kein Speichern“ erklärt, warum nach einem Neuladen wieder null erscheinen soll. Ohne diesen Satz könnte ein persistenter Zähler eine plausible, aber andere Umsetzung sein.

Du musst dafür noch keine Testbibliothek installieren. Bei einer kleinen Ein-Datei-Aufgabe lässt sich das Verhalten unmittelbar prüfen. Wir testen auch nicht die Geschwindigkeit verschiedener Modelle, sondern ob der definierte Auftrag erfüllt wird.

Lies die Schreibanfrage und bestätige nur den passenden Zielpfad. War dort schon eine Datei vorhanden, achte auf die geplante Änderung. Nach Abschluss verlässt du den Dialog mit /quit oder der angebotenen Beenden-Funktion und kehrst zum Shellprompt zurück.

Test-Path .\index.html

Start-Process .\index.html

Die zweite Zeile wird erst nach einer Existenzprüfung mit True ausgeführt. Ein Quelltextblock im Gespräch zählt nicht als gespeichertes Artefakt. Eine alte Datei aus einem früheren Durchlauf darf ebenfalls nicht unbemerkt das Ergebnis ersetzen.

9. Nicht nur den ersten Klick ausprobieren

Eine kleine Funktion kann beim ersten Versuch richtig wirken und bei einer Wiederholung falsch reagieren. Nutze deshalb eine kurze, feste Reihenfolge:

Aktion	Erwartete Anzeige	Warum diese Aktion dazugehört
Seite öffnen	0	Anfangszustand
Zweimal erhöhen	2	Mehrere Ereignisse, nicht nur ein erster Klick
Zurücksetzen	0	Rückweg aus einem veränderten Zustand
Nochmals zurücksetzen	0	Wiederholtes Zurücksetzen
Einmal erhöhen	1	Weiterarbeiten nach dem Reset
Seite neu laden	0	Vereinbarter Verzicht auf Persistenz

Ergänze eine Tastaturprüfung: Tab sollte die echten Buttons erreichen, und die übliche Aktivierung sollte dieselbe Aktion auslösen. Behaupte damit keine vollständige Barrierefreiheitsprüfung; es ist eine konkrete Anforderung dieses kleinen Beispiels.

Bei einem Fehler beschreibst du die Folge der Aktionen und den abweichenden Wert. „Nach zweimaligem Erhöhen steht 4 statt 2“ ist für eine Korrektur brauchbarer als „Die Seite ist falsch“. Bitte um Änderung nur an der vorhandenen Datei und wiederhole danach dieselbe Reihenfolge.

Kontrolliere bei jeder Wiederholung die Adresse im Browser. Wenn zwei Dateien gleich heißen, könnte eine geöffnete alte Kopie den Eindruck erzeugen, die Korrektur sei wirkungslos. Auch die Seite selbst muss nach dem Speichern neu geladen werden.

Die Abnahme endet bei unserem vereinbarten Funktionsumfang. Ein funktionierender Zähler beweist weder sichere Verarbeitung beliebiger Projekte noch Zuverlässigkeit für jede spätere Aufgabe. Das ist kein Mangel der Probe, sondern ihr klar definierter Geltungsbereich.

10. Fragen, die beim Wiederholen des Versuchs auftreten

Warum ist der Schlüssel im neuen Terminal nicht vorhanden?

[bool]$env:CRAZYROUTER_API_KEY

Die ursprüngliche Eingabe galt für einen Prozess. Bereite den Wert im Fenster vor, aus dem du Codex startest. Die TOML-Datei nennt die Variable, stellt aber keinen geheimen Inhalt her.

Muss ich bei einem npm-Timeout den API-Anbieter wechseln?

npm.cmd config get registry

Nein, der Paketdownload ist ein anderer Netzwerkweg. Prüfe Registry und Fehlermeldung. Behalte beabsichtigte Firmenkonfigurationen bei und löse Zertifikatsprobleme nicht durch pauschales Abschalten der Prüfung.

Warum wird ein PowerShell-Skript blockiert?

Kontrolliere, ob du den beschriebenen .cmd-Starter aufrufst. Eine Skriptrichtlinie ist eine gesonderte Frage, gerade auf verwalteten Geräten. Für diesen Ablauf muss nicht vorsorglich jede Skriptausführung freigegeben werden.

Der Modellkatalog funktioniert; warum scheitert die Generierung?

Die Operationen prüfen unterschiedliche Fähigkeiten. Lies den konkreten Generierungsfehler, prüfe Modellrechte und Responses-Verhalten. Der Katalog ist kein Ersatz für einen erfolgreichen Aufruf.

Warum verwendet Codex anscheinend die alte Auswahl?

Vergleiche Benutzerkonfigurationspfad, CODEX_HOME, oberste TOML-Schlüssel und Sitzung. Danach neu starten. Die Modellvariable des Tests und die Datei werden nicht automatisch synchronisiert.

Wie prüfe ich eine Aktualisierung der CLI?

npm.cmd install -g @openai/codex@latest
codex.cmd --version
Get-Command codex* -All

Vergleiche Version und gefundene Starter. Anschließend genügt für die erste Kontrolle wieder dieselbe kleine Aufgabe; installiere das Werkzeug nicht vor jedem Projektstart neu.

Funktioniert eine kopierte CMD-Zeile in PowerShell?

Nicht zwangsläufig. Hier gilt $env:USERPROFILE, nicht %USERPROFILE%; für Pfade nutzen wir Set-Location, nicht cd /d. Die richtige Shell ist Teil der reproduzierbaren Anleitung.

Welche Angaben gehören zu einem Fehlerbericht?

Version, ausgewähltes Modell, konkrete Aktion, erwartetes und beobachtetes Ergebnis sowie bereinigte Fehlermeldung. Zugangsdaten, Gerätecodes und private Projektinhalte bleiben draußen. Eine Anfrage-ID kann dem Dienst helfen, ohne dass du den Header veröffentlichst.

11. Einen nachvollziehbaren Abschluss festhalten

Ein guter Abschlussbericht für dieses Experiment ist kurz: Welche lokale Version wurde verwendet, welche Konfiguration war ausgewählt und welche Prüfschritte wurden tatsächlich ausgeführt? Markiere offen gebliebene Punkte ausdrücklich als offen. Eine fehlende Berechtigung wird nicht durch eine schönere Zusammenfassung zum Erfolg.

Bewahre die Konfigurationssicherung auf. Bei einem Rückwechsel beendest du die Sitzung und stellst die betroffenen Felder wieder her, statt sämtliche Authentifizierungsdaten oder den kompletten Codex-Ordner zu löschen. Für ein neues Modell oder eine neue Basisadresse wiederholst du API-Probe und CLI-Aufgabe mit übereinstimmenden Werten.

Damit bleibt dieser Beitrag auch als Diskussionsgrundlage brauchbar: Nicht die allgemeine Aussage „lief bei mir“ ist interessant, sondern eine nachvollziehbare Bedingung und ihr Ergebnis. Wenn du im Kommentar einen zusätzlichen Prüfpunkt vorschlägst, beschreibe, welchen Fehler er sichtbar machen würde. Behaupte keine Messwerte, die im eigenen Versuch nicht erhoben wurden.

Die Verbindung zu Crazyrouter ist hier Bestandteil eines überprüfbaren Entwicklungsablaufs. Das wiederverwendbare Ergebnis besteht aus einer verständlichen Provider-Konfiguration und einer kleinen Aufgabe, deren Erfolg du selbst beurteilen kannst.

Versionsbezogene Optionen findest du in der Codex-Dokumentation.

Redaktioneller Hinweis: Dieser Text wurde mit KI-Unterstützung ausgearbeitet und lokalisiert. Konfigurationsbeispiele und Sollwerte ersetzen keine Prüfung mit dem eigenen Dienstkonto.

Claude Code mit CC Switch umstellen und Verbindungsfehler eingrenzen

boluo — Tue, 29 Sep 2026 08:04:25 +0000

Ein gespeicherter Anbieter ist nicht unbedingt der Anbieter, den der nächste Claude-Code-Prozess tatsächlich verwendet. Dieser Unterschied ist entscheidend, wenn nach einem Wechsel des API-Endpunkts ein Fehler mit dem Statuscode 401, 403 oder 404 auftritt.

Diese Anleitung verwendet CC Switch unter Windows und einen Anthropic-kompatiblen Endpunkt von Crazyrouter. Das Vorgehen lässt sich auf ähnliche Konfigurationen übertragen: zuerst den Client prüfen, dann Zugangsdaten und Basis-URL eintragen, den Anbieter aktivieren und schließlich eine kurze Anfrage mit dem Protokoll des Dienstes abgleichen.

Zuerst den Client prüfen

Führe vor der Konfiguration eines Anbieters folgenden Befehl in PowerShell aus:

claude --version

Falls PowerShell claude nicht findet, prüfe zuerst die Installation von Claude Code und die PATH-Umgebungsvariable. CC Switch verwaltet Verbindungseinstellungen, installiert aber nicht die CLI. Du kannst CC Switch über die Release-Seite des Projekts herunterladen.

Die für diesen Artikel geprüfte Umgebung bestand aus Windows 10 22H2 und Claude Code 2.1.283. Die Bezeichnungen in der Oberfläche können bei anderen Versionen von CC Switch abweichen.

Einen Claude-Anbieter hinzufügen

Öffne den Reiter Claude und klicke in der Anbieterliste auf die Schaltfläche zum Hinzufügen. Der bisherige Anbieter kann neben dem neuen bestehen bleiben.

Suche in den Vorlagen nach crazy und wähle CrazyRouter aus. Eine Vorlage spart Eingaben, ersetzt aber nicht die Prüfung der Werte. Falls sie in deiner Version fehlt, lege einen benutzerdefinierten Anbieter an.

Trage einen API-Schlüssel aus deinem eigenen Konto in das Feld API Key ein. Achte auf versehentlich kopierte Leerzeichen am Anfang oder Ende. Der Schlüssel darf niemals in einem veröffentlichten Screenshot erscheinen.

Trage für den hier verwendeten regionalen Endpunkt ausschließlich diese Basis-URL als Anfrageadresse ein:

https://cn.crazyrouter.com

Alternativ steht https://api.crazyrouter.com zur Verfügung. Wähle den für dein Netzwerk passenden Endpunkt. Hänge an die Basis-URL für Claude weder /v1 noch /v1/messages an: Der Client setzt den Anthropic-Anfragepfad selbst zusammen.

Rufe im Formular die aktuelle Modellliste ab und wähle ein Modell, auf das dein Schlüssel zugreifen darf. Die entsprechende Schaltfläche heißt je nach Oberflächensprache beispielsweise Get model list. Ein Modellname aus einem fremden Screenshot belegt keine Zugriffsberechtigung für dein Konto.

Speichern und tatsächliche Verwendung unterscheiden

Speichere den Anbieter und wähle anschließend seine Karte in der Liste aus. Beende bestehende Claude-Code-Sitzungen und öffne ein neues PowerShell-Fenster. Sende eine kurze Anfrage ohne Projektkontext:

claude -p "Antworte nur mit OK." --max-turns 1 --tools ""

Der geprüfte Rechner gab mit gültigen Zugangsdaten und der oben genannten regionalen Basis-URL OK zurück. Damit war ein CLI-Aufruf erfolgreich. Das beweist jedoch nicht allein, dass die CC-Switch-Karte die Verbindung bestimmt hat: Eine geerbte Umgebungsvariable könnte die erwartete Konfiguration weiterhin überschreiben. Vergleiche deshalb den Zeitpunkt der Anfrage mit dem Anfrageprotokoll im Konto des Dienstes.

Problem	Zuerst prüfen
`claude` wird nicht gefunden	Installation und PATH
401	Gültigkeit des Schlüssels und mitkopierte Leerzeichen
403 oder `model not allowed`	Berechtigung für das ausgewählte Modell
404	Basis-URL, zusätzlich eingetragener Pfad und API-Format
Erfolgreiche Antwort ohne passenden Protokolleintrag	Ausgewählte Karte und geerbte Umgebungsvariablen

Diese Tabelle beschreibt eine sinnvolle Reihenfolge zur Fehlersuche. Ein Statuscode lässt sich nicht eindeutig einer einzigen Ursache zuordnen. Ändere jeweils nur ein Feld und wiederhole dieselbe kurze Anfrage.

Hinweis und Offenlegung: Crazyrouter dient in diesem Artikel als Produktbeispiel für die Konfiguration. Der Artikel ist kein unabhängiger Preis- oder Leistungsvergleich. Verfügbare Modelle und Gebühren können sich ändern; maßgeblich sind die aktuellen Angaben im Dashboard des Dienstes. Veröffentliche deinen API-Schlüssel nicht.

Wie ich den 403-Fehler bei der Claude-Code-Installation unter Windows behoben habe (und es mit Crazyrouter verbunden habe)

boluo — Mon, 28 Sep 2026 09:23:27 +0000

Wie ich den 403-Fehler bei der Claude-Code-Installation unter Windows behoben habe (und es mit Crazyrouter verbunden habe)

Der frustrierendste Fehler beim Einrichten von Claude Code unter Windows war keine fehlende Abhängigkeit — es war ein 403, der erst auftauchte, als scheinbar alles lief.

claude --version gab eine saubere Versionsnummer aus. Die Binärdatei war installiert. Dann startete ich das Programm und bekam Failed to connect to api.anthropic.com: Status 403. Ich habe npm dreimal neu installiert und Proxy-Einstellungen durchprobiert, bevor ich merkte, dass der eigentliche Fehler eine falsch benannte Umgebungsvariable war. Hier ist die vollständige Analyse und mein exaktes Prüfprotokoll. Alles lief auf Windows 10 mit PowerShell; alle Befehle lassen sich direkt kopieren und ausführen.

Der 403-Screenshot, mit dem alles begann

Das Bild hält die wichtigste Lektion fest: Eine erfolgreiche Installation und ein erfolgreicher Aufruf sind zwei verschiedene Prüfpunkte. Die Versionsnummer beweist nur den ersten.

Teil 1: Claude Code installieren

PowerShell öffnen (achte auf die Eingabeaufforderung PS C:\Users\deinname>). Installationsbefehle gehören nicht in den Claude-Code-Chat, sondern ins Terminal.

Native Installation (bevorzugt, kein Node.js nötig):

irm https://claude.ai/install.ps1 | iex

Danach das Terminal neu öffnen und claude --version ausführen. Eine Versionsnummer bedeutet, dass der lokale Befehl funktioniert. Wenn der Skript-Download fehlschlägt oder die Ausgabe voller HTML- und <script>-Tags ist: aufhören — dann hast du nicht das echte Skript bekommen.

Wenn PowerShell sich über var oder && beschwert, parst es gerade eine Webseite und nicht deinen Befehl.

npm als Ausweichlösung (benötigt Node.js 22+):

node --version
npm.cmd --version
npm.cmd install -g @anthropic-ai/claude-code
claude.cmd --version

Ich nutze npm.cmd, damit PowerShell nicht npm.ps1 nimmt und an der Execution Policy hängen bleibt. Eine häufige Falle:

Der Fehler zeigte @anthropic-ai/claude-codenpm — ein verirrtes npm, das am Paketnamen klebte, weil zwei Befehle in einer Zeile verschmolzen waren. Das korrekte Paket heißt immer @anthropic-ai/claude-code. Zeile leeren und einmal sauber ausführen.

Git ist zum Starten nicht nötig; installiere Git für Windows nur, wenn du Repositories oder Git Bash brauchst.

Teil 2: Die Gateway-API anbinden

Ohne einen nutzbaren Modelldienst kannst du keine einzige Frage stellen. Ich habe den Ostasien-Endpunkt verwendet:

https://cn.crazyrouter.com

Zweck	Adresse	Wo
Konto / Konsole	`crazyrouter.com`	Browser
Claude Code Base URL	`https://cn.crazyrouter.com`	`ANTHROPIC_BASE_URL`
Modelle auflisten	`https://cn.crazyrouter.com/v1/models`	Prüfung
Messages-Endpunkt	`https://cn.crazyrouter.com/v1/messages`	Client

Wichtig: die Wurzeladresse eintragen, nicht /v1/messages. Das ist genau das Gegenteil von OpenAI-kompatiblen Clients. Wer den OpenAI-Stil übernimmt, bekommt einen 404 oder landet bei /v1/v1/messages. UTM-Parameter haben in der API-Konfiguration nichts zu suchen.

Lege in der Konsole einen eigenen API-Key an (nenn ihn claude-code-windows, prüfe Ablaufdatum und Kontingent) und öffne dann die Benutzerkonfiguration:

%USERPROFILE%\.claude\settings.json

Verzeichnis anlegen und eine vorhandene Datei sichern:

New-Item -ItemType Directory -Path "$env:USERPROFILE\.claude" -Force | Out-Null
$settingsPath = Join-Path $env:USERPROFILE '.claude\settings.json'
if (Test-Path -LiteralPath $settingsPath) {
    Copy-Item -LiteralPath $settingsPath -Destination "$settingsPath.backup-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
}
notepad.exe "$env:USERPROFILE\.claude\settings.json"

Das JSON im Editor schreiben (niemals in PowerShell):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cn.crazyrouter.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_CRAZYROUTER_API_KEY"
  }
}

Ersetze den Platzhalter durch deinen Key. Verwende englische doppelte Anführungszeichen, kein Komma am Ende, und füge dich in ein bereits vorhandenes env ein, statt ein zweites anzulegen.

Die eine Änderung, die meinen 403 beendet hat

Für einen Anthropic-kompatiblen Endpunkt von Drittanbietern nutzt du ANTHROPIC_AUTH_TOKEN, nicht ANTHROPIC_API_KEY. Die beiden senden unterschiedliche Header:

Variable	Gesendeter Header	Gedacht für
`ANTHROPIC_API_KEY`	`x-api-key: <key>`	offizielle Anthropic-API
`ANTHROPIC_AUTH_TOKEN`	`Authorization: Bearer <token>`	eigene / kompatible Gateways

Setzt du ANTHROPIC_API_KEY, geht der Client vom offiziellen Kanal aus — ANTHROPIC_BASE_URL kann das nicht überschreiben, die Anfragen laufen weiter gegen api.anthropic.com, und du bekommst den 403. Setze nicht „zur Sicherheit“ beide; das erzwingt nur bei jedem Start eine Rückfrage.

Prüfe, ob die Konfiguration überhaupt parst (das validiert den Key nicht):

$settingsPath = Join-Path $env:USERPROFILE '.claude\settings.json'
$ccSettings = Get-Content -Raw -LiteralPath $settingsPath | ConvertFrom-Json
[pscustomobject]@{
    BaseURL = $ccSettings.env.ANTHROPIC_BASE_URL
    HasAuthToken = -not [string]::IsNullOrWhiteSpace([string]$ccSettings.env.ANTHROPIC_AUTH_TOKEN)
}

Modelle mit dem eigenen Key auflisten:

$crBase = ([string]$ccSettings.env.ANTHROPIC_BASE_URL).TrimEnd('/')
$crHeaders = @{ Authorization = "Bearer $($ccSettings.env.ANTHROPIC_AUTH_TOKEN)" }
(Invoke-RestMethod -Uri "$crBase/v1/models" -Headers $crHeaders -Method Get -TimeoutSec 30).data | Select-Object id

Ein sichtbares Modell ist kein Beweis, dass es über das Messages-Protokoll auch generieren kann — deshalb stellen wir trotzdem eine echte Frage. Kopiere die exakt zurückgegebene ID und ergänze sie:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cn.crazyrouter.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_CRAZYROUTER_API_KEY"
  },
  "model": "YOUR_MODEL_ID"
}

Speichern und Claude Code neu starten (ebenso das Terminal, wenn du Umgebungsvariablen geändert hast).

Teil 3: Die erste Frage — was „verbunden“ wirklich heißt

Nutze ein Wegwerf-Verzeichnis, kein echtes Projekt:

$demoDir = Join-Path $env:USERPROFILE 'claude-code-first-run'
New-Item -ItemType Directory -Path $demoDir -Force | Out-Null
Set-Location -LiteralPath $demoDir
claude

Im Chatfenster eingeben:

Reply with exactly OK. Do not read files. Do not run commands.

Erwartet wird ein vollständiges OK. Öffne dann das Nutzungsprotokoll der Konsole und verifiziere, dass Zeit, Modell, Status und Verbrauch des Aufrufs übereinstimmen. Ein funktionierender Befehl plus lesbare Konfiguration plus vollständige Antwort plus passender Eintrag im Backend — das ist eine verifizierte Integration.

Teil 4: Den 403 lesen

Mein Fehler war Failed to connect to api.anthropic.com: Status 403. Drei Ebenen:

403 heißt: Die Anfrage wurde gesendet und beantwortet — der Server hat sie abgelehnt. Ein Netzwerkausfall zeigt einen Timeout, keinen Statuscode.
Der Host ist api.anthropic.com — das ist das wertvolle Detail. Du hast das Gateway konfiguriert, trotzdem geht die Anfrage an die offizielle Domain, der Client hat deine Konfiguration also nie verwendet.
Zusammen mit „Versionsnummer wurde sauber ausgegeben“ heißt das: Das Problem liegt beim Routing und bei den Zugangsdaten, nicht bei der Installation.

Also: erst klären, wohin die Anfrage ging, dann diskutieren, warum sie abgelehnt wurde. Zeigt die Anfrage noch woanders hin, prüfe in dieser Reihenfolge: Konfiguration im richtigen Windows-Benutzerverzeichnis, settings.json parst mit korrekter Base URL, CLAUDE_CONFIG_DIR unverändert, Neustart erfolgt, keine projektlokale .claude/settings.local.json überschreibt etwas, und kein Startargument, keine Umgebungsvariable und kein Login-Status hat den Auth-Pfad verändert. Kommt der 403 direkt vom Gateway, lies den Response-Body, prüfe Key-Gültigkeit, Kontingent und Logs — und notiere dir die Request-ID.

Teil 5: Mein tatsächliches Prüfprotokoll

Erfasst am 2026-09-28:

Prüfung	Ergebnis
OS / Terminal	Windows 10 / Windows PowerShell
Node.js / npm	`v22.22.2` / `10.9.7`
Claude Code	`2.1.281`
Base URL	`https://cn.crazyrouter.com`
Konfiguration	parst; `ANTHROPIC_AUTH_TOKEN` gesetzt; kein `ANTHROPIC_API_KEY` beigemischt
`GET /v1/models`	HTTP 200, 161 Modell-IDs, gewähltes Modell enthalten
`POST /v1/messages`	HTTP 200, Body `OK`, `stop_reason` `end_turn`
Response-ID	`msg_011CfVJqbN2DVuqoYqgLcdNE`
Tokens	Input 18, Output 4
Round-Trip (direkt)	11569 ms
Client-Aufruf	Exit 0, `is_error=false`, `subtype=success`, `OK`
Client-Dauer	5103 ms
Session-ID	`a7a76f08-fa36-4a36-8787-3f2b24dad626`

Der Minimaltest verwendete diesen Body (die Modell-ID war zum Abfragezeitpunkt gültig und kann bei dir abweichen):

{
  "model": "claude-fable-5-1",
  "max_tokens": 32,
  "messages": [
    { "role": "user", "content": "Reply with exactly OK." }
  ]
}

Das beweist, dass eine minimale Anfrage erfolgreich war — nicht die langfristige Stabilität und auch nicht, dass jedes Modell funktioniert. Modell-IDs und Preise ändern sich; verlass dich auf dein eigenes /v1/models und deine Konsole.

Fazit

Zerlege die Einrichtung in Prüfpunkte: Version wird ausgegeben → Key liegt vor → JSON parst → kompatibles Modell → vollständige Antwort → Log stimmt überein. Scheitert einer der früheren Punkte, repariere genau diesen Schritt. Installiere npm nicht wegen eines 403 neu, gib dem Key nicht die Schuld an einem ConnectionRefused, und nenne „der Bildschirm ist aufgegangen“ nicht Erfolg.

Was war die seltsamste Falle, in die du beim Anbinden von Claude Code (oder irgendeinem KI-Coding-Tool) unter Windows getappt bist? Schreib deine Leidensgeschichte in die Kommentare — ich vergleiche gern Notizen und erspare vielleicht der nächsten Person ein paar Neuinstallationen.

Tags: claude, windows, api, tutorial

Referenzen

Haftungsausschluss: Dieser Artikel ist ein persönlicher Erfahrungsbericht und keine offizielle Dokumentation. Dienste von Drittanbietern, Modellnamen, Preise und verfügbare Modelle können sich jederzeit ändern — prüfe sie immer auf den offiziellen Seiten und in deiner eigenen Konsole. API-Endpunkte und Konfigurationspfade solltest du der offiziellen Dokumentation entnehmen, die du zum jeweiligen Zeitpunkt heranziehst. Dieser Artikel enthält keine Affiliate-, Provisions- oder Sponsoring-Inhalte.

DEV Community: boluo

🔍 4 Befehle, mit denen ich prüfe, ob mein Claude-Code-Gateway wirklich läuft

TL;DR

Das Problem: „installiert" ist nicht „läuft"

0️⃣ Was hier technisch überhaupt passiert

1️⃣ Erst rausfinden, in welcher Situation du bist

2️⃣ Skript laufen lassen

Das Skript fragt genau drei Dinge

Was passiert, wenn man mittendrin abbricht?

Unattended auf dem Server

Noch ein Wort zum Windows-setup

3️⃣ Nachsehen, was tatsächlich geschrieben wurde

Wo die Werte landen

Alternative: pro Projekt

Die drei Wege im Vergleich

4️⃣ Desktop-App: das versteckte Panel

5️⃣ Die vier Befehle 🎯

Warum die ersten drei genau dort blind sind, wo es zählt

🧰 Fehlermeldungen, die ich gesehen habe (und was sie wirklich bedeuten)

Takeaways

Und bei euch? 💬

Codex CLI unter Windows

1. Erst festlegen, woran die Aufgabe scheitern könnte

2. Den Windows-Unterbau vorbereiten

PowerShell öffnen und Befehle richtig einfügen

Node.js installieren und die Umgebung kontrollieren

Bereits vorhandene Installation erkennen

Den passenden Windows-Download auswählen

Ein neues Fenster ist Teil der Prüfung

Codex installieren und den Starter finden

3. Einen eindeutigen Arbeitsbereich für das Experiment schaffen

4. Die Testdaten aus dem eigenen Konto beziehen

5. Die Verbindung als überprüfbare Konfiguration speichern

6. Einen kleinen API-Smoke-Test ausführen

7. Den Agenten starten und seine Schreibrechte einordnen

8. Den Zähler mit konkreten Abnahmekriterien bauen lassen

9. Nicht nur den ersten Klick ausprobieren

10. Fragen, die beim Wiederholen des Versuchs auftreten

Warum ist der Schlüssel im neuen Terminal nicht vorhanden?

Muss ich bei einem npm-Timeout den API-Anbieter wechseln?

Warum wird ein PowerShell-Skript blockiert?

Der Modellkatalog funktioniert; warum scheitert die Generierung?

Warum verwendet Codex anscheinend die alte Auswahl?

Wie prüfe ich eine Aktualisierung der CLI?

Funktioniert eine kopierte CMD-Zeile in PowerShell?

Welche Angaben gehören zu einem Fehlerbericht?

11. Einen nachvollziehbaren Abschluss festhalten

Claude Code mit CC Switch umstellen und Verbindungsfehler eingrenzen

Zuerst den Client prüfen

Einen Claude-Anbieter hinzufügen

Speichern und tatsächliche Verwendung unterscheiden

Wie ich den 403-Fehler bei der Claude-Code-Installation unter Windows behoben habe (und es mit Crazyrouter verbunden habe)

Wie ich den 403-Fehler bei der Claude-Code-Installation unter Windows behoben habe (und es mit Crazyrouter verbunden habe)

Der 403-Screenshot, mit dem alles begann

Teil 1: Claude Code installieren

Teil 2: Die Gateway-API anbinden

Die eine Änderung, die meinen 403 beendet hat

Teil 3: Die erste Frage — was „verbunden“ wirklich heißt

Teil 4: Den 403 lesen

Teil 5: Mein tatsächliches Prüfprotokoll

Fazit

Referenzen

Noch ein Wort zum Windows-`setup`