コストコードでプロジェクトタグを使用して支出を追跡する

この記事では、組織で既に使用しているコード（作業分解構造（WBS）コード、チャージコード、クライアント案件番号など）を使用してプロジェクトにタグを付ける方法について説明します。その後、組織設定または API を通じて、これらのプロジェクトのほとんどの支出をタグ別に確認できます。

プロジェクトタグは Claude Enterprise プランでベータ版として利用可能です。HIPAA 構成、カスタマーマネージド暗号化キー（CMEK）、ゼロデータ保持（ZDR）（Claude Code の ZDR を含む）、最小限のデータ保持、または米国外に保存されたデータを使用する組織では利用できません。また、Claude Desktop を独自のモデルプロバイダーを通じてルーティングする組織でも利用できません。

重要: プロジェクトタグはプロジェクト内でのみ機能します。プロジェクト外での作業にはタグが付きません。

プロジェクトタグの仕組み

プロジェクトタグは 2 つの要素を使用します。

タグ: cost_code や client_matter など、レポートの対象となるカテゴリ。
値: CC-1042 などのコード自体。

オーナーがタグとその値を作成し、プロジェクトを編集できるユーザーはそのプロジェクトの値を設定できます。各タグはプロジェクトごとに 1 つの値を保持し、プロジェクトは最大 16 個のタグを持つことができます。

始める前に

タグを作成し、その値を管理するために必要なロール: プライマリオーナー、オーナー、またはオーナーアクセス権を持つカスタムロール
プロジェクトのタグを設定するために必要なロール: プロジェクトへの「編集可能」アクセス
タグ別の支出を表示するために必要なロール: プライマリオーナー、オーナー、または分析ビューと請求ビューのアクセス権を持つカスタムロール
API キーを作成するために必要なロール: プライマリオーナー

プロジェクトタグが適用される場所

作業が行われる場所	支出はプロジェクト別に報告されますか?
プロジェクト内でのチャット	はい
プロジェクト内の統合チャットと Cowork エクスペリエンス	はい
コンピューター上の Cowork タスク	はい。Claude Desktop 3.6556.1 以降に更新し、タスク用に 1 つのプロジェクトを選択します。
ターミナルまたはデスクトップの Claude Code	はい。Claude Code のプロジェクトを設定した後。Claude Code 2.1.305 以降、または Claude Desktop 3.6556.1 以降が必要です。

プロジェクトタグは以下には適用されません。

ウェブ上の Claude Code
Claude for Office
Chrome の Claude
Claude Design
Slack と Microsoft Teams の Claude
アーティファクト
音声モード
Claude API または Claude コンソール
Amazon Bedrock、Google Cloud Vertex AI、ゲートウェイ、または API キーを通じた Claude Code

プロジェクトタグを設定する

プロジェクトタグは対象となる組織では自動的にオンになり、オンにするための設定はありません。開始するには、タグを作成します。

タグを作成し、その値を追加する

オーナーは以下の手順に従ってタグを作成できます。

組織設定 > 組織 > プロジェクトタグに移動します。
「タグを作成」をクリックします。
cost_code などの名前を入力します。名前は小文字でスペースなし、後で名前を変更することはできません。
許可される値で、ユーザーがリストから選択できるようにするには「定義済みの値のみ」を選択するか、ユーザーが独自に入力できるようにするには「任意の値」を選択します。
「定義済みの値のみ」を選択した場合は、値の下にリストを追加します。1 行に 1 つの値を入力するか、ヘッダーとして value を含む単一列の CSV ファイルを追加します。
（オプション）「必須」トグルをオンにして、ユーザーが新しいプロジェクトで値を設定するようにします。
「続行」をクリックします。

後で値を追加するには、プロジェクトタグページでタグを開き、「値を追加」または「CSV をインポート」をクリックします。

注: タグ名と値は組織内のすべてのユーザーに表示されるため、機密情報は含めないでください。

プロジェクトにタグを追加する

「編集可能」アクセス権を持つユーザーは誰でもプロジェクトにタグを追加できます。

プロジェクトを開きます。
タグで「タグを追加」をクリックします。
タグを選択し、値を選択または入力します。

注: タグ名と値は組織内のすべてのユーザーに表示されるため、機密情報は含めないでください。

Claude Code のプロジェクトを設定する

Claude Code にはプロジェクトピッカーがないため、ユーザーは設定ファイルでプロジェクトを設定します。プロジェクトが設定されていない場合、Claude Code の使用にはタグが付かず、警告もないため、ユーザーに知らせてください。

Claude でプロジェクトを開き、その ID をコピーします。ID は URL の最後の部分です: claude.ai/project/this-part。
リポジトリ内の .claude/settings.json または ~/.claude/settings.json を開いてリポジトリ全体に適用します。
プロジェクト ID を使用して、以下の行を追加します。
リポジトリの設定ファイルを使用した場合は、Claude Code が要求したときにフォルダーを信頼します。その後、設定が有効になります。

{ "attributionProject": "PROJECT_ID" }

警告: ファイルが有効な JSON のままであることを確認してください。余分なコンマがあると、そのコンピューター上の Claude Code が破損する可能性があります。

タグ別の支出を表示する

プライマリオーナー、オーナー、および分析ビューと請求ビューのアクセス権を持つカスタムロールは、タグ別の支出を表示できます。

