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

公開 更新 著者 永上裕之導入とルール
管理者らしい人が、1つの窓口から社内の何台ものパソコンへ同じ設定を配っているイメージ

この記事の要点

  • 展開は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つのステップを、確認つきで進める

  1. モデルの経路を確かめる
  2. 開発者ごとに鍵を発行する
  3. 手元で Claude Code を試す
  4. 住所と鍵を配る
  5. 開発者のパソコンから確認する

各ステップに「確認の目印」があり、失敗した時にどの鍵が悪いかを切り分けられます。鍵は3種類あります。

鍵持つ人役割
提供元の鍵ゲートウェイ上流(AIの提供元)へ転送する時に使う。クライアントには出てこない
ゲートウェイの管理用の鍵管理者試験や管理画面用(無い製品もある)
開発者の鍵各開発者ゲートウェイが開発者ごとに発行する

始める前の条件

窓口に必要な条件は6つです。

窓口は、転送(リダイレクト)の先ではなく、配る住所そのもので HTTPS を受けるようにします。転送で本文や鍵のヘッダーが落ちることがあるためです。

ステップ1:モデルの経路を確かめる

最小のリクエストを、配るモデル名ごとに送ります。

配るモデル名は、1つずつ全部試します。 振り分けていない名前は、選んだ人にだけ 404 が出ます。

ステップ2:開発者ごとに鍵を発行する

開発者ごとに別の鍵を発行します。共有の鍵にしないのが重要です。1人ずつの利用量の把握と、退職時の個別の停止ができなくなるためです。

発行したら、ステップ1と同じリクエストで、新しい鍵が通るかを確かめます。ステップ1が通ったのにここで 401 なら、開発者の鍵が間違っているか、窓口にまだ反映されていません。

どの環境変数に鍵を入れるかは、窓口が見るヘッダーで決まります。

ステップ3:手元で Claude Code を試す

配る前に、自分のパソコンで、配る設定と同じ内容を試します。ターミナルに直接入力するので、閉じれば元に戻ります。住所は ANTHROPIC_BASE_URL、鍵は上の変数に入れて、次を実行します。

claude -p "Reply with one word: connected"

返事が返り、窓口のログに /v1/messages への POST(状態 200)が残れば成功です。パスだけで見ます(末尾に ?beta=true などが付くため)。

ステップ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つ配る方法が使えます。コマンドが、本人として鍵の保管庫に問い合わせるので、端末ごとに別の鍵になります。

注意すること

管理設定を使えない場合は、住所・個人の鍵・どの変数に入れるかを、本人へ伝えます。変数の種類を伝えるだけで、試行錯誤が減ります。

ステップ5:開発者のパソコンから確認する

窓口の機械ではなく、開発者が使う経路から確かめます。

  1. ストリーミングのリクエストを送り、データが少しずつ届くか見る。まとめて届くなら窓口がためている
  2. claude を起動し、ログイン画面が出ないか見る
  3. /status の Status タブで、Anthropic base URL の行に窓口の住所が出るか、Setting sources に管理設定が含まれるかを見る
  4. 窓口のログで、鍵が誰か、session-id のヘッダーでセッションがまとまるかを見る

ログイン画面が出る、または Anthropic base URL の行が無いなら、設定が端末に届いていません。

会社での進め方の例

  1. 1つのモデル名と、数人の鍵で、ステップ1〜3まで試す
  2. 管理設定を、情報システムの数台にだけ配って、ステップ5を確かめる
  3. 問題が無ければ、部署ごとに広げる
  4. 窓口のログで、利用量と失敗の種類を週次で見る

設定の優先順位や配り方の全体は 管理設定 の記事に、プロキシ経由は プロキシ設定 の記事にあります。

まとめ

  1. 5ステップ。各ステップの確認の目印で、どの鍵が悪いかを切り分ける
  2. 窓口は、細切れの応答・ヘッダー本文の維持・エラーの非加工が条件
  3. 鍵は1人1つ。変数は窓口が見るヘッダーで選ぶ
  4. 管理設定の env に入れれば、本人の設定は不要

出典:Roll out an LLM gateway for your organization(公式ドキュメント)

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事