So verwenden Sie GLM-5.2 in Claude Code (vollständiges Setup)

Sie können GLM-5.2 heute in Claude Code ausführen, und die Einrichtung dauert etwa zwei Minuten. Claude Code kommuniziert mit jedem Endpunkt, der Anthropic's Messages API unterstützt, und Zhipu liefert genau das für GLM aus — zeigen Sie Claude Code einfach auf z.ai, und fertig. Es gibt zwei Wege: eine One-Click-Umschalter-App (am einfachsten, und damit können Sie jederzeit wieder zu Claude zurückwechseln) oder eine manuell bearbeitete Konfigurationsdatei. Dieser Leitfaden behandelt beides, für macOS, Windows und Linux, sowie auch, wie Sie bei Bedarf wieder zu Claude zurückwechseln.

Der schnellste Weg: CC Switch

Wenn Sie bereits mehr als einen Anbieter verwenden, überspringen Sie die manuelle Konfiguration und nutzen Sie CC Switch (Open Source, MIT-lizenziert, Windows/macOS/Linux). Es ist eine Desktop-App, die Anbieter-Konfigurationen für Claude Code, Codex, Gemini CLI und einige andere CLIs verwaltet, sodass Sie JSON nicht von Hand bearbeiten müssen.

1. Installieren Sie CC Switch von ccswitch.io oder seinem GitHub-Repo. Klicken Sie auf die orangefarbene +-Schaltfläche oben rechts im Hauptfenster, um Add Provider zu öffnen, und wählen Sie die Registerkarte Claude Provider. 2. Geben Sie zhipu in die Preset-Suche ein. Es erscheinen zwei Presets — Zhipu GLM (Mainland-Endpunkt) und Zhipu GLM en. Außerhalb von Mainland China wählen Sie Zhipu GLM en für den internationalen Endpunkt.

3. Scrollen Sie nach unten und fügen Sie Ihren z.ai API-Schlüssel in das Feld API Key ein. Das Preset füllt den Rest automatisch aus: das Anthropic Messages (Native)-Format, das Auth-Feld ANTHROPIC_AUTH_TOKEN und die Basis-URL.

4. In Model Mapping, setzen Sie für jede Rolle – Sonnet, Opus, Fable und Haiku – das angeforderte Modell auf glm-5.2, sodass jede Anfrage an GLM weitergeleitet wird, unabhängig davon, nach welcher Stufe Claude Code greift. Aktivieren Sie bei einer Rolle das Kontrollkästchen 1M, um Claude Code den Million-Token-Kontext mitzuteilen. Speichern.

5. Zurück in der Anbieter-Liste, klicken Sie beim Zhipu-GLM-Eintrag auf Enable (ein vorhandener Anbieter wie Claude Official kann in der Liste bleiben, um später wieder zu wechseln), und starten Sie dann Claude Code neu, um sicherzustellen, dass der neue Anbieter übernommen wird. Führen Sie /status aus, um zu bestätigen, dass das Modell glm-5.2 anzeigt.

Warum sich mit der App statt mit einer statischen Konfiguration abmühen: Sie liefert Presets für die meisten Anbieter, die Sie ausprobieren möchten — Kimi, MiniMax, MiMo, Qwen, DeepSeek und mehr — sodass jeder davon eher eine Sache von Preset und Key ist als ein Konfigurations-Rewrite, und der Wechsel zwischen ihnen (oder zurück zu Claude) ist mit ein paar Klicks erledigt. Das ist die praktische Grundlage für den hybriden Workflow unten.

Manuelle Einrichtung mit settings.json

Bevorzugen Sie es, es selbst zu konfigurieren, oder einen CI-Computer ohne GUI einzurichten? Bearbeiten Sie die Datei direkt.

