Z.AI の動作方法
Z.AI（Zhipu AI によって開発）は GLM ファミリーのモデルを提供します。API アクセスに定額サブスクリプションを提供している数少ない主要プロバイダーの1つです：GLM Coding Plan は、トークンごとの課金ではなく5時間および週次ウィンドウに適用されるレート制限で、固定月額料金でモデル使用量をバンドルします。 より大量または変動するワークロードには、Z.AI は標準 Developer API で同じモデルへのペイパートークンアクセスも提供しています。 両方のパスは OpenAI 互換エンドポイントを公開しているため、Kodus は OpenAI-compatible プロバイダーを通じて通信できます。Kodus には専用の Z.ai プロバイダーもあり、Z.AI の Anthropic 互換エンドポイント（https://api.z.ai/api/anthropic）経由で接続します。
プランの概要
価格とクォータは定期的に変更されます。ティアを選択する前に、z.ai/subscribe と docs.z.ai で最新の数値を必ず確認してください。
GLM Coding Plan（サブスクリプション）
- クォータはローリング5時間ウィンドウと週次ウィンドウでリセットされます — 月次上限ではなくその上限を念頭に計画してください。
- カバレッジには GLM-5.1、GLM-5-Turbo、GLM-5、GLM-4.5、GLM-4.5-Air が含まれます。
- Coding Plan のエンドポイント：
https://api.z.ai/api/anthropic（Anthropic 互換 — Kodus の Z.ai プロバイダーが使用するもの）とhttps://api.z.ai/api/coding/paas/v4（OpenAI 互換）。標準の/api/paas/v4/エンドポイントは Coding Plan を消費しません。
ペイパートークン Developer API
標準エンドポイント：
https://api.z.ai/api/paas/v4/（OpenAI 互換）。
APIキーの作成
- Coding Plan サブスクライバー
- Developer API（ペイパートークン）
- z.ai にサインインします。
- z.ai/subscribe で GLM Coding Plan ティアを購入します。
- サブスクリプションのキー管理ページを開き、Coding Plan キーを作成します。
- キーをコピーします — 再度見ることはできません。
Coding Plan キーは Coding Plan のエンドポイント（
/api/anthropic と /api/coding/paas/v4）に紐づいています。標準の /api/paas/v4/ エンドポイントに対して送信すると401 を返します。Kodus で Z.AI を設定する
主なフローは Kodus Cloud の AI providers ページです。プロセスレベルでプロバイダーを固定することを好むセルフホストユーザーは、代わりに環境変数を使用できます。オプション1 — Kodus Cloud の Z.ai プロバイダー（推奨）
1
AI providers を開き Z.ai を選択
サイドバーで AI providers を開きます（app.kodus.io/byok）。Providers タブで Z.ai タイルをクリックします（Connect your first provider の下、またはすでにプロバイダーを接続している場合は Add another provider の下）。
2
APIキーを貼り付けてモデルを入力
Z.AI キーを API key カードに貼り付け、Model にモデル ID（例：
glm-5.1）を入力します。Kodus は https://api.z.ai/api/anthropic エンドポイント（Z.AI が GLM Coding Plan 向けに文書化している Anthropic 互換エンドポイント）を自動で入力するため、このタイルにはプランセレクターもベース URL フィールドもありません。特定の OpenAI 互換エンドポイントを使用したい場合は、下記のオプション2を使用してください。3
同時実行数を設定（Coding Plan）
Kodus は同時実行数を事前入力しません。Coding Plan Lite/Pro では、Advanced (optional) を開いて Max concurrent requests を
1 に設定します。Max ティアの場合は最大 30 まで上げてください。4
Test & save
Test & save をクリックします。Kodus は接続をテストし、成功時に設定を保存します。401 はキーがエンドポイントと一致しないことを意味します。
Reasoning のチューニング（任意）
Thinking / Reasoning は Advanced (optional) の下にあります。GLM では、Off 以外のレベルはすべてthinking: { type: "enabled" } を生成し、ほとんどのワークロードではこれで問題ありません。オーバーライドする2つのケース：
-
特定のトークン予算を強制 — Thinking / Reasoning を Custom に切り替え、以下を貼り付け：
-
thinking を無効化 — 小さな PR で最速/最安のレビューのために：
名前空間のラップは不要です — Kodus が送信前にオプションをアクティブなプロバイダーの名前空間でラップします。詳しくは main BYOK doc → Custom JSON override を参照してください。
同時実行数のチューニング
- Coding Plan Lite / Pro：Max concurrent requests を
1に設定します。それ以上にすると429 Too much concurrencyを返します。 - Coding Plan Max：最初に
5に上げ、429 が発生しなければ最大30まで。Max ティアは最大30 concurrent を許可します。 - Developer API：空のまま開始（制限なし）。レート制限エラーが発生したら
5に下げ、その後調整します。
Routing タブで GLM 5.1 を Model for all tasks に、OpenAI または Anthropic のモデルを Fallback (optional) に設定することで、Coding Plan の5時間ウィンドウが枯渇してもレビューが継続されます。Kodus は自動的にフェイルオーバーします。
オプション2 — OpenAI 互換エンドポイント
Z.AI の OpenAI 互換エンドポイントのいずれかを通じて接続するには、AI providers を開き、Providers タブの Custom の下にある OpenAI-compatible を選択して以下を入力します：オプション3 — セルフホスト（環境変数）
固定モード（単一グローバルプロバイダー、組織ごとの BYOK なし）で Kodus を実行している場合は、API とワーカーコンテナの.env で Z.AI を設定します：
このパスは意図的に BYOK を無効にしているセルフホスト Kodus インストールにのみ必要です。セルフホストインスタンスで BYOK が有効な場合は、オプション1を優先してください — AI providers ページはクラウドと同じように動作します。
.env を編集後、API とワーカーコンテナを再起動して統合を確認します：
Coding Plan とペイパートークンの選択
- 予測可能なレビュアーチームがあり、定額月額コストを希望する場合は Coding Plan を選択します。5時間および週次クォータは、サブスクリプション料金に対して約15〜30倍の同等 API 支出に相当します。
- トラフィックがバースト的な場合、最大コンテキストウィンドウへの不定期アクセスが必要な場合、または PR ボリュームに応じてコストを線形にスケールしたい場合はペイパートークンを選択します。
- ペアにする：Routing で Coding Plan を Model for all tasks として使用し、サブスクリプションウィンドウを枯渇させるバーストをカバーするため、Developer API キー（または完全に異なるプロバイダー）を Fallback (optional) として使用します。
トラブルシューティング
Test 後の 401 — キーがエンドポイントと一致しない
Test 後の 401 — キーがエンドポイントと一致しない
- Coding Plan キーは
/api/anthropicと/api/coding/paas/v4で動作し、/api/paas/v4/では動作しません。Developer API キーは/api/paas/v4/を使用します。 - Z.ai タイルは常に
https://api.z.ai/api/anthropicを使用します。キーが別のエンドポイントでのみ有効な場合は、その Base URL を指定して OpenAI-compatible 経由で接続してください。 - OpenAI-compatible では、Base URL がキーの出所と一致することを確認してください。
レビュー時の 'Too much concurrency'
レビュー時の 'Too much concurrency'
- Lite および Pro Coding Plan ティアは通常、1 concurrent リクエストのみを許可します。Max concurrent requests を
1に設定し、Max でのみ上げてください。 - まだ 429 にヒットしている場合は、Advanced settings で Max concurrent requests を下げます。
Coding Plan でクォータ枯渇
Coding Plan でクォータ枯渇
- クォータは5時間ローリングウィンドウと週次ウィンドウで適用されます。どちらかに達すると HTTP 429 を返します。
- Z.AI コンソールで残りのクォータを確認します。
- オプション：次のウィンドウを待つ、より高いティアにアップグレードする、またはギャップをカバーするために Developer API キーを Routing の Fallback (optional) モデルとして設定する。
モデルが見つからない
モデルが見つからない
- モデル ID が Z.AI のカタログと一致していることを確認します（
glm-5.1、glm-5-turbo、glm-5、glm-4.5、glm-4.5-air）。 - Coding Plan は現在 GLM ファミリーのみをカバーしています — GLM 以外のモデル名は拒否されます。
接続エラー（タイムアウト、DNS）
接続エラー（タイムアウト、DNS）
- サーバーが
api.z.aiに到達できることを確認します。 - API とワーカーのログで正確な上流エラーを確認します。
- アウトバウンドトラフィックが制限されているリージョンにいる場合は、インフラが許可するリバースプロキシを通じてリクエストをルーティングします。