ZCode：GLM Coding Planの代わりに使える格安GLM推論

ZCodeは「チャットサイドバー付きのエディタ」ではなく、AIエージェントを中心に開発が進行するADEです。目標を記述すると、エージェントが計画を立て、ファイルを修正し、テストを実行し、結果が出るまで反復処理を行います。macOSおよびWindows上のデスクトップアプリとして動作します（Linux版はベータ版）。

バージョン3.0の主な機能：

• ZCode Agent — GLM-5.2と深く統合された専用エージェントコア。他のサードパーティエージェント（Claude Code、Codex、Gemini CLIなど）も追加可能。
• Goalモード (/goal) — 長時間の自律タスク：計画 → 実行 → ステップごとの検証。
• マルチエージェント — プロジェクトに対する複数のエージェントの並列動作。
• リモート操作 — Telegram、WeChat、Feishuからのセッション起動・管理：あなたのマシンでエージェントが作業し、開発者はスマホから質問に応答可能。

クライアント自体は無料であり、新規ユーザーにはGLM-5.2の試用クォータが毎日付与されます。それ以降はSubscription Planか独自のAPIキーの利用となります。ここからが製品の最も議論されている部分であり、詳細を知っておく必要があります。

GLM Coding Planは、ZCodeや20種類以上の外部ツールでGLMモデルへのアクセスを提供するZ.aiのサブスクリプションです。執筆時点（2026年7月）の基本料金は以下の通りです。ただし、価格やキャンペーンは変動するため、z.ai/subscribeで最新状況を確認してください：

ユーザーからの不満点（Hacker NewsおよびGitHubのスレッドより）：

• ピーク時のマルチプライヤー： ピーク時間帯（14:00〜18:00 UTC+8 — アジアの夜、欧州の朝〜昼）には、クォータ消費が3倍、それ以外でも2倍になります。北京標準時ベースで消費を計算する必要があります。
• 「トークン」ではなく「プロンプト」によるクォータ計算： 残りのトークン数が不明瞭です。スレッドでは「GLMで約17Mトークン使用した後、4日間の利用制限を受けた」といった報告が見られます。
• LiteおよびProでの同時リクエスト数： エージェント環境では大きな制約となり、ZCode独自のマルチエージェントモードや並列サブエージェントがキューの制限に直面します。
• GLM-5.2の高い消費率： フラッグシップモデルを動かすと、独自倍率によりクォータが一気に消費されます。

結論：ソロでの開発であれば通常のサブスクリプションでも十分機能します。しかし、並列タスクや長時間自動セッションなど、より「エージェント的」な使い方をすると、クォータモデルは不確実な宝くじのようなものになります。代替策は使用量に応じた従量課金です。窓際料金や倍率、待ち行列はありません。使用した分だけ払うというモデルです。これはZCodeのcustom provider機能によって実現でき、わずか5分で設定可能です。

ZCodeはBYOKを公式にサポートしています。ドキュメントでは、「OpenAIまたはAnthropicプロトコルと互換性のあるサービス」を追加することが明示的に許可されています（パブリックAPI、企業チャンネル、セルフホストされたインストールなど）。設定方法は以下の3通りです：

• ウェルカム画面のConnectボタン → 「Set Your API Key」
• モデルセレクターのManage Models
• 歯車アイコン → Settings → Model Settings → Add Provider

プロバイダーにOpenAI Base URLやAnthropic Base URL、そしてAPI Keyを指定すれば、ZCodeは自動的に利用可能なモデルリストを取得します。

最もつまずきやすい3つのポイント：

• Z.aiのEndpointは異なります。 Coding Planのサブスクリプションは、コーディング用エンドポイント https://api.z.ai/api/coding/paas/v4 でのみ機能します。サブスクリプションキーを使用して共通の /api/paas/v4 にアクセスするとエラーが返されます。これが「プランを購入済みなのに401/429エラーが出る」という古典的な原因です。
• 「Claude Codeで動作する＝ZCodeで動作する」とは限りません。 Claude Codeを設定するために使用する ANTHROPIC_BASE_URL のような環境変数は、ZCodeでは読み取られません。ZCodeには独自のプロバイダー設定ストレージがあります。必ずSettingsから設定してください。
• 「セレクターにモデルが表示される＝キーにクォータがある」とは限りません。 モデルリストはプロバイダーのAPIから取得されますが、利用可能かどうかは個々のキーの残高と制限に依存します。

次に、実践としてZCodeにJoinGonkaゲートウェイを接続し、トークンベースでGLMスタックを利用する方法を解説します。

