黒い基板上の抵抗器とコンデンサの接写
現場の実践

Claude Code v2.1.268で組織導入時のゲートウェイ設定を点検する手順

目次を見る

複数チームでClaude Code(Anthropic社が提供するCLI型のAIコーディング支援ツール)を導入している組織で、IT部門やSRE担当がコスト管理とアクセス制御をどう点検すればよいか悩んでいるなら、v2.1.268のリリース内容が判断材料になります。

このバージョンでは、組織全体で使う「Claude apps gateway(複数ユーザーのリクエストを一元的に中継する社内ゲートウェイ機構)」に関する変更が複数入っています。料金の一元管理、アクセス制御の警告機能、認証まわりの設定追加です。個々の機能をコード実装として追うのではなく、ガバナンス観点で「何を設定すべきか」「何をチェックすべきか」を整理します。

この記事を読むと、Claude Codeを複数人・複数チームで使っている環境において、料金の可視化とネットワークアクセス制御の設定状況を点検し、必要な設定変更の判断ができる状態を目指します。

前提条件

手を動かす前に、以下がそろっているか確認してください。

  • Claude Code CLIがインストール済みで、バージョンがv2.1.268以降であること(claude --versionで確認)
  • 組織内でClaude apps gatewayを自前運用している、または運用を検討していること
  • gateway.yamlなど管理設定ファイルの編集権限を持つ管理者、またはその担当者と連携できる立場であること
  • ゲートウェイを配置しているネットワークのCIDR(IPアドレス範囲の表記方式)を把握していること

ゲートウェイを使わず、個々のエンジニアが直接Anthropic社のAPIキーで契約している場合は、この記事のアクセス制御部分は対象外です。ただしコスト可視化の考え方は参考になります。

手順1: 料金設定が一元管理されているか確認する

v2.1.268では、gateway.yamlpricing:を設定すると、サインイン済みのClaude Codeクライアント全員が同じ料金レートを管理設定経由で受け取れるようになりました。これにより/costコマンドの表示や利用状況のテレメトリ(利用データの自動収集・送信の仕組み)が、実際の請求(スペンドメーター)と一致します。

これは地味に見えて、ガバナンス上は重要な変更です。従来、個々のクライアントが参照する料金表と実際の請求額にズレが生じるケースがあると、部門別コスト按分や予算管理の根拠が揺らぎます。

まず、ゲートウェイ管理者に以下を確認してください。

# gateway.yaml内にpricing:セクションが存在するか確認
grep -A 5 "pricing:" gateway.yaml

pricing:が未設定の場合、クライアント側の/cost表示がデフォルト値や古いレートを参照している可能性があります。複数部門でコストを按分している組織では、この設定の有無を最初に確認する価値があります。

手順2: アクセス制御の穴を洗い出す

次に重要なのがネットワークアクセス制御です。今回のリリースで、access_control.allow_cidrsが空の場合に起動時警告が出るようになりました。加えて、公開IPアドレスからの初回リクエスト時にも一度だけ警告が表示される仕様が追加されています。

これは裏を返すと、これまでのバージョンでは「誰でもアクセスできる状態のゲートウェイ」が警告なしで稼働してしまうリスクがあったことを意味します。社内ネットワークのつもりで構築したゲートウェイが、実は外部からも到達可能だったというインシデントは、クラウド環境の設定ミスとして珍しくありません。

以下のコマンドでゲートウェイを起動し、警告の有無を確認してください。

# ゲートウェイ起動時のログを確認(警告出力を見る)
claude self-hosted-runner start --config gateway.yaml 2>&1 | grep -i warn

警告が出た場合は、access_control.allow_cidrsに許可すべきIPレンジ(社内ネットワークのCIDR表記)を明示的に設定します。

access_control:
  allow_cidrs:
    - "10.0.0.0/8"
    - "192.168.1.0/24"

手順3: gatewayInternalNetworksの用途を判断する

今回追加されたgatewayInternalNetworksという管理設定は、組織が保有する公開IPv4ブロックからの/loginアクセスを許可するためのものです。

ここで判断が分かれます。オフィス外からのアクセスや、複数拠点をまたぐ運用がある組織では、この設定が必要になる場面があります。一方、閉域網内だけで完結する運用であれば、無理に公開IPを許可する必要はありません。

判断基準は「ログインアクセスの発生元が、組織が管理する公開IPブロックに限定できるかどうか」です。限定できない、あるいは管理外のネットワークからのアクセスを許可したい場合は、この設定を使う前にネットワーク構成図を見直すことをおすすめします。

動作確認の方法

設定を変更したら、以下の手順で反映を確認します。

# 認証状態とconfigDirectoryの出力を確認(v2.1.268で追加された項目)
claude auth status --json

出力にconfigDirectoryが含まれていれば、設定ファイルの参照元が明確になり、複数環境での設定の混同を防ぎやすくなります。

さらに、実際にクライアント側で/costを実行し、管理者側が把握している請求額と近い数値になっているかを突き合わせてください。ズレがある場合、pricing:の設定内容か、クライアントのキャッシュを疑います。

ハマりやすいポイント

サードパーティのAnthropic互換エンドポイント(ANTHROPIC_BASE_URLで指定する自社ホストのAPI互換サーバーなど)を使っている場合、v2.1.265以降でArtifactツールの入力スキーマにあった正規表現が原因で、すべてのターンがHTTP 400エラーになる不具合がありました。v2.1.268でこの不具合は修正されていますが、社内でAnthropic互換エンドポイントを自前構築している組織は、アップグレード前後の挙動を必ず確認してください。バージョンを飛ばしてアップデートする場合、この期間のバージョンを経由していなくても、念のため疎通テストを一往復分は実施しておくと安心です。

導入・運用チェックの整理

複数人でClaude Codeを使う組織にとって、今回のアップデートは機能追加というより「ガバナンスの穴を塞ぐ」性格が強い内容です。

  • 料金の整合性: pricing:設定の有無と、/cost表示が実請求と一致しているかを確認する
  • ネットワーク露出: 起動時警告・初回公開IPアクセス警告が出ていないか、ログを定期的に見る
  • ログイン許可範囲: gatewayInternalNetworksを使うかどうかは、社内ネットワーク構成をもとに判断する
  • 互換エンドポイント利用時の疎通: 独自のAPI互換サーバーを使っている場合はアップグレード後に動作確認する

これらはいずれも数分で確認できる項目です。次回の定例ミーティングやセキュリティレビューの際に、ゲートウェイのログと設定ファイルを一度見直しておくと、意図しない公開設定や請求のズレを早期に発見できます。

参考

claude-code v2.1.268

この記事について: 本記事は AI を活用して作成し、forva AI 編集部が内容を確認・監修しています。

AI 駆動開発のご相談は forva AI へ。まずはお気軽にどうぞ。