GLM-5.2 in Claude Code nutzen: komplette Einrichtung

GLM-5.2 lässt sich schon heute in Claude Code verwenden – die Einrichtung dauert ungefähr zwei Minuten. Da Claude Code mit jedem Endpunkt funktioniert, der Anthropics Messages API spricht, genügt es, den Client auf z.ai zu verweisen. Dafür gibt es zwei Wege: CC Switch erledigt den Wechsel per Klick und erlaubt später den schnellen Rücksprung zu Claude. Alternativ passt du die Konfigurationsdatei selbst an. Dieser Guide zeigt beide Varianten für macOS, Windows und Linux – inklusive Rückwechsel zu Claude.

Am schnellsten geht es mit CC Switch

Wenn du ohnehin mit mehreren Anbietern arbeitest, ist CC Switch meist bequemer als eine manuelle Konfiguration. Die Open-Source-App unter MIT-Lizenz läuft auf Windows, macOS und Linux und verwaltet Provider-Einstellungen für Claude Code, Codex, Gemini CLI und weitere CLIs. JSON-Dateien musst du dann nicht mehr von Hand bearbeiten.

1. Installiere CC Switch über ccswitch.io oder das GitHub repo. Klicke im Hauptfenster oben rechts auf die orange Schaltfläche +, öffne Add Provider und wähle den Tab Claude Provider.
2. Suche bei den Presets nach zhipu. Es erscheinen zwei Einträge: Zhipu GLM für den chinesischen Festland-Endpunkt sowie Zhipu GLM en. Außerhalb des chinesischen Festlands wählst du Zhipu GLM en für den internationalen Endpunkt.

1. Scrolle nach unten und füge deinen z.ai-API-Key im Feld API Key ein. Das Preset ergänzt den Rest automatisch: das Format Anthropic Messages (Native), das Authentifizierungsfeld ANTHROPIC_AUTH_TOKEN und die Basis-URL.
2. Unter Model Mapping setzt du für jede Rolle – Sonnet, Opus, Fable und Haiku – das angeforderte Modell auf glm-5.2. So landen alle Anfragen bei GLM, unabhängig davon, welche Stufe Claude Code gerade anfordert. Aktiviere bei einer Rolle das Kästchen 1M, um Claude Code den Kontext von einer Million Tokens mitzuteilen. Anschließend speichern.

1. Klicke zurück in der Provider-Liste beim Eintrag Zhipu GLM auf Enable. Einen vorhandenen Provider wie Claude Official kannst du in der Liste lassen, um später wieder zu Claude zurückzuwechseln. Starte Claude Code anschließend neu, damit der neue Provider sicher übernommen wird. Mit /status prüfst du, ob als Modell glm-5.2 angezeigt wird.

Der Vorteil gegenüber einer statischen Konfiguration: CC Switch bringt Presets für die meisten interessanten Anbieter mit, darunter Kimi, MiniMax, MiMo, Qwen und DeepSeek. Damit wird aus jeder Einrichtung eine Sache aus Preset und API-Key statt einer neuen Konfigurationsrunde. Der Wechsel zwischen Anbietern oder zurück zu Claude braucht nur ein paar Klicks – die praktische Grundlage für den weiter unten beschriebenen Hybrid-Workflow.

GLM-5.2 direkt in settings.json einrichten

Du möchtest die Einstellungen lieber selbst verwalten oder richtest eine CI-Maschine ohne grafische Oberfläche ein? Dann bearbeite die Datei direkt.

1. API-Key besorgen: Hole ihn in der Z.AI API console. Sowohl ein Pay-as-you-go-Key als auch ein Key aus einem GLM Coding Plan-Abo funktionieren.
2. Diesen env-Block in die Claude-Code-Einstellungsdatei übernehmen: Bestehende Einträge bleiben erhalten – überschreibe nicht die gesamte Datei. Der Block ist auf allen Plattformen identisch, nur der Pfad unterscheidet sich:

- macOS / Linux: ~/.claude/settings.json - Windows: %USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.2",
    "API_TIMEOUT_MS": "3000000"
  }
}

1. Claude Code neu starten und danach /status ausführen. In der Modellzeile sollte glm-5.2 stehen – oder glm-5.2[1m] für die Variante mit einer Million Tokens Kontext. Wird weiterhin ein Claude-Modell angezeigt, wurde die Datei nicht geladen. Prüfe in diesem Fall die JSON-Syntax und den Pfad.

Wenn du die Datei nicht anfassen möchtest, gibt es zwei Shell-Alternativen:

• macOS / Linux – exportiere die Variablen für eine einzelne Bash-/Zsh-Sitzung und starte dann Claude:

export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="your_zai_api_key"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.2"
claude

Nach dem Schließen des Terminals verwendest du wieder deine normale Konfiguration.

• Windows – setze dauerhafte Benutzer-Umgebungsvariablen in PowerShell und starte anschließend das Terminal neu:

setx ANTHROPIC_BASE_URL "https://api.z.ai/api/anthropic"
setx ANTHROPIC_AUTH_TOKEN "your_zai_api_key"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "glm-5.2"

Die Variablen ANTHROPIC_DEFAULT_* ordnen die Modellrollen neu zu, auf die Claude Code Anfragen verteilt: Opus, Sonnet und Haiku. Neuere Builds ergänzen eine Fable-Rolle, die auch CC Switch anbietet. Wenn alle auf glm-5.2 zeigen, gehen sämtliche Anfragen an GLM. Sollen Hintergrundaufgaben günstiger und schneller bleiben, kannst du für Haiku stattdessen glm-4.5-air eintragen. Mit glm-5.2[1m] nutzt du das vollständige Kontextfenster von einer Million Tokens. Der hohe Wert für API_TIMEOUT_MS ist wichtiger, als er zunächst wirkt: GLM antwortet oft langsamer als Claude, und das Standard-Timeout kann lange Generierungen abbrechen.

z.ai direkt, Proxy oder Coding Plan?

Es gibt drei praktische Wege, GLM-5.2 in Claude Code einzubinden. Sie sind nicht beliebig austauschbar.

Nativer z.ai-Endpunkt (empfohlen). Gemeint ist die oben verwendete URL https://api.z.ai/api/anthropic. Sie spricht das Anthropic-Protokoll, sodass Claude Code ohne Middleware verbunden wird – die Standardempfehlung.

Übersetzungs-Proxy. Andere Hosts wie Fireworks, NVIDIA NIM oder selbst gehostete Weights stellen GLM-5.2 über eine OpenAI-kompatible API bereit, die Claude Code nicht direkt versteht. Hier ist ein Proxy nötig, der die Formate umsetzt. claude-code-router übernimmt diese Aufgabe. Das lohnt sich nur, wenn du bei einer dieser Plattformen bereits Credits oder Hardware hast.

GLM Coding Plan-Abo. Ein monatlicher Festtarif ab $18/month, laut der z.ai's subscribe page. Er nutzt denselben z.ai-Endpunkt, rechnet aber eine feste Gebühr statt pro Token ab. Wer täglich in Claude Code programmiert, fährt mit einem Abo meist günstiger und planbarer als mit nutzungsbasierter Abrechnung. Vergleiche dafür deine monatlichen Token-Kosten, um den Break-even zu bestimmen. Bei stark schwankender Nutzung ist Pay-as-you-go besser.

Zwischen GLM-5.2 und Claude wechseln