組織設定 > 使用状況 > プロジェクト別の支出に移動します。
「グループ化」メニューを使用してタグを選択します。
「期間」メニューと「製品」メニューを使用して結果を絞り込みます。

データは昨日の終わり（UTC）まで実行されます。結果をダウンロードするには、「CSV をエクスポート」をクリックします。

注: プライベートプロジェクトの名前は、このページと CSV では「プライベートプロジェクト」として表示されます。分析ダッシュボード、分析 API、およびコンプライアンス API は引き続き実際の名前を表示します。

数値を読むときは、以下の点に注意してください。

作業が始まる前にタグを追加します。 支出は、タグが有効になった後、つまり約 2 時間後にタグに対してカウントされます。そのプロジェクトの以前の支出はカウントされません。
使用状況のないプロジェクトは表示されません。 プロジェクトは、選択した日付で使用された後に表示されます。
レポートは、プロジェクトタグが組織で利用可能になったときに開始されます。 以前の日付を完全な履歴として扱わないでください。
新しいタグが表示されるまでに約 2 時間かかります。 そのウィンドウ中の使用状況は、前のタグまたはタグなしのままになる可能性があります。
タグを変更しても、過去の支出は変わりません。 使用状況は、その時点でプロジェクトが持っていたタグの下に留まります。
プロジェクト外の支出は「プロジェクト内ではありません」と表示されます。 これには、プロジェクトが設定されていない Claude Code セッションが含まれます。タグの値がないプロジェクト内の支出は「タグ値なし」と表示されます。
金額が請求書と一致しない場合があります。 これらは割引後、クレジット前に表示され、最近の数値は月末から約 1 週間後まで変更される可能性があります。
シートでカバーされた使用状況はカウントされません。 主にシートで使用されるプロジェクトは、支出がほとんどまたはまったく表示されない場合があります。

API でタグを管理し、支出を取得する

独自のシステムからタグを設定し、支出を取得できます。両方の API はベータ版であるため、パスと名前が変更される可能性があります。プライマリオーナーは 組織設定 > 組織 > API で API キーを作成します。

Admin API でタグを設定する

read:project_tags および write:project_tags スコープを持つキーを作成します。Admin API はタグをリストし、タグのリストに値を追加し、プロジェクトのタグを設定できます。タグを作成したり、値をアーカイブしたり、プロジェクトを作成したりすることはできません。

POST /v1/organizations/apps/projects/claude_proj_.../tags

Header: anthropic-beta: ce-project-tags-2026-10-09

Body: {"tags": {"cost_code": "CC-1042"}}

Admin API は、プロジェクトの URL の ID ではなく、claude_proj_ ID を使用します。ID をリストするには、少なくとも 1 日前の日付で GET /v1/organizations/analytics/apps/chat/projects?date=YYYY-MM-DD を呼び出します。その日付でチャットアクティビティがあったプロジェクトのみが返されます。この呼び出しには read:analytics スコープが必要なため、分析 API をオンにしてそのスコープをキーに追加します。

使用状況レポートとコストレポートで支出を取得する

分析 API をオンにし、read:analytics スコープを持つキーを作成します。日次バケットは 1 回の呼び出しで最大 31 日間をカバーするため、これを使用して 1 か月全体を取得します。

GET /v1/organizations/analytics/cost?starting_at=...&ending_at=...&time_bucket_width=1d&group_by[]=tags.claude_project[cost_code]&limit=1000

Header: anthropic-beta: analytics-usage-cost-2026-08-24

金額はセント単位で、セントの小数を含む可能性があり、既に割引が含まれていますが、請求書と一致しない場合があります。
各呼び出しは最大 1000 行を返します。has_more が true の場合は、ページングを続けるか、合計が不足します。
タグフィルターテキストは URL で移動するため、リクエストログに表示される可能性があります。

現在の制限

共有: タグ名と値は組織内のすべてのユーザーに表示されるため、機密情報は含めないでください。
編集: プロジェクトを編集できるユーザーは誰でもそのタグを変更でき、必須でない限り 1 つをクリアできます。タグをロックすることはできません。
必須タグ: これらはウェブで作成された新しいプロジェクトにのみ適用されるため、既存のプロジェクトは影響を受けません。ウェブ上では、必須タグの値は変更できますが、削除することはできません。Admin API はそれでも削除できます。
文字: 値は最大 256 文字で、スペースとコンマを含めることができます。結合絵文字やペルシャ語またはシンハラ語の一部の単語など、目に見えない文字に依存する値は拒否されます。
このベータに含まれていません: 単一のチャットまたはセッションのタグ、タグ全体での支出の分割、タグまたは値の名前変更、およびタグ別の支出制限。

よくある質問

プロジェクトは複数のタグを持つことができますか?

はい。cost_center や client_matter などの個別のタグを使用して、プロジェクトあたり最大 16 個まで使用できます。各タグは 1 つの値を保持するため、プロジェクトの支出を同じタグの 2 つの値に分割することはできません。

Claude はタグ値をチェックしますか?

いいえ。リストはユーザーが選択できるものを制限しますが、値は財務システムに対してチェックされません。

プロジェクトタグをオフにするにはどうすればよいですか?

プロジェクトタグは、オーナーがタグを作成するまで何も変更しません。オフにするには、アカウントチームに連絡してください。

プロジェクト タグの仕組み