3行でいうと

  • 公式の手順は、Z.AI Open Platform に登録またはログインし、用途に合う種類の APIキー を作る、が最初の一歩です。キーは「Standard API Key」（従量課金）と、Coding Plan 用（個人は Personal Coding Plan、チームは Team Coding Plan）で別物です。
  • Coding Plan の接続先（ベースURL）は、通常の API とは別です。公式は、接続先を間違えると Coding Plan の枠が使えない、と警告しています。
  • Claude Code への組み込みは、公式が3通り（自動スクリプト、手で ~/.claude/settings.json を書く、Coding Tool Helper）を挙げています。自動スクリプトは macOS と Linux だけです。
  • チャット（chat.z.ai）の入り方（ログイン方法、アプリの有無）は、公式の資料では確認できていません。この記事では、読めた範囲だけを書きます。
  • 公式ページの画面名（ボタンの表記など）は、公式が書いている範囲だけを写しています。書かれていない画面経路は「確認できていない」と書きます。

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者は GLM を入れていますが、使い心地はこの記事には書いていません。手順は「公式の手順を順に並べたもの」で、設定例は「公式の例の写し」か「公式の記載に合わせて、この記事で組んだ例（動作は確かめていません）」と、そのつど区別します。公式ページは要約の形で取得しているため、コマンドや設定ファイルの中身は、実行する前に公式ページの原文と見比べてください。画面の表記は変わるので、手元の画面と照らして読んでください。

先に結論

前提：用語をそろえる

たとえ話：鍵と玄関を間違えない

GLM を「ひとつの建物」とすると、玄関が複数あり（API、Coding Plan、チャット）、玄関ごとに鍵が違います。鍵（キー）を別の玄関に差しても開かず、場合によっては別の会計（残高）から引かれます。これは僕らのたとえで、公式の表現ではありません。

手順0：全体の流れ

段階 やること 必要なもの この記事の節
1 Z.AI Open Platform に登録またはログイン メールなど（登録画面の中身は公式が説明していない） 手順1
2a 通常のAPIを使う：残高を足し、Standard API Key を作る 課金の方法 手順2
2b Coding Plan を使う：プランを購入し、Coding Plan 用のキーを作る 購入の方法 手順3
3 Node.js など、ツールの土台を入れる OS ごとの前提 手順4
4 ツール（例：Claude Code）を入れて、キーと接続先を設定する キー、ベースURL 手順5〜7
5 つながったか確かめる 小さな依頼 手順8

手順1：アカウントを作る（Z.AI Open Platform）

公式の「Quick Start」と「GLM Coding Plan Quick Start」は、最初に「Z.AI Open Platform に登録またはログインする」と書いています。リンク先は https://z.ai/model-api です。

  1. ブラウザで https://z.ai/model-api を開く。
  2. 登録またはログインする。
  3. 公式のページは、登録の画面の中身（入力項目、確認メールの有無など）を説明していません。画面の表示に従ってください。

チャット（chat.z.ai）との関係。 公式の資料では、Open Platform（APIとキーの管理）とチャット（chat.z.ai）のアカウントが同じかどうかは、確認できていません。01で触れたとおり、プライバシーポリシーには、GoogleまたはGitHubでログインするとアクセストークンを受け取る、メールアドレスとパスワードもアカウント情報に挙がる、とあります。どのログイン方法がどの画面で出るかは、公式の資料では確認できていません。

手順2：通常のAPIを使う場合（Standard API Key）

公式の「Quick Start」が書く順番です。

  1. （必要なら）課金のページ（Billing Page、https://z.ai/manage-apikey/billing）で残高を足す。
  2. APIキーのページ（https://z.ai/manage-apikey/apikey-list）で、Standard API Key を作る。公式は、ボタンの表記までは書いていません。
  3. 作ったキーをコピーして、リクエストに使う。

期待される結果。 キーの一覧に、新しいキーが載ります（公式がこの画面の見た目を説明していないので、手元の画面で確かめてください）。

接続先は次のとおりです（公式の表記）。

用途 URL
チャット補完（HTTP） https://api.z.ai/api/paas/v4/chat/completions
OpenAI互換のベースURL https://api.z.ai/api/paas/v4/

