今日から Claude Code で GLM-5.2 を実行でき、セットアップは約2分で完了します。Claude Code は Anthropic の Messages API に対応する任意のエンドポイントと通信でき、Zhipu は GLM 向けにまさにそれを提供しています。Claude Code の接続先を z.ai に向ければ完了です。導入方法は2つあります。ワンクリックの切り替えアプリ（最も簡単で、いつでも Claude に戻せます）か、手動で編集する設定ファイルです。このガイドでは、macOS、Windows、Linux の各環境での両方の方法に加え、必要に応じて Claude に戻す方法も説明します。
最も速い方法: CC Switch
すでに複数のプロバイダーを使い分けているなら、手動での設定は省いて CC Switch（オープンソース、MITライセンス、Windows/macOS/Linux）を使ってください。これは Claude Code、Codex、Gemini CLI、その他いくつかの CLI のプロバイダー設定を管理するデスクトップアプリなので、JSON を手で編集する必要はありません。
1. ccswitch.io またはその GitHub repo から CC Switch をインストールします。メインウィンドウ右上のオレンジ色の + ボタンをクリックして Add Provider を開き、Claude Provider タブを選択します。2. プリセット検索に zhipu と入力します。Zhipu GLM（中国本土向けエンドポイント）と Zhipu GLM en の 2 つのプリセットが表示されます。中国本土以外では、国際向けエンドポイントとして Zhipu GLM en を選択してください。
3. 下にスクロールし、z.ai API キーを API Key フィールドに貼り付けます。プリセットが残りを自動入力します: Anthropic Messages (Native) 形式、ANTHROPIC_AUTH_TOKEN 認証フィールド、および base URL。
4. Model Mapping で、各ロール — Sonnet、Opus、Fable、Haiku — に対して要求されたモデルを glm-5.2 に設定し、Claude Code がどのティアを参照しても、すべてのリクエストが GLM にルーティングされるようにします。ロールの 1M ボックスにチェックを入れて、100 万トークンのコンテキストを Claude Code に宣言します。保存します。
5. プロバイダー一覧に戻り、Zhipu GLM のエントリで Enable をクリックし（Claude Official などの既存プロバイダーは、後で戻せるように一覧に残しておけます）、その後 Claude Code を再起動して、新しいプロバイダーが確実に反映されるようにします。/status を実行して、モデルが glm-5.2 と表示されることを確認します。
静的な設定ではなくアプリを使う理由は何でしょうか。試したいほとんどのプロバイダー向けのプリセットが最初から用意されているからです — Kimi、MiniMax、MiMo、Qwen、DeepSeek など — そのため、それぞれは設定を書き換える代わりにプリセットとキーを入れるだけで済み、切り替え（または Claude に戻すこと）も数クリックでできます。これが、以下のハイブリッドワークフローの実用的な基盤です。
settings.json を使った手動セットアップ
自分で設定したいですか？それとも GUI のない CI बॉक्स をセットアップしますか？ファイルを直接編集してください。
1. APIキーを取得するには、Z.AI API consoleを開いてください。従量課金のキーでも、GLM Coding Planのサブスクリプションキーでも使用できます。2. このenvブロックをClaude Codeの設定ファイルに統合してください（既存のキーはそのまま残し、ファイル全体を上書きしないでください）。このブロックはどのプラットフォームでも同じで、異なるのはパスだけです: - 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 を再起動してから、/status を実行します。モデルの行には glm-5.2（または100万トークン版では glm-5.2[1m]）と表示されるはずです。まだ Claude モデルが表示される場合は、ファイルが読み込まれていません。JSON の構文エラーがないか確認し、パスを確認してください。
ファイルに手を加えたくない場合の、シェルベースの代替案が2つあります:
macOS / Linux — 一度だけのセッション用に変数をエクスポート（bash/zsh）してから、起動します:
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ターミナルを閉じれば、通常の設定に戻ります。
Windows — PowerShell で永続的なユーザー環境変数を設定し、その後ターミナルを再起動します:
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"ANTHROPIC_DEFAULT_* 変数は、Claude Code がルーティングするモデルの役割である Opus、Sonnet、Haiku（新しいビルドでは Fable の役割も追加され、CC Switch でもそれが公開されています）を再マッピングします。これらをすべて glm-5.2 に設定すると、すべてのリクエストが GLM に送られます。バックグラウンドタスクを安価かつ高速に保ちたい場合は、代わりに Haiku の स्लॉटを glm-4.5-air に向けてください。完全な100万トークンのウィンドウを使うには、glm-5.2[1m] を使用します。長い API_TIMEOUT_MS は見た目以上に重要です。GLM の応答は Claude より遅くなることが多く、デフォルトのタイムアウトでは長い生成が途中で切れてしまいます。
どのルートを選ぶべきか: z.ai ネイティブ、プロキシ、それとも Coding Plan?
GLM-5.2 を Claude Code に取り込む 3 つの実用的な方法があり、これらは互換ではありません。
z.ai のネイティブエンドポイント（推奨）。 上記の https://api.z.ai/api/anthropic URL。Anthropic プロトコルを話すため、Claude Code はミドルウェアなしで接続できます — デフォルトの選択です。
翻訳プロキシ。 他のホスト（Fireworks、NVIDIA NIM、self-hosted weights）は、OpenAI-compatible API 経由で GLM-5.2 を提供しますが、Claude Code はそれを直接読み取れないため、形式を変換するプロキシが必要です。claude-code-router がこれを処理します。これらのプラットフォームのいずれかですでに credits か hardware を持っている場合にのみ、利用する価値があります。
GLM Coding Plan subscription. 同一の z.ai エンドポイントを使用する定額月額プラン（z.ai's subscribe page で月額 $18 から）で、トークンごとではなく固定料金が請求されます。Claude Code を毎日使ってコーディングするなら、通常は従量課金のトークンよりもサブスクリプションのほうが安く、予算も立てやすいです。月間のトークン利用量と比較して損益分岐点を計算してみてください。利用が断続的なら、従量課金のほうが有利です。
GLM-5.2 と Claude の切り替え
Claude Codeは一度に1つのアクティブなプロバイダのみを使用するため、スロットを分けるのではなく*切り替え*ます。通常の大量処理にはGLM-5.2を実行し、Claudeが必要なアーキテクチャ、セキュリティに敏感なコード、またはレビューでは、CC SwitchでClaude Officialプロバイダを有効にします。Claude側では、Anthropic互換のエンドポイントなら何でも動作します。つまり、Anthropicアカウントでも、AIReiterのようなリレーでもよく、これは複数ある選択肢の一つです。プロバイダをまたいでリクエストごとに自動ルーティングするには、claude-code-routerのようなゲートウェイが振り分けを処理します。
トラブルシューティング
症状 | 考えられる原因 | 修正方法 |
|---|---|---|
| settings.json が読み込まれていない | JSON が有効か確認し、 |
| モデル ID が間違っている（大文字小文字を区別） | 正確に |
401 / authentication failed | キー/エンドポイントの不一致 | OpenRouter のキーを z.ai の URL と組み合わせないでください。必要であればキーを再生成してください |
長い生成が途中で切れる | タイムアウトが低すぎる |
|
ツール呼び出しが失敗するかループする | ツール JSON の形式が不正 | 並列サブエージェントを減らす。再試行する。指示を単純化する |
よくある質問
Claude Code で GLM-5.2 は無料ですか?
無制限というわけではありませんが、z.ai は GLM-5.2 で期間限定の無料利用枠を実施しており、Coding Plan は月額 $18 から始まります。従量課金の通常料金（100万あたり $1.40 / $4.40）でも、軽い利用なら数セント程度です。
GLM-5.2はClaude Codeで1Mトークンのコンテキストをサポートしていますか？
はい。ANTHROPIC_DEFAULT_* 変数で、モデル ID を glm-5.2 ではなく glm-5.2[1m] に設定すると、Claude Code は 100 万トークンのウィンドウを使用します。
Claude Codeでのコーディングには、GLM-5.2とClaudeのどちらが優れていますか？
日常的で順次的な編集では、価格差を踏まえると GLM-5.2 が合理的なデフォルトです。Claude は、複数ステップのアーキテクチャ設計、セキュリティに配慮が必要な作業、高並列の subagent ワークフローで優位に立つ傾向があります。切り替え設定により、どちらか一方を選ぶのではなく、それぞれが最も得意な場面で使い分けられます。
Claude Code以外のツールでGLM-5.2を使用できますか？
はい。同じ z.ai エンドポイントとキーは他の agentic CLI でも使えます。OpenCode、Cline、Kilo Code はいずれもカスタム base URL を受け入れ、CC Switch はそれらのいくつかのプリセットを管理します。
Claude CodeでGLM-5.2を使用するには、有料のClaudeサブスクリプションが必要ですか？
いいえ。Claude Code は単なるクライアントです。いったん z.ai を指定すれば、料金は Anthropic ではなく z.ai から請求されます。Claude アカウントが必要なのは、切り替え先として Claude をプロバイダーとして引き続き利用可能にしておく場合だけです。
CC Switch でプロバイダーを切り替えた後、Claude Code を再起動する必要がありますか？
CC Switchのドキュメントによると、Claude Codeは再起動なしでプロバイダーデータのホットスイッチに対応していますが、ほとんどの他のCLIツールではターミナルまたはアプリの再起動が必要です。実際には、切り替えが反映されたことを確実にするには、Claude Codeを再起動するのが信頼できる方法です。
CC Switch で Claude（公式ログイン）に戻すにはどうすればよいですか？
プリセット一覧から Claude Official プロバイダーを追加し、有効にしてから、Claude Code の通常のログアウト / ログイン（OAuth）フローを 1 回実行してください。その後は、公式の Claude ログインと z.ai などのサードパーティプロバイダーを自由に切り替えられます。
CC Switchは無料で安全に使用できますか？
はい — これは MIT ライセンスの下でオープンソースであり、無料です。あなたの設定は SQLite データベース内にローカルで保存され、アトミック書き込みが行われます。また設計上、各ツール自身の設定への変更は最小限に抑えられているため、アプリをアンインストールしても CLI は通常どおり動作し続けます。