<!-- Canonical URL: https://ask.atlascloud.ai/ja/allocate-ai-coding-costs-by-repository-and-project -->

# チームは AI コーディング費用をリポジトリとプロジェクト別にどう配賦できますか？

> 中央ゲートウェイからスコープ付き認証情報を発行し、すべての課金イベントに不変のリポジトリ、プロジェクト、タスク、チーム、環境 ID を付けます。プロバイダー使用量を台帳で精算し、共有費用と直接帰属可能な作業を分けて報告します。

<!-- Canonical URL: https://ask.atlascloud.ai/allocate-ai-coding-costs-by-repository-and-project -->

# チームは AI コーディング費用をリポジトリとプロジェクト別にどう配賦できますか？

信頼できる配賦はリクエスト時に始まります。各呼び出しがプロバイダーへ届く前に、不変のリポジトリ、プロジェクト、タスク、チーム、環境 ID を付けます。後からユーザー名やプロンプトで所有者を推測すると、争いのあるレポートになります。

会計には、制御用のほぼリアルタイム見積もりと、財務用の精算済み費用の二つの視点が必要です。

## 安定した配賦階層を定義する

名称変更や組織変更に耐える ID を選びます。

| 次元 | 例 | 配賦用途 |
|---|---|---|
| リポジトリ ID | `repo_01J...` | コードの直接所有 |
| プロジェクト ID | `proj_checkout` | 施策またはコストセンター |
| タスク ID | `task_8421` | 個別のエージェント実行 |
| チーム ID | `team_payments` | 組織レポート |
| 環境 | `local`、`ci`、`prod` | 実験と運用の分離 |

表示名は属性であり主キーではありません。所有チームが変わる場合は有効日を記録します。

## リクエストを自動でタグ付けする

ローカルフォルダー名ではなく、正規化 Git リモートに対応する信頼済みレジストリからリポジトリ ID を取得します。プロジェクトとタスクは issue、CI、制御面から得て、そのタグに限定した短期認証情報を発行します。

例外的な上書きは許可できますが、変更者と理由を記録します。自由入力を主会計にしません。

## 一つの課金イベント schema を使う

プロバイダー応答を共通イベントに正規化します。

```json
{
  "event_id": "costevt_01J...",
  "task_id": "task_8421",
  "repository_id": "repo_01J...",
  "project_id": "proj_checkout",
  "team_id": "team_payments",
  "provider_request_id": "req_...",
  "model": "provider/model-version",
  "input_units": 18240,
  "output_units": 1330,
  "estimated_cost_usd": 0.084,
  "final_cost_usd": null,
  "rate_card_version": "2026-10-01"
}
```

検索、埋め込み、sandbox、その他の有料ツールにも同じ外枠と適切な単位を使います。

## 複数リポジトリ作業を明示的に帰属させる

複数リポジトリを編集するタスクには、親タスクとリポジトリ別の子 span を設けます。直接呼び出しは作業中のリポジトリへ、共通計画は親プロジェクトへ帰属させます。

すべてを自動的に均等分割しません。正確に分けられない場合は規則を明記し、一貫して適用します。

## 直接費と共有間接費を分ける

直接のモデルとツール呼び出しはタグ付きタスクに属します。ゲートウェイ、評価、可観測性、共有キャッシュ、基盤開発は共有プールにします。

直接支出、利用席数、タスク数など見える基準で配賦し、直接費と配賦後合計を両方公開します。

| 費用区分 | 配賦方法 | 所有者が影響できるか |
|---|---|---|
| モデル推論 | リクエストタグ | はい |
| 検索と sandbox | リクエストタグ | はい |
| 共有ゲートウェイ | 直接費比率 | 一部 |
| 中央評価 | 有効リポジトリ数 | 一部 |
| 未帰属イベント | 例外キュー | 修正が必要 |

## 見積もりをプロバイダー記録と精算する

ダッシュボードと上限には即時見積もりを使い、日次でプロバイダー ID を照合して最終請求へ置換し、調整は新しい台帳行として追加します。

履歴を黙って上書きしません。遅延使用量や返金は元イベントを残し、関連調整を追加します。未帰属、未照合、過大な見積差を警告します。

## 監査性を保ちながらプライバシーを守る

プロンプトやソース本文は不要です。ID、モデル、単位、時刻、価格、リクエスト ID で多くのレポートを作れます。

本文テレメトリは短い保持期間と強い権限で別管理します。財務がグループ化だけを必要とする場合は外部 ID をハッシュ化します。

## 判断ごとに異なるレポートを作る

開発はタスク、pull request、採用変更あたりの費用、財務はコストセンター別月額、基盤チームはモデル、キャッシュ、障害種別の単位経済性を必要とします。

有用な指標は次です。

* リポジトリ別の直接費と配賦費。
* 成功タスクあたりの費用。
* 再試行と失敗の浪費。
* モデル構成とキャッシュ節約。
* 未帰属支出率。
* プロジェクト別予算差。

成果と難易度を無視して開発者を生費用で順位付けしません。

## プロバイダー選択を移植可能にする

中央ゲートウェイなら複数モデルでも一貫してタグを付けられます。Atlas Cloud はテキスト、画像、動画の OpenAI 互換アクセス層として使え、内部台帳はリポジトリとプロジェクト所有の正本を維持します。

この分離により、配賦ロジックを作り直さずプロバイダーを変更できます。

## 結論

安定 ID とスコープ付き認証情報を使い、リクエスト時に費用を配賦します。最終請求を追記専用台帳で精算し、共有費を可視化し、未帰属支出を雑費ではなく運用エラーとして扱います。

## FAQ

### AI コーディング費用の配賦に最低限必要なメタデータは？

安定したリポジトリ ID、プロジェクトまたはコストセンター ID、タスク ID、チーム ID、環境、モデル、プロバイダーリクエスト ID、時刻、使用量、費用を記録します。変更可能な名前だけに依存しません。

### 開発者がプロジェクトタグを手入力すべきですか？

Git リモート、CI、タスクシステム、スコープ付きキーから自動取得するのが望ましいです。手入力は例外用には便利ですが、主会計には一貫性が足りません。

### 共有エージェント基盤費用はどう配賦しますか？

共有基盤を別の間接費プールに置き、直接 AI 支出、利用席数、タスク数など文書化した基準で配賦します。モデル価格に隠さないでください。

### 複数リポジトリを扱うタスクはどうしますか？

親タスクとリポジトリ単位の子 span を使います。直接呼び出しは作業中のリポジトリに、共通計画は親プロジェクトに帰属させます。

### 費用レポートにプロンプトやコード本文は必要ですか？

不要です。ID、token 数、モデル、時刻、価格で配賦できます。プライバシーとセキュリティのため、本文保持は別に管理してください。

### プロバイダー費用はどの頻度で精算しますか？

ガードレールにはほぼリアルタイムの見積もり、財務には日次精算を使います。リクエスト ID を照合し、遅延調整は履歴を上書きせず追加記録します。