モデル名は glm-5.3 が公式の例に出ます。公式は、Coding Plan を使うなら別の専用の接続先を設定するように、と警告しています（手順3）。実際に呼んでみる手順は06で扱います。

手順3：GLM Coding Plan を使う場合

公式の「GLM Coding Plan Quick Start」の順番です。

  1. Z.AI Open Platform にログインする（手順1）。
  2. 「GLM Coding Plan」のページ（購入ページ）を開き、希望のプランを選ぶ。公式のこの文書は、支払いの手順やプランの中身を説明していません。購入ページ（z.ai/subscribe）の価格表は、この記事では読めていません。料金・解約は04を参照してください。
  3. Coding Plan 用のキーを作る。
  4. 個人（Individual Plan。トライアルのカードを受け取った人も含む）：Personal Coding Plan > Plan Overview（キー一覧のページ https://z.ai/manage-apikey/apikey-list）。
  5. チーム（Team Plan）：Team Coding Plan > My Plan（https://z.ai/manage-apikey/coding-plan/team/my-plan）。
  6. キーを作るボタンの名前は、公式のこの文書に書かれていません。
  7. 使うツールを選び、そのツールの設定ガイドに従う（対応ツールは07）。
  8. 接続先を、ツールのプロトコルに合わせて設定する。
プロトコル ベースURL（公式の表記）
Anthropic Messages 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

キーの種類（2026年10月16日からの管理）。 公式の「API Key Management Guide」は、次の3種類を挙げています。

キー 使い道 課金
Standard API Key 従量課金や利用枠（bundle） アカウント残高か bundle。Coding Plan の枠は使わない
API Key（Personal Coding Plan） 個人プランの利用 個人プランの枠
Team Plan Key チームプランの利用 チームプランと席の規則

手順4：土台を入れる（OS ごと）

公式の Claude Code と Codex、Coding Tool Helper のページが挙げている前提です。

項目 公式の記載 出どころ
Node.js 18 以上 Claude Code、Codex、Coding Tool Helper のページ
macOS Node.js は nvm で入れる。パッケージを直接入れると、権限の問題が出ることがある、と公式が書く Claude Code、Codex のページ
Windows Git for Windows も入れる（Claude Code のページ） Claude Code のページ
Vision MCP を使うなら Node.js 22.0.0 以上 Vision MCP のページ（08） 
node -v
npx -v

手順5：Claude Code を入れる（公式の手順）

公式の「Claude Code の設定」ページは、最初に次の3行を示しています。

npm install -g @anthropic-ai/claude-code
cd your-awesome-project
claude

your-awesome-project は、作業するフォルダの名前に置き換える例です。Claude Code そのものの提供元は Anthropic で、Z.ai ではありません。Claude Code の入れ方の最新の情報は、Anthropic の公式ページで確かめてください（この記事では、Anthropic 側のページは読んでいません）。

手順6：Claude Code に GLM を設定する（3通り）

公式のページは、設定を3つの方法で示しています。どれも、書き込み先は ~/.claude/settings.json です。Windows では %USERPROFILE%\.claude\settings.json、Linux と WSL では ~/.claude/settings.json です（「How to Switch Models」ページ）。

方法A：自動スクリプト（macOS と Linux だけ）

公式は、cdn.bigmodel.cn に置かれたスクリプト claude_code_zai_env.sh を、ダウンロードして実行する形を案内しています。公式は「Windows は対応していない」と書いています。

方法B：手で書く（macOS、Linux、Windows）

公式の例の写しです（取得は要約を経由しているため、原文と見比べてください）。your_zai_api_key は、あなたのキーに置き換える例です。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.3-flash[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.3[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.3[1m]",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "API_TIMEOUT_MS": "3000000"
  }
}
  1. 既存の settings.json がある場合、ファイルを丸ごと置き換えない。「How to Switch Models」ページは「Do not replace the entire file」（既に他の項目があるときは、示された項目だけを足すか直す）と書いています。既に env があるなら、その中に項目を足すか、値を書き換えます。
  2. 保存したら、すべての Claude Code の窓を閉じ、新しいターミナルを開いて claude を起動する（公式のFAQの内容）。

