3行でいうと
- 公式が用意する接続先は、プロトコルごとに3つあります。通常のAPIは
https://api.z.ai/api/paas/v4/（OpenAI互換）。Coding Plan 用は、Anthropic 形式がhttps://api.z.ai/api/anthropic、OpenAI Chat Completions 形式がhttps://api.z.ai/api/coding/paas/v4、OpenAI Responses 形式がhttps://api.z.ai/api/v1です。 - 接続先を間違えると、Coding Plan の枠を使えません。公式は、通常の接続先に変えると、枠が残っていても残高から引かれることがある、と書いています。
- Z.ai が運営するもの：API、公式のSDK、Coding Tool Helper、4つのMCPサーバー、ZCode（コーディングのツール）。第三者のもの：Claude Code、Cline、Cursor、Codex など、GLM を入れて使うツールそのものです。
- 第三者のツールに GLM を入れると、そのリクエストは、api.z.ai に送られます。Z.ai の利用規約とプライバシーポリシーが関わります。ツールの提供元のポリシーだけでは決まりません。
- モデルのファイルを自分のコンピューターで動かす道もあります。その場合、入力は外に出ません（公式が明言しているわけではなく、仕組みからの見立てです）。
この記事は、公式の資料を2026年10月23日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はGLMを入れていますが、使い心地はこの記事には書いていません。公式ページは要約の形で取得したため、読み切れていない所は「公式の資料では確認できていない」と書いています。コマンドや設定名は公式の表記のとおりです。
先に結論
- つなぎ方は、3系統。 ①プログラムからAPIで呼ぶ、②Coding Plan で、対応しているコーディング用のツールに入れる、③モデルのファイルを自分で動かす、です。
- Coding Plan のツールは、公式が「対応」と挙げたものだけ。 公式は、対応外のツールで使うと、特典が制限されることがあると書いています。アカウントの共有も禁止です。
- MCPサーバーは、Coding Plan 向け。 公式は4つ（Vision、Web Search、Web Reader、Zread）を挙げ、使うにはCoding Planのキーが要ると読めます。
- キーの扱いに注意。 設定ファイルにキーを書く形が多いので、公開リポジトリに入れないでください。公式も、キーを秘密にし、コードに直接書かないよう案内しています。
前提：用語をそろえる
- エンドポイント／ベースURL：APIの接続先のアドレス。ツールの設定欄に入れます。
- プロトコル：リクエストの書式。公式は、OpenAI の Chat Completions、OpenAI の Responses、Anthropic の Messages の3つを挙げています。
- MCPサーバー：AIのツールに、画像の分析やウェブ検索などの機能を足す、小さなサービス。
- API キー：あなた専用の合言葉。公式は、Standard API Key、Individual Plan のキー、Team Plan のキーに分けています。
- ハーネス（harness）：モデルを包んで、ファイルの読み書きなどのツールを持たせる外側の仕組み。公式のGitHubは ZCode を「coding agent harness」と呼んでいます。
たとえ話：コンセントと変換プラグ
GLM を発電所だと思ってください。ツール（Claude Code など）は、元々は別の発電所のコンセントの形をしています。公式は、OpenAI 形式と Anthropic 形式の2種類の変換プラグ（接続先）を用意して、「プラグを差し替えれば、別の発電所の電気で動く」ようにしています。ただし、電気が通る先は、あなたのツールの持ち主の発電所ではなく、Z.ai のものになります。これは僕らのたとえで、公式の表現ではありません。
系統1：プログラムからAPIで呼ぶ（公式が運営）
- OpenAI互換。 ベースURLは
https://api.z.ai/api/paas/v4/。OpenAI の Python SDK なら、base_urlを差し替えるだけで使える、と公式は書いています（公式は、一部の動作が OpenAI と違うことも書いています）。 - 公式のSDK。 Python は
pip install zai-sdk、Java はai.z.openapi:zai-sdk。GitHub の公開リポジトリの有無は、組織ページの一覧では確認できませんでした。 - 通常のAPIは、従量課金。 キーは Standard API Key です。
- LangChain との連携の文書。 公式の目次に「LangChain Integration」のページがありますが、中身は読めていません。
系統2：GLM Coding Plan で、コーディング用のツールに入れる
公式が一覧にしているツール
公式の「Tool Integration」のページは、ツールを2つに分けています。
| 区分 | 公式の一覧 | 備考 | 確かさ |
|---|---|---|---|
| コーディング用 | ZCode、Claude Code、Claude for IDE、Codex、OpenCode、Pi、Cursor、Cline、TRAE、Qoder、Droid、Kilo Code、Roo Code、Crush、Goose、Eigent | ZCode には「1.5× Usage」の表示がある | 文書に書かれている |
| 汎用のエージェント | AutoClaw、OpenClaw、Hermes Agent、SillyTavern | AutoClaw には「1.5× Usage」の表示がある。公式は、汎用のツールは「ベストエフォート」で、混んでいると制限されることがある、と書いている | 文書に書かれている |
このうち、ZCode は Z.ai 側のツールです（公式のGitHubに ZCode のリポジトリがあります）。AutoClaw にも ZCode と同じ「1.5× Usage」の表示がありますが、提供元は読めていません。ほかは、第三者のツールと考えられます。第三者のツールの提供元と Z.ai は、別です。
設定の流れ（公式の共通の説明）
- ツールに合うプロトコルを選ぶ（Anthropic 形式か、OpenAI Chat Completions 形式）。
- 対応するベースURLを入れる。
- APIキーを入れて、GLM のモデルを選ぶ。
Claude Code の場合、公式の手順は、~/.claude/settings.json の env に次の項目を書く形です。
ANTHROPIC_AUTH_TOKEN（あなたのZ.aiのキー）ANTHROPIC_BASE_URL（https://api.z.ai/api/anthropic）API_TIMEOUT_MS
手動の設定では、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL で、Claude Code が使うモデル名の枠に GLM を割り当てます。公式の例では、SONNET と OPUS に glm-5.3[1m]、HAIKU に glm-5.3-flash[1m] です。自動の設定のスクリプトは、macOS と Linux だけで、Windows は対象外と書かれています。公式は、Claude Code 2.0.14 での確認と、最新版の利用を勧めています。
Cline の個別の手順ページは、今回は読めていません。公式の共通の説明（プロトコルを選び、ベースURLとキーを入れる）に沿って、ツールの設定画面の表示で確かめてください。
Coding Tool Helper（公式が運営）
npm のパッケージ @z_ai/coding-helper です。npx @z_ai/coding-helper で、ツールの検出、インストール、プランの読み込み、MCPの管理、doctor（診断）を、対話で進められます。対応は、Claude Code、Codex、OpenCode、Crush、Factory Droid です。どの設定ファイルを書き換えるかは、公式のページに書かれていません（読んだ範囲では見つかりませんでした）。使う前に、パッケージの文書やソースを確認してください。
MCPサーバー（公式が運営）
| 名前 | 何をするか | 動く場所 | 確かさ |
|---|---|---|---|
| Vision MCP Server | 画像の分析と動画の説明。Node.js v22以上が必要。コマンドは npx -y "@z_ai/mcp-server" |
自分のコンピューター（ローカル）。画像の分析そのものを、どこで処理するかは、公式のページに書かれていない | 文書に書かれている |
| Web Search MCP Server | ウェブ検索。ツール名は webSearchPrime |
リモート（https://api.z.ai/api/mcp/web_search_prime/mcp） |
文書に書かれている |
| Web Reader MCP Server | URLからページの本文などを取り出す。ツール名は webReader |
リモート（https://api.z.ai/api/mcp/web_reader/mcp） |
文書に書かれている |
| Zread MCP Server | 公開のGitHubリポジトリの文書、構造、ファイルを読む。ツール名は search_doc、get_repo_structure、read_file |
リモート（https://api.z.ai/api/mcp/zread/mcp） |
文書に書かれている |
- Goose は、Web Search、Web Reader、Zread の3つについて「対応していない」と書かれています。
- 4つとも、使える量は、Coding Plan の概要ページの「MCP Usage Limits」を見るよう案内されています。各MCPのページには回数の上限の数字がなく、概要ページにも、同名の節の本文は見つけられませんでした。概要ページの倍率表では、Web Search、Web Reader、Zread は1回あたり1.2 credits、Vision は GLM-5.3-Flash の消費に含まれる、と書かれています（消費する枠の数え方であり、回数の上限そのものではありません）。
- 古い Cline 向けには、SSE の別URLがあり、キーを URL の末尾に付ける形です。キーがログに残りやすいので、公式の手順でも注意が要ります。
- Vision MCP は、画像をチャットに直接貼ると、多くのツールではこのサーバーを通らず、モデルに直接送られる、と書かれています。画像はファイルとして保存し、パスを指定する方法が勧められています。
ZCode と、公式のGitHub（公式が運営）
- GitHub の zai-org に、ZCode があります。説明は「Z.ai's coding agent harness」。デスクトップ、ブラウザ、ターミナルの3つの形です。ライセンスは Apache-2.0 と表示されています。
- zcode-plugins は、「公式とコミュニティのプラグインのマーケットプレイス」と説明されています。つまり、中には、コミュニティ製のものが混じります。入れる前に、作者と中身を確かめてください。
- ZCode の README は、データは
.zcode/の下に書かれる、と説明しています。データのリスクは NOTICE.md を見るよう案内していますが、その中身は読めていません。
系統3：モデルのファイルを自分で動かす（オープンウェイト）
- 公式のGLM-5.3のカードは、vLLM と SGLang での起動例（
vllm serve "zai-org/GLM-5.3"など）、Transformers、KTransformers、Unsloth、Docker Model Runner、Ascend NPU での展開を挙げています。llama.cpp、Ollama、LM Studio 向けの量子化版（モデルを小さくした版）もある、と書かれています。リンク先は Hugging Face 上の量子化版の一覧（88件の表示）です。誰が作っているかはカードでは確認できないため、第三者製の可能性を踏まえて、作者と中身を確かめて使ってください。 - GLM-5.3 は 753B（7530億）のパラメータで、ふつうの家庭のパソコンには大きすぎます。軽い GLM-5.3-Flash（公式のページは約320B、18B 稼働と記載）も、同じく大きいほうです。
- 自分で動かす場合、入力は、あなたの環境の中で処理されます。Z.ai のサーバーには送られないと考えるのが自然ですが、公式がそう明言しているかは、読んだ範囲では確認できていません。
公式が運営するものと、第三者のもの
| 区分 | 例 | 誰のルールが適用されるか |
|---|---|---|
| Z.ai が運営 | API、公式SDK、Coding Tool Helper、4つのMCPサーバー、ZCode | Z.ai の利用規約とプライバシーポリシー。Coding Plan は、プランの利用ポリシー |
| 第三者のツール（GLM を入れて使う） | Claude Code、Cline、Cursor、Codex、OpenCode など | そのツールの提供元の規約。ただし、モデルへのリクエストは api.z.ai に届くので、Z.ai の規約も関わる |
| コミュニティ製 | zcode-plugins の中のコミュニティ製プラグイン、そのほか | 作者のもの。公式は「official and community」と混在させて説明している |
| 自分で動かす | vLLM、SGLang、Ollama、LM Studio など | あなたの環境。モデルのライセンスは04で扱う |
データはどこへ流れるか
- API とCoding Plan。 リクエストは、
api.z.aiに届きます。公式のプライバシーポリシーは、サービスは基本的にシンガポールで処理される、と書いています。個人向けの利用規約と、APIの利用者向けの条件で、入力の扱いが違います（04で扱います）。 - 第三者のツールの側。 ツールが、あなたのファイルを読んで、プロンプトに入れて送ります。何を送るかは、ツールの設定次第です。Claude Code の設定例には
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICが登場しますが、公式の GLM の文書は、その意味を説明していません。 - MCP のリモートサーバー。 検索のキーワードや、読み取るURL、GitHub の対象は、Z.ai のサーバーを経由します。保存や共有の扱いは、各MCPのページに書かれていません（読んだ範囲では見つかりませんでした）。
- エクスポート／インポート。 チャットの履歴を書き出す機能については、公式の資料では確認できていません。
今日からできること
- まず、通常のAPIで1回だけ試す。 OpenAI の SDK で、ベースURLを
https://api.z.ai/api/paas/v4/にして、glm-5.3を指定する例が公式にあります。 - Coding Plan を使う前に、キーの種類を確かめる。 Individual Plan のキーは「Personal Coding Plan」の「Plan Overview」、Team Plan は「Team Coding Plan」の「My Plan」にあります。
- MCP は、1つずつ入れる。 各MCPが何に鍵（キー）を使うかを、公式の手順で確かめます。
気をつけること
- ツールの設定で、ベースURLを間違えると、枠を使えなかったり、残高から引かれたりします。公式が警告しています。
- Z.ai の文書は更新が速く、モデルの名前や、手順の細部が変わります。Claude Code の設定の例が、ページによって違う（既定は GLM-5.3-Flash を3つに割り当てる記載、手動の例は GLM-5.3 と Flash の使い分け）点も、公式の文書の中で整理されていません。
- 第三者のツールの規約や、データの扱いは、僕らは読んでいません。それぞれの公式の文書で確かめてください。
- MCP の公式のページに、データの保存や保持の記載は、読んだ範囲では見つかりませんでした。
- 取得できなかったページ：Tool Integration の個別のツールごとのガイド、LangChain のページ、Team Plan のMCP設定は、読めていません。
出典
- Quick Start（Z.AI Developer Document、Z.ai、2026-10-23確認）
- GLM Coding Plan Quick Start（Z.AI Developer Document、Z.ai、2026-10-23確認）
- Tool Integration（GLM Coding Plan、Z.ai、2026-10-23確認）
- Claude Code の設定（GLM Coding Plan、Z.ai、2026-10-23確認）
- Coding Tool Helper（GLM Coding Plan、Z.ai、2026-10-23確認）
- Vision MCP Server（GLM Coding Plan、Z.ai、2026-10-23確認）
- Web Search MCP Server（GLM Coding Plan、Z.ai、2026-10-23確認）
- Web Reader MCP Server（GLM Coding Plan、Z.ai、2026-10-23確認）
- Zread MCP Server（GLM Coding Plan、Z.ai、2026-10-23確認）
- API Key Management Guide（GLM Coding Plan、Z.ai、2026年10月16日付の告知、2026-10-23確認）
- OpenAI Python SDK（Z.AI Developer Document、Z.ai、2026-10-23確認）
- Z.ai Developer Document 目次（Z.ai、2026-10-23確認）
- ZCode（GitHub、Z.ai、2026-10-23確認）
- zai-org（GitHub、Z.ai、2026-10-23確認）
- GLM-5.3 モデルカード（Hugging Face、Z.ai、2026-10-23確認）