1. Holen Sie sich einen API-Schlüssel aus der Z.AI API-Konsole. Ein Pay-as-you-go-Schlüssel oder ein Abonnementschlüssel für den GLM Coding Plan funktionieren beide. 2. Fügen Sie diesen env-Block in Ihre Claude Code-Einstellungsdatei ein (behalten Sie vorhandene Schlüssel bei — überschreiben Sie 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"
  }
}

3. Claude Code neu starten, dann /status ausführen. Die Modellzeile sollte glm-5.2 anzeigen (oder glm-5.2[1m] für die Million-Token-Variante). Wenn weiterhin ein Claude-Modell angezeigt wird, wurde die Datei nicht übernommen — prüfen Sie auf JSON-Syntaxfehler und bestätigen Sie den Pfad.

Zwei shell-basierte Alternativen, wenn Sie die Datei lieber nicht anfassen möchten:

• macOS / Linux — exportieren Sie die Variablen (bash/zsh) für eine einmalige Sitzung und starten Sie dann:

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

Schließen Sie das Terminal, und Sie sind wieder bei Ihrer normalen Konfiguration.

• Windows — setzen Sie persistente Benutzerumgebungsvariablen in PowerShell und starten Sie dann 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 ANTHROPIC_DEFAULT_*-Variablen ordnen die Modellrollen neu zu, an die Claude Code weiterleitet — Opus, Sonnet und Haiku (neuere Builds fügen eine Fable-Rolle hinzu, die auch CC Switch bereitstellt). Wenn Sie sie alle auf glm-5.2 setzen, wird jede Anfrage an GLM gesendet; wenn Sie Hintergrundaufgaben lieber günstig und schnell halten möchten, weisen Sie stattdessen dem Haiku-Slot glm-4.5-air zu. Verwenden Sie glm-5.2[1m] für das volle Million-Token-Fenster. Der lange API_TIMEOUT_MS ist wichtiger, als er aussieht: GLM-Antworten laufen oft langsamer als die von Claude, und der Standard-Timeout wird lange Generierungen abbrechen.

Welcher Weg: z.ai nativ, ein Proxy oder der Coding-Plan?

Drei praktische Möglichkeiten, GLM-5.2 in Claude Code einzuspeisen, und sie sind nicht austauschbar.

z.ai nativer Endpunkt (empfohlen). Die https://api.z.ai/api/anthropic URL oben. Er spricht das Anthropic-Protokoll, sodass Claude Code ohne Middleware verbunden wird — die Standardwahl.

Ein Übersetzungs-Proxy. Andere Hosts (Fireworks, NVIDIA NIM, selbst gehostete Gewichte) stellen GLM-5.2 über eine OpenAI-kompatible API bereit, die Claude Code nicht direkt lesen kann, sodass sie einen Proxy benötigen, der Formate umwandelt. claude-code-router übernimmt das. Lohnt sich nur, wenn Sie bereits Guthaben oder Hardware auf einer dieser Plattformen haben.

GLM Coding Plan subscription. Ein pauschaler Monatsplan (ab 18 $/Monat, über die Abonnementseite von z.ai), der denselben z.ai-Endpunkt verwendet, aber statt pro Token eine feste Gebühr berechnet. Wenn Sie Claude Code täglich verwenden, ist ein Abonnement in der Regel günstiger und besser planbar als nutzungsabhängige Token; rechnen Sie es mit Ihren monatlichen Tokenkosten durch, um den Break-even zu ermitteln. Wenn Ihre Nutzung schwankt, ist Pay-as-you-go die bessere Wahl.

Wechseln zwischen GLM-5.2 und Claude

Claude Code verwendet jeweils nur einen aktiven Provider, daher *wechseln* Sie statt Slots aufzuteilen: Nutzen Sie GLM-5.2 für das reguläre Volumen und aktivieren Sie Ihren Claude Official-Provider in CC Switch, wenn Sie Claude für Architektur, sicherheitskritischen Code oder Reviews benötigen. Jeder Anthropic-kompatible Endpoint funktioniert für die Claude-Seite — Ihr Anthropic-Konto oder ein Relay wie AIReiter, eine von mehreren Optionen. Für automatisches Routing pro Anfrage über mehrere Provider hinweg übernimmt ein Gateway wie claude-code-router die Weiterleitung.