表のとおり、各項目の意味は次のとおりです。

項目 公式が書く役割（読めた範囲）
ANTHROPIC_AUTH_TOKEN Z.ai のキー
ANTHROPIC_BASE_URL Anthropic 形式の接続先
ANTHROPIC_DEFAULT_HAIKU_MODEL、..._SONNET_MODEL、..._OPUS_MODEL Claude Code のモデルの枠に GLM を割り当てる
CLAUDE_CODE_AUTO_COMPACT_WINDOW 「How to Switch Models」ページが「圧縮の窓」と説明（[1m] の接尾辞は 1M の文脈を有効にする、と同ページに書かれている）
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 意味は公式の GLM のページに説明がありません
API_TIMEOUT_MS 応答を待つ時間（ミリ秒）。意味の説明は、読んだ範囲では見つかりませんでした

ページの間の食い違い。 「Claude Code の設定」ページの中で、手順の本文は「3つの枠すべてに GLM-5.3-Flash」と書き、手動の設定例は SONNET と OPUS に glm-5.3[1m]、HAIKU に glm-5.3-flash[1m] を入れています。さらに「How to Switch Models」ページの例は、3つとも glm-5.3-flash[1m] です。公式はどれが優先かを説明していません。どれを入れるかは、公式ページと見比べて自分で決めてください。

方法C：Coding Tool Helper

次の節で扱います。

手順7：Coding Tool Helper で進める（公式の補助ツール）

npm パッケージ @z_ai/coding-helper です。公式のページによると、対応ツールは Claude Code、Codex、OpenCode、Crush、Factory Droid、必要な Node.js は 18 以上です。

実行方法は2つです。

npx @z_ai/coding-helper

npm install -g @z_ai/coding-helper
coding-helper

後者のあとは、coding-helper か chelper で起動する、と公式は書いています。公式のページは、前者（npx）を「Method 1」、後者を「Method 2（頻繁に使う場合）」と並べています。グローバルに入れるときに権限エラーが出たら、macOS／Linux では sudo、Windows では管理者として端末を開く、と案内されていますが、同じページが「sudo は権限を高める」と警告し、npx を代替に挙げています。

対話の流れ（矢印キーで選び、Enter で決める）。 公式の9段階は次のとおりです。

  1. 画面の言語を選ぶ
  2. コーディングプランを選ぶ
  3. APIキーを入れる
  4. 管理するツールを選ぶ
  5. 必要ならツールを自動で入れる
  6. ツール管理のメニューを開く
  7. プランをツールに読み込む
  8. MCPサービスを管理する（任意）
  9. 設定を終えて、ツールを起動する

サブコマンド（公式の一覧）。

コマンド 意味
coding-helper init 初期設定の対話を始める
coding-helper lang show／lang set en_US 表示言語の確認・変更
coding-helper auth キーを対話で設定
coding-helper auth glm_coding_plan_global <token> Global のプランを選んで、キーを直接設定
coding-helper auth revoke 保存したキーを消す
coding-helper auth reload claude 最新のプランを Claude Code に読み込む
coding-helper doctor 設定とツールの状態を診断

手順8：つながったか確かめる

公式が書く確かめ方は、ツールごとに違います。

Claude Code。

  1. 新しいターミナルで、作業フォルダに移り、claude を起動する。
  2. 「Do you want to use this API key」と聞かれたら、Yes を選ぶ（公式の記述）。
  3. フォルダへのファイルアクセスを許可する。
  4. バージョンを確かめる。公式は 2.0.14 で確認した、と書き、最新版にするよう案内しています。
claude --version
claude update
  1. 起動したら、/status を実行し、設定の出どころが settings.json で、モデルが glm-5.3-flash か glm-5.3-flash[1m] になっているかを見る（「How to Switch Models」ページ）。ページの例のとおりなら、という前提で、手元の表示と照らしてください。
  2. /effort で考える強さを選べます。公式は、初期値が max で、コーディングの作業にはこれが recommended と書いています（公式の表記）。

Coding Tool Helper。 coding-helper doctor が、設定とツールの状態を点検します。