JoinGonka Gateway — 2つのネイティブプロトコル（OpenAI互換の /v1/chat/completions および Anthropic Messages /v1/messages）を備えたGonka分散ネットワークへのゲートウェイです。経済モデルはpay-per-token（従量課金）です。5時間枠の制限や3倍のピーク倍率、並列リクエスト制限はありません。消費量はDashboardでリアルタイムに確認でき、プロンプトの内容はゲートウェイには保存されません。

ステップバイステップ（最新のCustom Providerインターフェース）：

ZCodeの古いバージョンでは、上記のかわりにOpenAI Base URL (https://gate.joingonka.ai/v1) と Anthropic Base URL (https://gate.joingonka.ai — パスはクライアントが自動で追加します) という2つの個別のフィールドがあります。

確認方法： 作成したモデルを選択し、エージェントに質問を投げます。回答が来れば動作しています。エラー401の場合はキーを確認し、402の場合はアカウント残高を確認してください。DeepSeek V4 FlashでThought Levelを Max に設定した際に「Model request failed」が表示される場合は、Thought Levelを High に切り替えて再度実行してください。

ヒント： npx @joingonka/setup --tool zcode コマンドを実行すると、以下のフィールド（base URL、キー、最新の制限付きモデルID）に設定すべき値を表示し、ゲートウェイがそれらを受け入れるかをライブクエリで確認できます。ZCodeはUIからのみ設定可能です。安全に編集できる設定ファイルは存在しないため、値は手動で入力する必要があります。

各チャンネルにおける GLM 推論のコスト（100万トークンあたりの価格。競合他社の価格は2026年7月時点のもので、JoinGonka の価格は API ゲートウェイからページへライブで反映されます）：

2～3桁の価格差はマーケティング上の丸めではなく、経済モデルの違いによるものです。計算はデータセンターの利益ではなく、作業自体から収益を得る分散型ネットワークの参加者によって実行されます。この仕組みと適用範囲の詳細については、最も安い AI API についての解説記事をご覧ください。

GLM-5.2 に関する免責事項：ネットワークモデルの正確な価格は、アクティベーションの瞬間にネットワークによって設定されます（上の表は、ネットワークモデルの現在のライブ価格を表示しています）。このページの数値は自動的に更新されるため、手動で再計算する必要はありません。

モデル zai-org/GLM-5.2-FP8 がGonkaネットワークのオンチェーンレジストリに追加されました。設定では最大400Kトークンのコンテキストウィンドウが指定されており、モデル自体は非常に大規模なもの（1レプリカあたり1テラバイト以上のVRAMが必要）です。現在、ネットワークのノードが重みをロード（ウォームアップ）する展開フェーズにあります。チェックが完了すると、モデルはゲートウェイのリストに自動的に表示されます。ベースURLとキーは変更不要で、ZCodeのセレクターから選択するだけで利用可能です。

モデルについて：MITライセンス下のオープンウェイトモデルで、アーキテクチャはMoE、パラメータ数は約750B（トークンあたり約40Bアクティブ）、ネイティブのウィンドウサイズは最大1Mトークンです。Z.aiのデータによると、SWE-bench Proで62.1を記録しGPT-5.5を上回っており、FrontierSWEではClaude Opus 4.8に約1%の差で迫っています。オープンウェイトモデルとしては、コーディング分野でトップクラスの性能です。

よくある質問：

• 新しいモデルの有効化直後に429エラーが出るのはなぜですか？ — 展開フェーズであり、一部のノードがまだウェイトをロード中のためです。数秒後に再度リクエストを送信してください。ロードバランサーが稼働中のノードを見つけます。
• 今日利用可能なモデルは何ですか？ — Kimi K2.6、MiniMax M2.7、DeepSeek V4 Flashです。これら3つのモデルはすべてZCodeで同じカスタムプロバイダーを通じて動作し、このガイドの設定がそのまま使用可能です。
• プライバシーはどうなっていますか？ — ゲートウェイはプロンプトや回答の内容を保存しません。統計には消費量のみが記録されます。
• Coding Planの方がお得な場合はありますか？ — ソロで作業しており、Liteクォータ内に収まり、並列エージェントを実行しない場合は、定額のサブスクリプションの方が便利で予測可能です。ご自身の利用プロファイルに合わせて計算してください。活発なエージェント作業を行う場合、ネットワークを介したトークン支払いは大幅に安くなりますが、1日に数回程度の軽いコード修正であれば差は感じられないかもしれません。
• 他のツールでも利用できますか？ — はい。同じエンドポイントがClaude Code、Cursor、Cline、およびその他のOpenAI/Anthropic互換クライアントで動作します。