Akira

Posted on Aug 27 Originally published at apidog.com

Claude CodeとClineでGLM-5.3-Flashを使う方法

すでにGLMコーディングプランを購読しているなら、GLM-5.3-Flashを検討する具体的な理由があります。同じプランでGLM-5.3の3倍の使用可能クォータがあると報告されているためです。Artificial Analysisのインテリジェンス指数はGLM-5.3の60に対して57ですが、日常的なコーディングでは、3倍のリクエスト数を優先する価値があります。

Apidogを今すぐ試す

このガイドでは、GLM-5.3-FlashをClaude CodeやClineに接続する方法、GLM-5.3を使い続けるべきケース、そしてよくある設定ミスを解説します。

まず必要なもの

z.aiのGLMコーディングプラン（月額約18ドル〜）
Z.aiダッシュボードで発行したAPIキー
インストール済みのClaude CodeまたはCline

作業を始める前に、z.aiでクォータ倍率とプランのティアを確認してください。プラン条件はモデル仕様より頻繁に変更されます。また、3倍という数値はZ.aiの公式ドキュメントに基づくものです。

Claude Codeへの接続

Z.aiはAnthropic互換エンドポイントを提供しています。2つの環境変数を設定すれば、Claude CodeからGLMモデルを利用できます。

方法1：ヘルパーを使う

Z.aiのヘルパーを実行します。

npx @z_ai/coding-helper

APIキーの入力を求められ、必要な設定が自動で書き込まれます。正常に動作した場合は、モデル選択へ進んでください。

方法2：手動で設定する

シェルプロファイルにベースURLとトークンを追加します。

export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="your-z-ai-key"

設定後、通常どおりClaude Codeを起動します。リクエストはAnthropicではなくZ.aiへ送られます。

次の2点に注意してください。

ANTHROPIC_API_KEYとANTHROPIC_AUTH_TOKENは別の変数です。古いAnthropicキーが設定されている場合は解除してください。両方が存在すると、無効なキーに見える認証エラーが発生することがあります。
環境変数が起動プロセスに渡る必要があります。.zshrcに設定していても、シェルプロファイルを読み込まないエディタやランチャーから起動すると認識されません。起動元で次のコマンドを実行して確認します。

echo $ANTHROPIC_BASE_URL

モデルとタイムアウトの設定

接続後、モデルにglm-5.3-flashを指定します。設定ファイルを使う場合は、次のように記述します。

{
  "model": "glm-5.3-flash"
}

GLM-5.3-Flashは100万トークンのコンテキストウィンドウを持ちます。長いコンテキストの処理では、クライアントのタイムアウトを延長すると安定しやすくなります。

export API_TIMEOUT_MS=3000000

この値はGLM-5.2向けの設定から引き継がれています。環境に合わせて調整してください。既存設定の移行には、GLM-5.2ハーネスガイドも参考になります。

Clineへの接続

ClineではAnthropic互換プロバイダーではなく、OpenAI互換プロバイダーを選択します。

Clineの設定を開き、APIプロバイダーにOpenAI Compatibleを選択する。
ベースURLに次を設定する。

https://api.z.ai/api/coding/paas/v4

Z.aiのAPIキーを入力する。
Custom Modelを選択し、glm-5.3-flashを入力する。

ベースURLを間違えないでください。コーディングプラン用のエンドポイント（/api/coding/paas/v4）は、直接API呼び出しに使う標準エンドポイント（/api/paas/v4）とは異なります。標準エンドポイントの詳細は、GLM-5.3-Flash APIガイドで確認できます。

両方のURLがドキュメントやコミュニティ投稿に登場するため、コーディングプランのキーで標準URLを使うと認証に失敗しやすくなります。パスは変更される可能性があるため、現在のZ.aiドキュメントでも確認してください。

コンテキストウィンドウを手動設定する

Clineはカスタムモデルのコンテキストウィンドウを正しく推測できない場合があります。大規模なコードベースで早期にコンテキストが切り詰められる場合は、手動で1,000,000に設定してください。

GLM-5.2でも同じ問題が報告されていました。モデルがファイルコンテキストを保持できていても、Clineが早い段階で破棄することがあります。

エージェント型コーディングでFlashを使う理由

以下は、Z.aiが公開しているベンチマークです。

ベンチマーク	GLM-5.3-Flash	GLM-5.2
Terminal-Bench 2.1	84.3	直接比較不可
DeepSWE	63.4	46.2
AutomationBench	48.8	26.2

Terminal-Benchの数値はClaude Code 2.1.207で評価されており、一般的なコーディングハーネスに直接関係します。ただし、独立した検証が出るまではベンダーの主張として扱ってください。

Artificial Analysisによる独立測定では、インテリジェンス指数はGLM-5.3の60に対して57でした。

Flashには、コーディングハーネスにとって重要な新機能もあります。それがネイティブ画像入力です。コードと同じリクエスト内でスクリーンショットをコンテンツブロックとして渡せます。

フロントエンド作業では、壊れたレイアウトのスクリーンショットを貼り付け、モデルにレンダリング結果を直接推論させられます。Z.aiもインターフェースの観察やレンダリング結果への対応を説明しています。詳しくは、GLM-5.3-FlashビジョンAPIガイドを参照してください。