Fehlerbehebung

Häufig gestellte Fragen

Ist GLM-5.2 in Claude Code kostenlos?

Nicht unbegrenzt, allerdings hat z.ai zeitlich begrenzte kostenlose Zeiträume für GLM-5.2 angeboten, und der Coding Plan beginnt bei 18 $/Monat. Selbst bei den regulären Pay-as-you-go-Tarifen (1,40 $ / 4,40 $ pro Million) kostet die Nutzung in geringem Umfang nur Centbeträge.

Unterstützt GLM-5.2 den 1M-Token-Kontext in Claude Code?

Ja. Setzen Sie die Modell-ID in Ihren ANTHROPIC_DEFAULT_*-Variablen auf glm-5.2[1m] statt auf glm-5.2, und Claude Code verwendet das Million-Token-Fenster.

Ist GLM-5.2 oder Claude besser fürs Programmieren in Claude Code?

Für routinemäßige, sequentielle Bearbeitungen macht der Preisunterschied GLM-5.2 zur rationalen Standardwahl. Claude hat tendenziell die Nase vorn bei mehrstufiger Architektur, sicherheitskritischen Aufgaben und hoch parallelen Subagent-Workflows. Das Umschalt-Setup ermöglicht es Ihnen, jedes dort einzusetzen, wo es am stärksten ist, anstatt sich für eines zu entscheiden.

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

Ja. Derselbe z.ai-Endpunkt und dieselben Schlüssel funktionieren mit anderen agentischen CLIs — OpenCode, Cline und Kilo Code akzeptieren alle eine benutzerdefinierte Base URL, und CC Switch verwaltet Presets für mehrere davon.

Benötige ich ein kostenpflichtiges Claude-Abonnement, um GLM-5.2 in Claude Code zu verwenden?

Nein. Claude Code ist nur der Client; sobald Sie ihn auf z.ai ausrichten, werden Ihnen die Kosten von z.ai berechnet, nicht von Anthropic. Sie brauchen nur dann ein Claude-Konto, wenn Sie Claude als Anbieter verfügbar lassen, um zu ihm zu wechseln.

Muss ich Claude Code nach dem Wechsel des Anbieters in CC Switch neu starten?

Laut den Dokumenten von CC Switch unterstützt Claude Code das Umschalten von Provider-Daten ohne Neustart, während die meisten anderen CLI-Tools tatsächlich einen Neustart des Terminals oder der App benötigen. In der Praxis ist ein Neustart von Claude Code der zuverlässige Weg, um sicherzustellen, dass ein Wechsel wirksam geworden ist.

Wie wechsle ich in CC Switch zurück zu Claude (offizieller Login)?

Fügen Sie aus der voreingestellten Liste einen offiziellen Claude-Anbieter hinzu, aktivieren Sie ihn und führen Sie dann einmal den normalen Abmelde-/Anmeldeprozess (OAuth) von Claude Code aus. Danach können Sie frei zwischen Ihrem offiziellen Claude-Login und Drittanbieter-Anbietern wie z.ai wechseln.

Ist CC Switch kostenlos und sicher zu verwenden?

Ja — es ist Open-Source unter der MIT-Lizenz und kostenlos. Ihre Konfigurationen werden lokal in einer SQLite-Datenbank mit atomaren Schreibvorgängen gespeichert, und per Design nimmt es nur minimale Änderungen an der eigenen Konfiguration jedes Tools vor, sodass Ihre CLIs normal weiter funktionieren, selbst wenn Sie die App deinstallieren.

Weiterführende Literatur

• GLM-5.2 API: Zugriff und Preise

• GLM-5.2 vs. Opus 4.6 für Programmierung

• Codex vs. Claude Code