Claudeのプロジェクトタグでコストコード別に支出を見る — Enterpriseベータ

2026年11月6日のClaudeアプリのリリースノートに、項目が1つ載りました。Claude Enterpriseの対象組織で、プロジェクトに案件番号やチャージコードなどのタグを付け、その支出をタグ別に見られるようになります。ベータ提供です。

経理や情報システムの担当者にとっては、「どの案件がいくら使ったか」をClaudeの管理画面かAPIから引ける、という話です。ただし数字には、請求書と一致しないことがある、座席(seat)でまかなわれた利用は含まれない、といった条件がついています。

要点

発表の趣旨は、すでに社内で使っているコード体系にClaudeの支出を合わせられる、という点です。支出を、案件という軸でも見られるようになります。

タグと値の仕組みは何か

プロジェクトタグは「タグ」と「値」の2つの部品でできています。タグは集計の軸になる分類で、cost_code や client_matter が例に挙がっています。値はコードそのもので、CC-1042 のような文字列です。

タグと値の一覧はOwnerが作り、各プロジェクトに値を入れるのは、そのプロジェクトの編集権限を持つ人です。1つのタグが持てる値は1プロジェクトにつき1つで、1プロジェクトに付けられるタグは16個までです。

支出を見る権限が、Analytics viewだけでなくBilling viewも要る点に注意してください。分析担当者に既存のAnalytics権限があっても、それだけではこの画面は開けません。

どの使い方で支出がタグに乗るか

タグが効くのは、プロジェクトの中で行った作業です。ヘルプの表では、使い方ごとに次のように分かれます。

Claude Codeの扱いが実務では最も効きます。エージェント作業の費用を案件に割り当てるとき(Claude Enterprise一般提供の記事も参照)、Claude Codeを使う開発者が最初の抜け漏れ候補になります。

タグを作って支出を見るまでの手順

1. Ownerがタグを作る

Organization settings、Organization、Project tagsを開き、「Create tag」から作ります。

タグの名前と値は組織の全員から見えます。顧客名や秘匿案件の名称をそのまま値にしないほうが安全です。

2. プロジェクトに値を付ける

編集権限のある人がプロジェクトを開き、Tagsの「Add tag」からタグを選び、値を選ぶか入力します。

3. Claude Codeにはプロジェクトを指定する

Claude Codeにはプロジェクトの選択画面がありません。そのため、設定ファイルにプロジェクトIDを書きます。IDはclaude.ai上のプロジェクトURL claude.ai/project/ の末尾の部分です。リポジトリ単位なら .claude/settings.json、全リポジトリに効かせるなら ~/.claude/settings.json に次の1行を足します。

{
  "attributionProject": "PROJECT_ID"
}

リポジトリ側の設定ファイルを使った場合は、Claude Codeが聞いてきたときにフォルダを信頼すると有効になります。ここで見落としやすいのは、プロジェクトが未設定でも警告が出ず、そのまま「タグなし」で集計される点です。Claude Codeの利用者には、設定を入れるよう案内しておく必要があります。JSONが壊れるとClaude Codeがそのパソコンで動かなくなることがあるため、カンマの付け忘れや余りも確認してください。

4. 使用量ページでタグ別に見る

Organization settings、Usage、Spend by projectを開き、Group byでタグを選びます。PeriodとProductのメニューで絞り込め、結果は「Export CSV」で書き出せます。データは前日(UTC)の終わりまでです。

数字を読むときの注意点

集計には、先に知らないと読み違える条件がいくつもあります。

• 新しいタグが反映されるまでに約2時間かかります。その間の利用は、直前のタグか「タグなし」に入ることがあります
• タグを後から付けても過去の支出は動きません。利用はそのときのタグのままなので、集計に乗せたい作業は、始める前にタグを付けておく必要があります
• プロジェクトの外の作業は「Not in a project」、プロジェクト内で値が空のものは「No tag value」と表示されます。プロジェクトが未設定のClaude Codeは前者です
• 金額は割引後・クレジット前で、請求書と一致しないことがあります。直近の数字は月末から約1週間は変わりえます
• 座席でまかなわれた利用は数えません。主に座席で使うプロジェクトは、支出がほとんど出ないことがあります
• 利用のないプロジェクトは一覧に出ません。集計は、プロジェクトタグが組織で使えるようになった日から始まるため、それ以前の日付は全期間の履歴として扱えません
• 非公開プロジェクトの名前は、この画面とCSVでは「Private project」と表示されます。Analyticsダッシュボード、Analytics API、Compliance APIには実名で出ます

