# GLM-5.3-FlashをClaude Codeで使う設定：モデル割り当てとeffort

> Claude CodeのメインはOpus用の変数で動くので、そこをglm-5.3-flash[1m]にします。既定effortはhighで、Z.aiが勧めるmaxではありません。

- URL: https://blog.laozhang.ai/ja/posts/glm-5-3-flash-claude-code
- Published: 2026-10-30
- Updated: 2026-10-30
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ja/about)
- Topic: Claude Code
- Tags: GLM-5.3-Flash, Claude Code, GLM Coding Plan, Z.ai, settings.json, effort

---
GLM-5.3-FlashをClaude Codeで使うには、Z.aiのGLM Coding Plan（月額$18から）に加入し、`~/.claude/settings.json`の`env`に設定を書きます。`ANTHROPIC_BASE_URL`をプラン専用の`https://api.z.ai/api/anthropic`に、`ANTHROPIC_AUTH_TOKEN`をZ.aiのAPIキーにし、`ANTHROPIC_DEFAULT_OPUS_MODEL`・`ANTHROPIC_DEFAULT_SONNET_MODEL`・`ANTHROPIC_DEFAULT_HAIKU_MODEL`の3つに`glm-5.3-flash[1m]`を入れます。Claude Code自体はクライアントにすぎず、どのモデルが答えてプランのクレジットがどれだけ減るかは、送り先のZ.aiとこの3つの変数で決まります。

いちばん間違えやすいのは、Claude Codeのメインのセッションが`ANTHROPIC_DEFAULT_OPUS_MODEL`の値で動くことです。Z.aiのClaude Codeページにある手動設定の例はOpusとSonnetが`glm-5.3[1m]`なので、そのまま写すとメインはFlashではなくGLM-5.3になり、同じ作業でクレジットが約3倍減ります。2026年10月30日にClaude Code 2.1.312の送信内容を記録したところ、この例では既定のリクエストが`model: "glm-5.3"`で送られていました。

もう一つは思考の強さです。Claude Codeは既定でeffort `high`を送り、Z.aiはそれを`high`として処理するため、Z.aiがコーディング向けに勧める`max`にはなりません。毎回`max`で動かしたい場合は`env`に`"CLAUDE_CODE_EFFORT_LEVEL": "max"`を加えます。設定後に新しいターミナルで`claude`を起動し、`/status`のModel欄に`glm-5.3-flash[1m]`が出ていれば切り替わっています。

## GLM Coding PlanとZ.aiのエンドポイント：始める前の条件