Claude Code verwendet immer nur einen aktiven Provider. Du teilst die Slots also nicht auf, sondern wechselst: Für Routineaufgaben mit viel Volumen läuft GLM-5.2, für Architekturfragen, sicherheitskritischen Code oder Reviews aktivierst du in CC Switch deinen Provider Claude Official. Auf der Claude-Seite funktioniert jeder Anthropic-kompatible Endpunkt – dein Anthropic-Konto oder etwa ein Relay wie AIReiter, eine von mehreren Möglichkeiten. Soll die Auswahl pro Anfrage automatisch erfolgen, übernimmt ein Gateway wie claude-code-router das Routing.

Fehlerbehebung

Häufige Fragen

Ist GLM-5.2 in Claude Code kostenlos?

Nicht dauerhaft unbegrenzt. z.ai hat zwar zeitlich begrenzte Gratiszeiträume für GLM-5.2 angeboten, und der Coding Plan startet bei $18/month. Selbst zu den regulären Pay-as-you-go-Preisen von $1.40 / $4.40 pro Million kostet leichte Nutzung nur wenige Cent.

Unterstützt GLM-5.2 den Kontext von 1 Million Tokens in Claude Code?

Ja. Trage in deinen Variablen ANTHROPIC_DEFAULT_* statt glm-5.2 die Modell-ID glm-5.2[1m] ein. Claude Code verwendet dann das Kontextfenster von einer Million Tokens.

Ist GLM-5.2 oder Claude besser zum Programmieren in Claude Code?

Bei routinemäßigen, aufeinanderfolgenden Änderungen ist GLM-5.2 wegen des Preisunterschieds die vernünftige Standardwahl. Claude hat meist Vorteile bei mehrstufiger Architekturarbeit, sicherheitskritischen Aufgaben und Subagent-Workflows mit hoher Parallelität. Mit dem Wechsel-Setup nutzt du jeweils die Stärken beider Modelle, statt dich für eines entscheiden zu müssen.

Kann ich GLM-5.2 auch in anderen Tools als Claude Code nutzen?

Ja. Derselbe z.ai-Endpunkt und dieselben Keys funktionieren mit weiteren agentischen CLIs. OpenCode, Cline und Kilo Code akzeptieren alle eine eigene Basis-URL, und CC Switch verwaltet für mehrere davon Presets.

Brauche ich ein kostenpflichtiges Claude-Abo, um GLM-5.2 in Claude Code zu verwenden?

Nein. Claude Code ist nur der Client. Sobald du ihn auf z.ai verweist, rechnet z.ai ab, nicht Anthropic. Ein Claude-Konto brauchst du nur, wenn Claude als Provider für den Wechsel verfügbar bleiben soll.

Muss ich Claude Code nach einem Provider-Wechsel in CC Switch neu starten?

Laut CC-Switch-Dokumentation unterstützt Claude Code das Hot-Switching von Provider-Daten ohne Neustart, während die meisten anderen CLI-Tools einen Neustart von Terminal oder App benötigen. In der Praxis ist ein Neustart von Claude Code der zuverlässige Weg, um sicherzugehen, dass der Wechsel aktiv ist.

Wie wechsle ich in CC Switch zurück zu Claude mit offiziellem Login?

Füge aus der Preset-Liste einen Provider Claude Official hinzu, aktiviere ihn und durchlaufe einmal den normalen Abmelde-/Anmeldevorgang von Claude Code per OAuth. Danach kannst du frei zwischen deinem offiziellen Claude-Login und Drittanbieter-Providern wie z.ai umschalten.

Ist CC Switch kostenlos und sicher?

Ja. CC Switch ist kostenlos und steht als Open Source unter der MIT-Lizenz bereit. Die Konfigurationen liegen lokal in einer SQLite-Datenbank mit atomaren Schreibvorgängen. Die App verändert die eigenen Konfigurationen der einzelnen Tools bewusst nur minimal, sodass deine CLIs auch nach einer Deinstallation normal weiterlaufen.

Weiterführende Artikel

• GLM-5.2 API: Zugang und Preise
• GLM-5.2 vs Opus 4.6 fürs Programmieren
• Codex vs Claude Code