Claude Code LLMゲートウェイを会社に展開する5ステップ

この記事の要点
- 展開は5ステップ。モデルの経路確認、1人1つの鍵の発行、手元での試験、管理設定での配布、開発者のパソコンでの確認
- 窓口は、応答を細切れのまま通す・ヘッダーと本文を変えない・エラーを加工しない、の条件を満たす必要がある
- 配るのは ANTHROPIC_BASE_URL と認証の2つが基本。管理設定の env に入れれば、本人は何も設定しなくてよい
活用例:会社のゲートウェイ経由で Claude Code を全員に配る
- 部署
- 情報システム
- 使うもの
- LLMゲートウェイと Claude Code の管理設定
- AIに任せる
- 試験リクエストの実行・ログの読み取り
- 人が決める
- 鍵の発行方針・配るモデルの範囲・配布の時期
LLMゲートウェイは、会社が Claude Code とAIの間に置く窓口です。使う側の設定は LLMゲートウェイ接続 の記事にあります。この記事は、配る側(管理者)の手順です。
公式ドキュメント「Roll out an LLM gateway for your organization」(2026年11月18日確認)にもとづき、5ステップと、窓口に必要な条件をまとめます。窓口の製品そのものの作り方は、この手順の範囲外です。
結論:5つのステップを、確認つきで進める
- モデルの経路を確かめる
- 開発者ごとに鍵を発行する
- 手元で Claude Code を試す
- 住所と鍵を配る
- 開発者のパソコンから確認する
各ステップに「確認の目印」があり、失敗した時にどの鍵が悪いかを切り分けられます。鍵は3種類あります。
| 鍵 | 持つ人 | 役割 |
|---|---|---|
| 提供元の鍵 | ゲートウェイ | 上流(AIの提供元)へ転送する時に使う。クライアントには出てこない |
| ゲートウェイの管理用の鍵 | 管理者 | 試験や管理画面用(無い製品もある) |
| 開発者の鍵 | 各開発者 | ゲートウェイが開発者ごとに発行する |
始める前の条件
窓口に必要な条件は6つです。
- 対応するAPIの形式で受ける:多くは Anthropic の Messages API(POST /v1/messages)
- 応答を細切れのまま流す:まとめてためてから返すと止まったように見える。接続維持の信号も通す
- Claude のモデル名を振り分ける:開発者が使う名前ごとに、上流のモデルへ対応づける
- ヘッダーと本文を変えずに通す:anthropic-beta や anthropic-version が消えると、対応する機能が使えなくなる
- 上流のエラーをそのまま返す:Claude Code の自動回復は、エラー文の言い回しを見て動く。窓口独自の形に包むと働かない
- 本文を調べる防御(WAF)の対象から外す:プログラムの文字列やタグが攻撃と間違われ、本物の作業だけが 403 で止まる。短い試験では気づけない
窓口は、転送(リダイレクト)の先ではなく、配る住所そのもので HTTPS を受けるようにします。転送で本文や鍵のヘッダーが落ちることがあるためです。
ステップ1:モデルの経路を確かめる
最小のリクエストを、配るモデル名ごとに送ります。
- 200 で content が返れば、その名前で提供元まで届いている
- 404 なら、その名前が窓口で振り分けられていない
- 提供元から 401 が返るなら、窓口が持つ提供元の鍵が間違い
配るモデル名は、1つずつ全部試します。 振り分けていない名前は、選んだ人にだけ 404 が出ます。
ステップ2:開発者ごとに鍵を発行する
開発者ごとに別の鍵を発行します。共有の鍵にしないのが重要です。1人ずつの利用量の把握と、退職時の個別の停止ができなくなるためです。
発行したら、ステップ1と同じリクエストで、新しい鍵が通るかを確かめます。ステップ1が通ったのにここで 401 なら、開発者の鍵が間違っているか、窓口にまだ反映されていません。
どの環境変数に鍵を入れるかは、窓口が見るヘッダーで決まります。
- Authorization の Bearer で見る窓口:ANTHROPIC_AUTH_TOKEN
- x-api-key で見る窓口:ANTHROPIC_API_KEY
ステップ3:手元で Claude Code を試す
配る前に、自分のパソコンで、配る設定と同じ内容を試します。ターミナルに直接入力するので、閉じれば元に戻ります。住所は ANTHROPIC_BASE_URL、鍵は上の変数に入れて、次を実行します。
claude -p "Reply with one word: connected"
返事が返り、窓口のログに /v1/messages への POST(状態 200)が残れば成功です。パスだけで見ます(末尾に ?beta=true などが付くため)。
- Not logged in でログが空:鍵がセッションに届いていない。入力したシェルで試し直す
- 窓口が x-api-key の 401 を返す:変数の種類が違う。ANTHROPIC_API_KEY に替える
- 提供元から 401:窓口が持つ提供元の鍵が間違い
- 何も出ずに数分止まる:住所が違うと、再接続を繰り返す。待たずに窓口のログを見る
ステップ4:住所と鍵を配る
配るのは、基本は2つです。
| 設定 | 役割 | 入れる時 |
|---|---|---|
| ANTHROPIC_BASE_URL | 窓口の住所 | 必ず |
| apiKeyHelper か、認証の変数 | 窓口への認証 | 必ず(どれか1つ) |
| ANTHROPIC_CUSTOM_HEADERS | 追加のヘッダー | 窓口が毎回の指定を求める時 |
| CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY | 窓口の /v1/models からモデル一覧を作る | 窓口が対応している時 |
| ANTHROPIC_MODEL など | 要求するモデル名の指定 | 窓口の名前が既定と違う時 |
管理設定の env に入れて、MDM(端末の一括管理)などで配ると、開発者は何も設定しません。管理設定の ANTHROPIC_BASE_URL は、本人のシェルでの設定に上書きされません。
{
"env": {
"ANTHROPIC_BASE_URL": "https://llm-gateway.example.com"
},
"apiKeyHelper": "/usr/local/bin/get-gateway-key"
}
鍵は、apiKeyHelper(鍵を取るコマンド)を1つ配る方法が使えます。コマンドが、本人として鍵の保管庫に問い合わせるので、端末ごとに別の鍵になります。
注意すること
- forceLoginMethod などを一緒に入れない:ゲートウェイの鍵と同時に入れると、起動時に鍵が拒否され、先へ進めなくなる
- サーバー管理の設定は届かない:Anthropic に直接つなぐ必要があるため、ゲートウェイ経由のセッションには届かない。ファイル形式の管理設定を使う
- デスクトップアプリは別の設定:ゲートウェイ向けの設定ファイルを、MDM で別に配る
- CI は実行環境に設定する:ランナーの環境変数に、住所と鍵を入れる
- ゲートウェイ経由は HIPAA の設定の対象外:機能の制限は、管理設定のキーで別に行う
管理設定を使えない場合は、住所・個人の鍵・どの変数に入れるかを、本人へ伝えます。変数の種類を伝えるだけで、試行錯誤が減ります。
ステップ5:開発者のパソコンから確認する
窓口の機械ではなく、開発者が使う経路から確かめます。
- ストリーミングのリクエストを送り、データが少しずつ届くか見る。まとめて届くなら窓口がためている
- claude を起動し、ログイン画面が出ないか見る
- /status の Status タブで、Anthropic base URL の行に窓口の住所が出るか、Setting sources に管理設定が含まれるかを見る
- 窓口のログで、鍵が誰か、session-id のヘッダーでセッションがまとまるかを見る
ログイン画面が出る、または Anthropic base URL の行が無いなら、設定が端末に届いていません。
会社での進め方の例
- 1つのモデル名と、数人の鍵で、ステップ1〜3まで試す
- 管理設定を、情報システムの数台にだけ配って、ステップ5を確かめる
- 問題が無ければ、部署ごとに広げる
- 窓口のログで、利用量と失敗の種類を週次で見る
設定の優先順位や配り方の全体は 管理設定 の記事に、プロキシ経由は プロキシ設定 の記事にあります。
まとめ
- 5ステップ。各ステップの確認の目印で、どの鍵が悪いかを切り分ける
- 窓口は、細切れの応答・ヘッダー本文の維持・エラーの非加工が条件
- 鍵は1人1つ。変数は窓口が見るヘッダーで選ぶ
- 管理設定の env に入れれば、本人の設定は不要
出典:Roll out an LLM gateway for your organization(公式ドキュメント)
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。