Claude CodeでGLM-5.3-Flashをプランの範囲で使えるのは、GLM Coding PlanのAPIキーで`https://api.z.ai/api/anthropic`に接続したときだけです。2026年10月30日時点で、Lite・Pro・MaxのすべてのプランがGLM-5.3とGLM-5.3-Flashに対応し、プランで呼べるモデルはこの2つに限られます。高速版のGLM-5.3-FlashXは、[Z.aiのGLM-5.3-Flashモデルページ](https://docs.z.ai/guides/vlm/glm-5.3-flash)でプランの対象外と明記されています。中国本土向けのbigmodel.cnで契約した場合は、エンドポイントが`https://open.bigmodel.cn/api/anthropic`に変わるだけで、以下の設定はそのまま使えます。

プランは有料で、Claude Codeから無料でGLM-5.3-Flashを使う方法はありません。無償で手に入るのは公開されているモデルの重みで、手元のGPUで動かす要件は[GLM-5.3-Flash導入ガイド：Ox Alphaの正体、API料金、ローカル実行](https://blog.laozhang.ai/ja/posts/glm-5-3-flash-guide)で確認できます。また、プランは対応ツールの中でだけ使えるもので、アカウントの共有は禁止されています（[Z.aiのGLM Coding Plan利用ポリシー](https://docs.z.ai/devpack/usage-policy)）。

## settings.jsonの書き方：エンドポイント、APIキー、3つのモデル変数

設定はすべて`settings.json`の`env`ブロックに書きます。ターミナルで毎回`export`する必要はなく、次の順で進めれば一度で済みます。

1. Z.aiでGLM Coding Planを購入し、「Personal Coding Plan > Plan Overview」でAPIキーを作成します。
2. 設定ファイルを開きます。macOSとLinuxは`~/.claude/settings.json`、Windowsは`%USERPROFILE%\.claude\settings.json`です。ほかの項目がすでに入っている場合はファイル全体を置き換えず、`env`のキーだけを追加・更新します。
3. 次のJSONの内容を`env`に反映し、`your_zai_api_key`を自分のキーに置き換えます。
4. 開いているClaude Codeをすべて閉じ、新しいターミナルで`claude`を起動します。「Do you want to use this API key」と聞かれたら「Yes」を選びます。

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.3-flash[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.3-flash[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.3-flash[1m]"
  }
}
```

各キーの役割は次のとおりです。`ANTHROPIC_BASE_URL`と`ANTHROPIC_AUTH_TOKEN`は送り先と認証で、ここがプラン用の値でないと後述の1113エラーになります。`API_TIMEOUT_MS`はZ.aiの設定例にある値で、3,000,000ミリ秒は50分です。モデル名の`[1m]`は「このモデルは100万トークンのコンテキストを持つ」とClaude Codeに伝える印で、Claude Codeは送信時に`[1m]`を外して`glm-5.3-flash`として送り、1Mコンテキスト用のヘッダーを付けます。`CLAUDE_CODE_AUTO_COMPACT_WINDOW`は会話を自動で要約する上限で、Claude Codeが受け付けるのは100,000〜1,000,000です。モデル変数とこのキーの詳細は[Z.aiの「How to Switch Models」ページ](https://docs.z.ai/devpack/latest-model)にあります。

手で書く代わりに、Z.aiの`npx @z_ai/coding-helper`や、macOSとLinux向けのスクリプト`claude_code_zai_env.sh`で設定することもできます。ただしスクリプトが書き込むのはキー、送り先、タイムアウトの3つだけで、モデル変数は入りません。次の節で説明するモックでの記録では、その状態のClaude Code 2.1.312は`claude-opus-5-5`というAnthropicのモデル名で送っており、Z.aiがその名前をどのGLMに割り当てるかはドキュメントからは読み取れないため、スクリプトを使った後も上の3つのモデル変数は自分で足しておきます。設定ファイルの優先順位やキーの扱い全般は[Claude Code API 設定：キー、settings.json、モデル、ゲートウェイの確認手順](https://blog.laozhang.ai/ja/posts/claude-code-api-configuration)が詳しいです。

## Opus・Sonnet・Haikuの枠：メインはOpus枠、Haiku枠は裏の処理

Claude Codeには`opus`・`sonnet`・`haiku`という3つの呼び名があり、`ANTHROPIC_DEFAULT_OPUS_MODEL`などの変数は、それぞれの呼び名で実際に送るモデルIDを決めます。以下ではこれを「枠」と呼びます。`ANTHROPIC_BASE_URL`を自分で指定した状態では、メインのセッションはOpus枠、対話中のバックグラウンド処理はHaiku枠、`Explore`と`general-purpose`のサブエージェントはメインと同じ枠を使います。つまり作業の大半を担うのはOpus枠に入れたモデルで、Flashにしたいならまずここに`glm-5.3-flash[1m]`を入れます。

この挙動は、2026年10月30日にClaude Code 2.1.312（macOS、npm版）で確かめたものです。`ANTHROPIC_BASE_URL`をZ.aiではなく手元で動かしたモックのエンドポイントに向け、届いたリクエストをそのまま記録しました。モックは受け取った内容を保存して決まった返事を返すだけで、Z.aiのアカウントもGLMのモデルも使っていません。そのため分かるのはClaude Codeが何をどのモデル名で送るかまでで、Z.aiのサーバーがそれをどう処理し、どのモデルが実際に答えるかは、Z.aiのドキュメントに基づいて書いています。

3つの枠に別々のダミー名を入れて試すと、`--model`を付けない起動はOpus枠、`--model sonnet`はSonnet枠、`--model haiku`はHaiku枠の名前で送られました。対話モードでは、メッセージを送るたびにその前にHaiku枠への短いリクエストが1回出ており、中身はツールなしでセッションのタイトルを作る処理でした（`-p`の単発実行では出ません）。Claude Codeのドキュメントも、Haiku枠を「`haiku`またはバックグラウンド機能に使うモデル」と説明しています。サブエージェントを呼ばせた場合は、`Explore`も`general-purpose`もHaiku枠ではなくセッションのモデル（Opus枠）で送られました。

Z.aiの公式ドキュメントには、この割り当てが異なる2つの設定例があります。同じ方法で両方を送らせた結果が次の表です。

| 設定例（Z.aiのページ） | メインのセッション | バックグラウンド（タイトル生成） | サブエージェント |
| --- | --- | --- | --- |
| 「How to Switch Models」：3枠ともFlash | `glm-5.3-flash` | `glm-5.3-flash` | `glm-5.3-flash` |
| Claude Codeページの「Manual configuration」：HaikuだけFlash、SonnetとOpusはGLM-5.3 | `glm-5.3` | `glm-5.3-flash` | `glm-5.3` |

コストや利用上限を理由にFlashへ替えるなら、3枠ともFlashにする前者を選びます。後者はメインもサブエージェントもGLM-5.3で動き、Flashになるのはタイトル生成だけです。タイトル生成は1回あたりFlashで約0.25クレジット（入力約1,000、出力約30トークンとした場合）なので、Haiku枠をFlashにしても節約できる量はわずかです。

![メインのセッション・タイトル生成・サブエージェントが使う枠と、Z.aiの2つの設定例で実際に送られるモデル名の対応](https://blog.laozhang.ai/posts/ja/glm-5-3-flash-claude-code/img/claude-code-model-slots.webp)

普段はFlashで、難しい作業のときだけGLM-5.3を使いたい場合は、OpusとHaikuを`glm-5.3-flash[1m]`、Sonnetを`glm-5.3[1m]`にしておき、必要なときだけ`claude --model sonnet`で起動します。セッション中に`/model`で枠を替えると、その選択が`settings.json`に`"model": "haiku"`のような形で保存され、次回以降の既定になる点には注意してください。2つのモデルの得意分野の違いは[GLM-5.3とGLM-5.3-Flash：実務ではどちらを先に試すか](https://blog.laozhang.ai/ja/posts/glm-5-3-vs-glm-5-3-flash)で比べています。なお、プラン上で画像を扱えるのはFlashで、GLM-5.3はテキスト専用です。

## /statusで確認：Model欄にglm-5.3-flash[1m]、送り先にZ.ai

設定が読み込まれたかどうかは、Claude Codeの中で`/status`を開けば一度で確認できます。

1. 新しいターミナルで`claude`を起動し、`/status`と入力します。
2. Modelが`Default (glm-5.3-flash[1m])`になっているか見ます。`Default`の括弧内はOpus枠の値です。
3. Auth tokenが`ANTHROPIC_AUTH_TOKEN`、Anthropic base URLが`https://api.z.ai/api/anthropic`、Setting sourcesに`User settings`が出ていれば、`~/.claude/settings.json`が使われています。

Modelの括弧内が`glm-5.3[1m]`ならOpus枠がGLM-5.3のままです。`Default`以外の表示になっている場合は、以前に`/model`で選んだ枠が`settings.json`に残っていないか確認します。起動画面には`glm-5.3-flash[1m] · API Usage Billing`と表示されますが、これはClaude CodeがAPIキーでの接続をそう表示しているだけです。実際にどれだけクレジットを使ったかは、Z.aiの管理画面の「Charge Type」ページで料金種別ごとのトークン数として確認できます。

## effortは既定でhigh：maxで固定するならCLAUDE_CODE_EFFORT_LEVEL

Claude Code 2.1.312は、何も指定しなければリクエストに`output_config.effort: "high"`を付けて送ります（2026年10月30日、上と同じモックでの記録）。Z.aiのドキュメントによると、プランのエンドポイントは「明示されたeffort > 思考のオン・オフ > 既定のmax」の順で思考の強さを決め、`medium`と`high`は`high`、`xhigh`と`max`は`max`に変換します。Claude Codeは常にeffortを明示するので、Z.aiが既定と呼ぶ`max`は使われず、GLM-5.3-Flashは`high`で動きます。

`max`にする方法は2通りあります。セッション中に`/effort max`と打つと次のリクエストから`max`になりますが、Claude Codeは「this session only」と表示し、新しいセッションでは`high`に戻ります。毎回`max`にしたいなら、`env`に次の1行を足します。代わりに`settings.json`の最上位に`"effortLevel": "xhigh"`と書いても新しいセッションで`xhigh`が送られ、Z.aiの変換表ではこれも`max`になります。

```json
"CLAUDE_CODE_EFFORT_LEVEL": "max"
```

どちらにするかは、作業の重さとプランの残りで決めます。Z.aiは、Claude Code 2.1.207上で動かした自社のZ.ai Code Bench v1.0で、GLM-5.3-Flashの成績がeffortで変わり、`max`ではClaude Opus 4.8に近い29.0（Opus 4.8は29.5）になったと公表しています。一方で思考のトークンは出力として数えられ、Flashの出力はクレジットの係数が最も高い部分なので、`max`では1ターンあたりの消費が増えます。Liteで小さな修正を数多くこなすなら`high`のまま、設計や大きな改修のセッションでは`max`、という分け方が無理のないところです。

思考を軽くしたいときに`CLAUDE_CODE_DISABLE_THINKING=1`を設定しても、送信から`thinking`が消えるだけでeffort `high`は付いたままなので、Z.aiの優先順位では`high`のまま処理されます。軽くしたいなら`/effort low`を使います。また、Claude Codeが送る出力上限（`max_tokens`）は既定で32,000で、`CLAUDE_CODE_MAX_OUTPUT_TOKENS=128000`を設定すると128,000になります。GLM-5.3-Flashの最大出力は128Kです。

## Flashのクレジット：Liteの5時間枠で約300ターン

GLM-5.3-FlashはGLM-5.3よりクレジットの減りが約3分の1で、Z.aiも「GLM-5.3の3倍の利用量」と説明しています。中くらいのエージェント作業1ターンを前提にすると、Liteの5時間枠でFlashはピーク時に約299ターン、オフピークに約598ターン使え、GLM-5.3では約99ターンと約198ターンです。ピーク時間は平日の14:00〜18:00（シンガポール時間、UTC+8）、日本時間では平日15:00〜19:00で、それ以外の時間と週末はモデルの消費が半分になります。

計算式はZ.aiの公開どおり「（入力 × 入力係数 ＋ キャッシュ入力 × キャッシュ係数 ＋ 出力 × 出力係数）÷ 10,000」で、係数はFlashが2.3・0.56・8、GLM-5.3が6.9・1.7・24です。1ターンをキャッシュ済みの文脈60,000トークン、新しい入力4,000トークン、思考を含む出力3,000トークンと仮定すると、Flashは（4,000 × 2.3 ＋ 60,000 × 0.56 ＋ 3,000 × 8）÷ 10,000 ＝ 6.68クレジット、GLM-5.3は同じ計算で20.16クレジットです。オフピークはその半分の3.34と10.08になります。ターン数はこの値でプランのクレジットを割ったものです。

![1ターンの消費クレジットと、Liteの5時間枠で使えるターン数をFlashとGLM-5.3、ピークとオフピークで比べた図](https://blog.laozhang.ai/posts/ja/glm-5-3-flash-claude-code/img/lite-window-turns.webp)

| プラン（月払いの月額） | 5時間枠 / 週間のクレジット | Flash：ピーク / オフピーク | GLM-5.3：ピーク / オフピーク |
| --- | --- | --- | --- |
| Lite（$18） | 2,000 / 10,000 | 約299 / 約598ターン | 約99 / 約198ターン |
| Pro（$80） | 12,000 / 60,000 | 約1,796 / 約3,592ターン | 約595 / 約1,190ターン |
| Max（$168） | 28,000 / 140,000 | 約4,191 / 約8,383ターン | 約1,388 / 約2,777ターン |

価格とクレジットは2026年10月30日時点の[Z.aiのGLM Coding Plan概要ページ](https://docs.z.ai/devpack/overview)と購入ページの表示で、四半期払いは20%引き、年払いは30%引きです。どのプランも週間クレジットは5時間枠のちょうど5回分なので、5時間枠を毎回使い切る使い方では週の途中で週間の上限に先に当たります。キャッシュ済み150,000、新規入力10,000、出力8,000トークンの重いターンでは、Flashでも1ターン17.10クレジット（オフピーク8.55）になり、Liteの5時間枠は約116ターン（オフピーク約233ターン）まで減ります。トークン数は説明のための仮定で、effortを`max`にすれば出力が増えるぶんターン数は下がります。Z.ai自身の見積もりでは、キャッシュヒット率95%のときLiteで週146〜292Mトークンです。

クレジットを使い切っても、Claude Codeからの呼び出しがアカウント残高から引かれることはありません。5時間枠は消費から5時間後に、週間クレジットは契約日から7日ごとに戻るので、それまで待つことになります。同時に動かせる量もプランで決まっており、Z.aiはLiteなら同時に1プロジェクト、Proなら1〜2、Maxなら2つ以上を目安に挙げています。

## 最初に出るエラー：1113、反映されない、[1m]、200k警告

GLM-5.3-FlashをClaude Codeに設定した直後のトラブルは、多くが送り先かモデル名の書き方に原因があります。出たメッセージや症状から、次の表で原因を絞り込みます。

| 症状 | 原因 | 対処 |
| --- | --- | --- |
| `1113 Insufficient Balance`が出る、またはアカウント残高が減る | プランの条件から外れています。`ANTHROPIC_BASE_URL`が`https://api.z.ai/api/anthropic`以外か、プランで呼べないモデル名（GLM-5.3-FlashXなど）を送っています | 送り先をプラン用のURLに直し、モデル名を`glm-5.3-flash`か`glm-5.3`にします |
| `settings.json`を書き換えても反映されない | 古いウィンドウのまま動いているか、JSONの書式が壊れています | Claude Codeをすべて閉じて新しいターミナルで起動し、カンマや引用符の過不足を確認します。それでも駄目ならZ.aiの案内どおりファイルを作り直します |
| Flashにしたのに`/status`のModelが`glm-5.3[1m]` | Opus枠がGLM-5.3のままです（Claude Codeページの手動設定例をそのまま使った場合など） | `ANTHROPIC_DEFAULT_OPUS_MODEL`を`glm-5.3-flash[1m]`にします |
| `/status`のModelが`Default`ではなく別の枠になっている | 以前に`/model`で選んだ枠が`settings.json`の`"model"`に保存されています | `settings.json`から`"model"`の行を消すか、`/model`で選び直します |
| `[1m]`付きのモデルが存在しないと言われる | Claude Codeが古く、`[1m]`の書き方に対応していません | `claude update`で最新版にします |
| `Claude Code doesn't recognize the model ... assumes a context window of 200k tokens` | `[1m]`の付いていない名前で起動しています（枠の値に`[1m]`がない状態で`--model sonnet`を使った場合など） | 枠の値に`[1m]`を付けます |
| 途中で応答が止まり、上限に達したと表示される | 5時間枠か週間のクレジットを使い切りました | 残高からは引かれないので、枠が戻るのを待つか、オフピークやFlashに寄せて消費を抑えます |

200kの警告は止まる原因にはなりませんが、Claude Codeはその場合20万トークンで会話を要約してしまうため、1Mのコンテキストを生かしたいなら直しておく価値があります。

## プランなしでGLM-5.3-Flashを使う：OpenRouterと従量課金API

GLM Coding Planに入らずにGLM-5.3-Flashを使う経路もありますが、Claude Codeの設定方法と料金の考え方が変わります。2026年10月25日時点で、Z.aiの従量課金APIは100万トークンあたり入力$0.15、キャッシュ入力$0.03、出力$0.50で、OpenRouterでは`z-ai/glm-5.3-flash`として提供されています。OpenRouter経由でClaude Codeにつなぐ手順は[Claude CodeでOpenRouterとDeepSeekを使う：経路、設定、初回エラー対応](https://blog.laozhang.ai/ja/posts/claude-code-openrouter-deepseek)、DeepSeekとの1タスクあたりの費用は[DeepSeek V4.1 FlashとGLM-5.3-Flash比較：料金は時間帯で逆転](https://blog.laozhang.ai/ja/posts/deepseek-v4-1-flash-vs-glm-5-3-flash)を参照してください。

## GLM-5.3-FlashとClaude Codeの設定でよくある質問

### 以前のGLM-4.7の設定のままでも動きますか？

動きます。2026年10月30日時点のZ.aiの案内では、プランへのGLM-4.7のリクエストはGLM-5.3-Flashに、GLM-5.2とGLM-5.1のリクエストはGLM-5.3に自動で振り替えられます。ただし`/status`には`glm-4.7`と表示されたままで実際のモデルと食い違い、`[1m]`のない名前を`--model sonnet`などで選ぶと200kの警告も出ます。名前を`glm-5.3-flash[1m]`に書き換え、`CLAUDE_CODE_AUTO_COMPACT_WINDOW`を足しておくのが確実です。

### GLM-5.3-Flashが「自分はClaudeです」と答えるのはおかしくないですか？

GLM-5.3-Flashが自分をClaudeだと名乗るという投稿はRedditにもありますが、モデルの自己紹介はどのモデルが動いているかの確認には使えません。Claude Codeが毎回送るシステムプロンプトには「You are Claude Code, Anthropic's official CLI for Claude.」という一文が入っていました（2026年10月30日、Claude Code 2.1.312の送信内容）。実際のモデルは`/status`のModel欄と、Z.aiの「Charge Type」ページのモデル別の消費で確かめます。

### GLM Coding Planは解約や返金ができますか？

解約はできますが、購入後の返金はZ.aiの規約で一切受け付けていません。自動更新を止めるには、Z.aiの管理画面の「Subscription」ページで次回の請求日より前に解約します。期限はFAQでは24時間前、利用ポリシーでは3日前と書かれているので、3日前までに済ませておくのが確実です。解約しても、支払い済みの期間の終わりまでは使えます。

## 参考資料

本文で参照している外部ページを、登場順に並べています。最終更新日：2026-10-30。

- [Z.aiのGLM-5.3-Flashモデルページ](https://docs.z.ai/guides/vlm/glm-5.3-flash) (docs.z.ai)
- [Z.aiのGLM Coding Plan利用ポリシー](https://docs.z.ai/devpack/usage-policy) (docs.z.ai)
- [Z.aiの「How to Switch Models」ページ](https://docs.z.ai/devpack/latest-model) (docs.z.ai)
- [Z.aiのGLM Coding Plan概要ページ](https://docs.z.ai/devpack/overview) (docs.z.ai)