Claude Codeが使う人の情報を伝える新設定とは

どんな機能が追加されたのか

Claude Codeのv2.1.233で、apps gatewayにforward_user_identityという設定が追加されました。これはオプトイン、つまり初期状態ではオフで、必要な人だけが有効にする設定です。

この設定を有効にすると、Claude Codeからのリクエストが「どのユーザーがサインインして使っているか」という情報をヘッダーという形で一緒に送るようになります。送り先はAnthropicのモデルにつながる上流(upstream)で、その手前にgateway(ゲートウェイ)という中継点を挟んでいる構成が前提です。

なぜこれが必要になるのか

会社やチームでClaude Codeを導入すると、多くの場合「全員の利用料金をまとめて管理したい」というニーズが出てきます。例えば社内に請求や利用状況を管理するプロキシ(中継サーバー)を置いて、そこを経由してAnthropicのモデルにアクセスする構成です。

ところが、ゲートウェイを通ったリクエストは本来「誰が使ったものか」という情報が見えにくくなりがちです。全員分のリクエストがひとまとめになって届くと、プロキシ側では「チーム全体でいくら使ったか」はわかっても、「Aさんがいくら使ったか」「Bさんがいくら使ったか」までは区別できません。

そこで今回追加されたforward_user_identityを有効にすると、サインインしているユーザーの身元情報がヘッダーとして一緒に送られるようになります。プロキシ側はそのヘッダーを見れば、どのリクエストが誰のものかを判別できるようになり、ユーザーごとの支出(spend)を計算・記録できるようになります。

身近な例で考える

社員食堂を想像するとわかりやすいかもしれません。全員が同じ入口から食事を取っていく場合、会社は「今月の食堂全体のコスト」はわかっても、「誰がどれだけ食べたか」は社員証をかざしてもらわない限りわかりません。

今回の設定は、いわば「社員証をかざしてから食事を取ってもらう」仕組みに近いものです。ゲートウェイを通るときにユーザーの身元を一緒に渡すことで、後段のプロキシが「誰の利用か」を把握し、個人単位・チーム単位でのコスト管理ができるようになります。

誰にとって嬉しい機能か

個人でClaude Codeを使っている人にとっては、直接関係のある設定ではありません。この機能が効いてくるのは、組織として複数人にClaude Codeを使わせていて、かつ独自のゲートウェイやプロキシを間に挟んで利用状況を管理している場合です。

利用量に応じた部署間の費用按分や、特定ユーザーの使いすぎの検知など、「誰が使ったか」を起点にした管理をしたいチームにとっては役立つ設定だと言えます。