結論：gateway.yamlのpricingと3つの表示を同じ前提で検証する
Claude Code 2.1.268では、Claude apps gatewayのpricingをgateway.yamlへ設定すると、managed settingsで接続したClaude Codeクライアントへ同じレートを伝え、/costとtelemetryをGatewayのspend meterに合わせられます。
まず「請求額が安くなる機能」ではなく、「表示と見積もりの基準を統一する機能」と捉えてください。モデル、provider、契約レート、割引、期間、利用者を分けて記録し、/costだけで判断しないことが企業運用の出発点です。
根拠はClaude Code公式changelogの2.1.268と、公式Gateway configurationです。公式Gateway overviewも、Gatewayが認証、モデル制御、telemetryを自社インフラへ置く構成を説明しています。公式資料が示していない料金削減率や請求額の一致は断定せず、契約・provider側の正本を別に保管します。
料金表示の役割を比較する
| 見る場所 | 役割 | 照合する軸 |
|---|---|---|
| gateway.yamlのpricing | Gatewayが採用する契約レートと割引の基準 | model・provider・適用日・承認 |
/cost | 利用者がsession中に見るコスト表示 | session・model・入力/出力・時刻 |
| telemetry / spend meter | 管理者が集計・上限・監査に使う表示 | user・group・期間・転送先・保持 |
この三つは目的が違います。利用者の判断に必要な速報値と、管理者の予算・監査に必要な集計値は、完全に同じ画面を使う必要がありません。ただし、同じレートを参照していなければ「利用者の表示は合っているのに、spend meterでは別の額になる」という説明不能な差が生まれます。最初に採用する通貨、単位、モデルID、provider、割引の適用条件を台帳に固定します。
導入手順：料金の伝播を8ステップで確認する
claude --versionを実行し、2.1.268以降であること、接続先がClaude apps gatewayであることを記録します。- gateway.yamlのpricingに記載するモデル、provider、入力・出力レート、割引係数、適用日を契約担当者と確定します。
- 認証情報、OIDC secret、PostgreSQL接続情報などを料金設定と同じ平文管理にせず、公式のsecret expansionと組織のsecret storeを使います。
- Gatewayを再起動する前に、構文、未知のキー、対象upstream、モデルIDを検証し、変更差分と承認者を保存します。
- managed settingsから一人の検証ユーザーを接続し、モデル、group、providerが意図した経路へ入ることを確認します。
- 同じ短い検証sessionで
/cost、telemetry、spend meterの期間・model・userを保存し、丸め誤差と設定差を分けます。 - 別のgroupまたはproviderを使う場合は、同じレートを流用せず、契約条件とmodel aliasの解決先を照合します。
- 一致を確認した後に段階展開し、レート変更時の再検証、予算上限、誤設定時のrollback担当を決めます。
検証は大きな本番データで始めません。入力と出力の量が分かる固定promptを使い、利用者、group、model、provider、実行時刻を1行の検証記録にします。/costに出る値とtelemetryのイベントを単純に文字列比較せず、同じsession IDへ結び付けて、集計周期、遅延、丸め、割引の順に差を説明します。
企業で迷いやすいレート・契約・制限の境界
公式Gateway configurationではpricingは任意のセクションとして説明され、契約レートとdiscount multiplierをspend meterや開発者が見るcost figuresへ使う設計です。これはAnthropicの全契約を一律に変更する設定ではなく、自社Gatewayが採用する表示基準です。API、Bedrock、Claude Platform on AWS、Google Cloud、Foundryではprovider側の料金・請求・モデルIDが異なるため、設定の存在だけで同じ料金になるとは限りません。
また、コスト表示と上限は別の制御です。予算上限を置く場合は、どの集計単位で止めるか、fail-openかfail-closedか、遅延したtelemetryをどう扱うかを別表にします。料金設定を変えた時に過去の表示まで書き換えるのか、適用日以降だけ変えるのかも決めます。値だけでなく、設定を読んだGatewayのversion、hash、承認記録を残すと、後から請求・利用・運用の三者を説明しやすくなります。
既存のGateway認証の切り分けは誰が接続できるか、OTLP転送の設計はどこへ観測データを送るかを扱います。今回の記事は、認証や転送先ではなく、料金の基準が利用者表示と管理集計へどう伝わるかに絞っています。問題が認証なら認証記事、telemetry経路ならOTLP記事へ戻り、料金差と混同しないでください。
チェックリスト：本番展開前に残す証跡
□2.1.268以降か □GatewayのURLとupstreamを確認したか □model IDとproviderを記録したか □pricingの適用日・通貨・単位・割引を承認したか □secretを平文で置いていないか □managed settingsの対象groupを確認したか □固定sessionで/cost・telemetry・spend meterを照合したか □丸め・遅延・集計単位を説明したか □予算上限と停止責任者を決めたか □変更前へ戻す手順と再検証日を残したか。
よくある質問
Gatewayに料金設定を置くと請求額が変わりますか？
変わると断定できません。pricingは自社Gatewayのspend meter、/cost、telemetryが参照する基準です。契約請求はproviderや契約条件の正本で確認します。
複数providerで同じレートを使えますか？
モデルID、単位、契約、割引、適用時期が同じかを確認できる場合だけです。alias名だけで同一視せず、provider別に検証します。
/costの値がtelemetryと違う時は？
session ID、集計期間、model、user、rate versionを照合し、遅延・丸め・設定scope・転送欠落を分けます。認証値や秘密情報はログへ貼りません。
公式情報と無料診断
仕様は公式changelog、設定項目は公式configuration、構成の前提は公式Gateway overviewを公開直前に確認しています。Miraigentの無料診断では、利用者・provider・予算・telemetryを一枚の運用表に整理できます。