座席でまかなわれた利用が入らない点は、請求の考え方に直結します。タグ別の合計は「従量部分の按分」であって、全社のClaude費用を案件別に分けた表ではありません。経理への配賦資料に使う場合は、請求書との差分を先に説明できる状態にしておくと、あとで食い違いを探す手間が減ります。

APIで取り込むとき

ベータ期間中は、パスや名前が変わる可能性があります。APIキーはPrimary Ownerが、Organization settings、Organization、APIで作ります。

タグを設定する(Admin API)

read:project_tags と write:project_tags のスコープを持つキーを作ります。このAPIでできるのは、タグの一覧取得、タグへの値の追加、プロジェクトのタグ設定です。タグの作成、値のアーカイブ、プロジェクトの作成はできません。

POST /v1/organizations/apps/projects/claude_proj_.../tags
anthropic-beta: ce-project-tags-2026-10-09
 
{"tags": {"cost_code": "CC-1042"}}

指定するのは claude_proj_ で始まるIDで、プロジェクトURLのIDではありません。一覧は GET /v1/organizations/analytics/apps/chat/projects?date=YYYY-MM-DD で取れます。日付は1日以上前にします。この呼び出しは read:analytics スコープが必要で、その日にチャットの利用があったプロジェクトだけが返ります。

支出を取り込む(Analytics API)

Analytics APIを有効にし、read:analytics スコープのキーを作ります。1回の呼び出しで取れる日次バケットは最大31日分です。

GET /v1/organizations/analytics/cost
  ?starting_at=...&ending_at=...
  &time_bucket_width=1d
  &group_by[]=tags.claude_project[cost_code]
  &limit=1000
anthropic-beta: analytics-usage-cost-2026-08-24

金額はセント単位で、1セント未満の端数を含みます。割引は反映済みですが、請求書とは一致しないことがあります。1回に返るのは最大1000行で、has_more が true の間はページを送り続けないと合計が足りません。タグの絞り込み文字列はURLに載るため、リクエストログに残りえます。

Usage and Cost Analytics APIの基本形は移行手順の記事で扱っています。ここで使う group_by[] の考え方もその延長にあります。

ベータの制約と、まだ入っていないもの

ベータ版の制約は次のとおりです。

• 編集権限があれば誰でもタグを変えられます。必須でなければ消すこともでき、タグのロックはありません
• 必須タグは、Webで新しく作るプロジェクトにだけ適用されます。既存のプロジェクトは影響を受けません。Webでは必須タグの値の変更はできても削除はできませんが、Admin APIでは削除できます
• 値は256文字までで、スペースやカンマを含められます。結合絵文字など、見えない文字に頼る値は拒否されます
• 入っていないのは、単一のチャットやセッションへのタグ付け、支出を複数のタグへ分ける機能、タグや値の名前変更、タグ別の利用上限です

1つのタグは1つの値しか持てないので、複数の案件にまたがるプロジェクトの支出は按分できません。部署と案件番号のように軸が違うなら、cost_center と client_matter のように別のタグを使います。値の正しさもClaudeは検証しません。一覧で選択肢を絞れても、経理システム上のコードと突き合わせる仕組みはないので、照合は運用で補います。

Ownerがタグを作るまでは何も起きないため、使わない組織は特に操作が要りません。機能ごと止めたいときは、アカウント担当への連絡が案内されています。

前日のEnterprise発表と合わせて読む

前日の11月5日には、Enterpriseのセキュリティセンターやメンバーのサインアウト操作が加わりました。11月5日のリリースノートの記事にあります。5日の発表がアクセスを管理者の手元で制御するものだったのに対し、6日の発表は費用を管理者の手元で案件に結びつけるものです。2日続けて、Enterpriseの管理機能が拡充されています。

まとめ

プロジェクトタグは、従量で使う分を案件に割り当てる道具です。導入でまず詰まるのは、警告なしでタグが漏れるClaude Codeの設定と、座席分が入らないぶん請求書と合わない点の2つです。