公式が書く「成功の合図」。 Claude Code のページに、専用の確認コマンドはありません。「GLM のモデルが応答する」ことが実際の確認、と読めます。最初の依頼の例は06に並べます。

手順9：ほかのツールの入口（概要。詳細は07）

公式がツールごとに別ページを用意しています。ここでは、最初にやることだけを表にします。詳しい設定値は07を見てください。

ツール 最初にやること（公式の記載） 詳細
Cline VS Code の拡張機能で「cline」を検索して入れる。「Use your own API Key」を選び、API Provider を「OpenAI Compatible」にする 07
Cursor Models から「Add Custom Model」を押す。OpenAI Protocol を選ぶ 07
OpenCode opencode auth login で「Z.AI Coding Plan」を選ぶ 07
Crush crush を起動し、モデルの選択画面で Z.AI のキーを入れる 07
Goose 「Create New Provider」で「Anthropic Compatible」を選ぶ 07
Roo Code／Kilo Code VS Code の拡張機能で入れ、API Provider を「Z AI」にする 07
Codex 設定ファイル ~/.codex/config.toml を作る 07
Droid 設定ファイル ~/.factory/settings.json に custom model を足す 07
ZCode 公式の GitHub の README に従う（Z.ai のプロバイダの設定手順は README に書かれていない） 07

手順10：チャット（chat.z.ai）を使い始める

読めた範囲を、そのまま書きます。

したがって、この記事は、チャットの画面操作の手順（どのボタンを押すか）を書きません。画面に出る案内に従ってください。

つまずきと直し方

公式の記載（FAQ、各ページのトラブルシューティング）から拾えたものです。

症状 公式が挙げる確認点 出どころ
Coding Plan を買ったのに、エラー 1113「Insufficient Balance」 ①対応していないツールを使っている ②ベースURLが違う（Claude Code と Goose は https://api.z.ai/api/anthropic、他のツールは https://api.z.ai/api/coding/paas/v4）③対応していないモデルを呼んでいる（呼べるのは GLM-5.3 と GLM-5.3-Flash） Coding Plan の FAQ
買ったあとも残高が引かれる 同じ設定の確認。対応ツールの中の呼び出しは、プランの枠だけを使い、残高から引かない、とある Coding Plan の FAQ
手で書いた設定が効かない（Claude Code） すべての窓を閉じ、新しいターミナルで claude を起動し直す Claude Code のページ
それでも動かない（Claude Code） ~/.claude/settings.json を削除して、設定し直す（Claude Code が新しいファイルを作る） Claude Code のページ
JSON のエラー 項目名、カンマの過不足を確かめる。JSON の検証ツールを使う Claude Code のページ
[1m] のモデルが存在しない、と出る Claude Code を更新する How to Switch Models
EACCES: permission denied（グローバル導入） sudo、管理者として実行、npx の利用、nvm のいずれか（公式が並べる） Coding Tool Helper のページ
キーが無効と言われる キーの写し間違い、残高、キーの種類（Standard か Coding Plan か） 各ページ
枠が尽きた 次の5時間の周期を待つ。プラン外のAPI呼び出しはできない、とある Coding Plan の FAQ
Claude Code 側のマーケットプレイスの表示がおかしい claude update で 2.0.70 以上にする Coding Tool Helper のページ

ページ間のモデル名の食い違い。 Coding Plan の FAQ は、呼べるのは GLM-5.3 と GLM-5.3-Flash だけ、と書き、概要ページは GLM-5.2 と GLM-5.1 の呼び出しは GLM-5.3 に回される、と書いています。一方、Cline、Cursor、Droid のページは、例として glm-5.2 や GLM-5.2 と書いています。公式がこの違いを説明しているかは、確認できていません。

この記事の案：入れる順番（見立て）

ここは、公式の手順ではなく、この記事の案です。

  1. 先に、使う入口を決める。API だけ使うなら手順1・2、コーディングのツールで使うなら手順1・3。
  2. 土台（Node.js）の版を確かめる（手順4）。
  3. ツールを1つだけ選び、公式のそのツールのページに従う。
  4. キーを作る前に、どの種類のキーが要るか、公式の表（手順3）で確かめる。
  5. 最初の依頼は短くする（06）。

気をつけること

出典