速度とクォータのトレードオフ

GLM-5.3-Flashの生成速度は毎秒約49トークン、GLM-5.3は約86トークンです。長いファイルを書き換える場合、この差は体感できます。

一方、最初のトークンまでの時間は1.52秒対1.57秒で、ほぼ同じです。応答開始は同程度に速く、差が出るのは長い出力です。

つまり、3倍のクォータと引き換えに生成速度は約半分になります。

短い編集、ツール呼び出し、探索、反復作業：Flashが有利
800行のファイル全体を書き換える作業：GLM-5.3の速度が有利な場合がある

実用的なルーティング戦略

どちらか一方に固定する必要はありません。

探索、コードの読み込み、コマンド実行、小さな編集、画像を使う作業にはFlashをデフォルトで使用する。
難しいアーキテクチャ設計、大規模リファクタリング、Flashが一度失敗した作業にはGLM-5.3を使用する。

ハーネスの設定でモデルIDを変更するだけなので、切り替えには数秒しかかかりません。通常の処理を3倍クォータのFlashに寄せ、高性能モデルのクォータを難しい作業に温存できます。

Z.aiによると、オフピーク時の呼び出しは標準ポイントの半分しか消費しません。バッチ処理やバックグラウンドエージェントをオフピークに実行すると、プランをさらに有効活用できます。

トラブルシューティング

すべてのリクエストで401または403になる

誤ったベースURLを使っているか、古いANTHROPIC_API_KEYがANTHROPIC_AUTH_TOKENの代わりに使われている可能性があります。ハーネスを変更する前に、後述の直接curl呼び出しで認証を確認してください。

モデルが見つからない

モデルIDを正確に確認します。

glm-5.3-flash

バージョンにはドットがあり、flashの前にはハイフンがあります。OpenRouterのz-ai/glm-5.3-flashという名前空間は、Z.aiのネイティブIDとは異なります。

コンテキストが早期に切り詰められる

Clineのコンテキストウィンドウを手動で1,000,000に設定してください。Clineはカスタムモデルの値を常に正しく推測するとは限りません。

大きなリクエストがタイムアウトする

API_TIMEOUT_MSを増やします。非常に長いコンテキストでは、正常なリクエストでもクライアントのデフォルトタイムアウトを超えることがあります。

クォータの消費が速い

reasoning_effortはデフォルトでmaxになっており、推論トークンもカウントされます。ハーネスで設定できる場合、日常的な作業ではlowに下げるとクォータを節約できます。

ツール呼び出しが失敗する、または形式が不正になる

ハーネスとエンドポイントが同じツール呼び出し形式に対応しているか確認してください。ツール呼び出しは統合の中でも特にバージョン依存が強く、どちらかを更新した後に壊れやすい部分です。

その他のハーネス

次の2種類の接続形式で、ほとんどのツールに対応できます。

Anthropic互換：Claude Codeや一部のエージェントフレームワーク ANTHROPIC_AUTH_TOKENとhttps://api.z.ai/api/anthropicを使用
OpenAI互換：Cline、Roo、Kilo、OpenCode、Codex、Cursorのカスタムモデル標準のAPIキーフィールドにキーを設定し、glm-5.3-flashをカスタムモデルIDとして、https://api.z.ai/api/coding/paas/v4を使用

過去のモデルについては、GLM-5.1とClaude CodeおよびGLM-4.7とClaude CodeおよびCursorのガイドも参照してください。

接続を確認する

ハーネスを疑う前に、エンドポイント単体で動作するか確認します。

curl https://api.z.ai/api/coding/paas/v4/chat/completions \
  -H "[REDACTED CREDENTIAL] $ZAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3-flash",
    "messages": [{"role": "user", "content": "reply with OK"}]
  }'

応答が返るのにハーネスだけが失敗する場合、問題は資格情報ではなくハーネス設定にあります。

一時的な確認以上の作業では、シェル履歴よりApidogが便利です。コーディング用エンドポイントと標準エンドポイントを別の環境変数として保存しておけば、認証エラーが発生したときに、エンドポイントの問題かツールの問題かをワンクリックで切り分けられます。

よくある質問

コーディングプランは必須ですか？

APIクレジットでも利用できます。コーディングプランは日常的にコーディングする開発者に向いており、従量課金制のAPIはアプリケーション利用に適しています。詳しくは、GLM-5.3-Flashの料金比較を確認してください。

Flashには本当に3倍のクォータがありますか？

これはZ.aiが公表している数値です。契約前にz.ai/subscribeで最新情報を確認してください。

Clineがコンテキストを切り詰めるのはなぜですか？

カスタムモデルのコンテキストウィンドウを正しく推測できていない可能性があります。手動で1,000,000に設定してください。

どのベースURLを使いますか？

Claude Code：https://api.z.ai/api/anthropic
コーディングプラン対応のOpenAI互換ツール：https://api.z.ai/api/coding/paas/v4
直接API呼び出し：https://api.z.ai/api/paas/v4

Flashを使うClaude Codeにスクリーンショットを貼れますか？

GLM-5.3-Flashはネイティブ画像入力に対応しています。ただし、実際に画像入力を公開しているかはハーネスのバージョンによって異なるため、導入前にテストしてください。

DEV Community