本文說明如何使用貴組織已使用的代碼（例如工作分解結構 (WBS) 代碼、費用代碼或客戶事項編號）標記專案。然後，您可以在組織設定中或透過 API 查看這些專案中的大部分支出（按標籤分類）。
專案標籤在 Claude Enterprise 方案中以測試版形式提供。不適用於具有 HIPAA 設定、客戶管理的加密金鑰 (CMEK)、零資料保留 (ZDR)（包括 Claude Code 的 ZDR）、最小資料保留或資料儲存在美國以外的組織。也不適用於透過自己的模型提供者路由 Claude Desktop 的組織。
重要：專案標籤只在專案內有效。專案外的工作不會獲得標籤。
專案標籤的運作方式
專案標籤使用兩個部分：
標籤：您報告的類別，例如
cost_code或client_matter。值：代碼本身，例如
CC-1042。
擁有者建立標籤及其值，任何可以編輯專案的人都可以為該專案設定值。每個標籤每個專案只保留一個值，一個專案最多可以有 16 個標籤。
開始前
建立標籤和管理其值所需的角色：主要擁有者、擁有者或具有擁有者存取權限的自訂角色
設定專案標籤所需的角色：對專案具有「可編輯」存取權限
查看按標籤分類的支出所需的角色：主要擁有者、擁有者或具有分析檢視和帳單檢視存取權限的自訂角色
建立 API 金鑰所需的角色：主要擁有者
專案標籤適用的位置
工作進行的位置 | 支出是否按專案報告？ |
在專案中聊天 | 是 |
專案中的統一聊天和 Cowork 體驗 | 是 |
電腦上的 Cowork 任務 | 是。更新至 Claude Desktop 3.6556.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。名稱為小寫且不含空格，之後無法變更名稱。在允許的值下，選擇「僅預先定義的值」讓使用者從您的清單中選擇，或選擇「任何值」讓他們輸入自己的值。
如果您選擇了「僅預先定義的值」，請在值下新增您的清單。每行輸入一個值，或新增一個 CSV 檔案，其中包含以
value作為標題的單一欄。（選用）開啟「必需」切換開關，讓使用者在新專案上設定值。
按一下「繼續」。
若要稍後新增值，請在專案標籤頁面上開啟標籤，然後按一下「新增值」或「匯入 CSV」。
注意：標籤名稱和值對組織中的所有使用者都可見，因此請勿在其中包含敏感資訊。
將標籤新增至專案
任何具有「可編輯」存取權限的人都可以將標籤新增至專案：
開啟專案。
在標籤下，按一下「新增標籤」。
選擇標籤，然後選擇或輸入值。
注意：標籤名稱和值對組織中的所有使用者都可見，因此請勿在其中包含敏感資訊。
為 Claude Code 設定專案
Claude Code 沒有專案選擇器，因此使用者在設定檔中設定專案。如果未設定專案，Claude Code 使用情況不會被標記，也不會有警告，因此請告知您的使用者。
在 Claude 中開啟專案並複製其 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 仍會顯示其實際名稱。
閱讀數字時請記住以下幾點：
在工作開始前新增標籤。支出只有在標籤生效後才會計入標籤，這大約需要兩小時。該專案中的早期支出不會計入其中。
沒有使用情況的專案不會出現。專案在您選擇的日期內被使用後才會顯示。
報告從專案標籤對您的組織可用時開始。不要將較早的日期視為完整歷史記錄。
新標籤大約需要兩小時才能顯示。該時間窗口內的使用情況可能會保留在先前的標籤或無標籤下。
變更標籤不會變更過去的支出。使用情況會保留在專案當時擁有的任何標籤下。
專案外的支出顯示為「不在專案中」。這包括未設定專案的 Claude Code 工作階段。專案中沒有標籤值的支出顯示為「無標籤值」。
金額可能與您的發票不符。金額在您的折扣後和信用額度前顯示，最近的數字可能會在月底後約一週內變更。
座位涵蓋的使用情況不計算在內。主要在座位上使用的專案可能顯示很少或沒有支出。
使用 API 管理標籤和提取支出
您可以從自己的系統設定標籤和提取支出。兩個 API 都處於測試版，因此路徑和名稱可能會變更。您的主要擁有者在組織設定 > 組織 > API 中建立 API 金鑰。
使用管理 API 設定標籤
建立具有 read:project_tags 和 write:project_tags 範圍的金鑰。管理 API 可以列出您的標籤、將值新增至標籤的清單，以及設定專案的標籤。它無法建立標籤、封存值或建立專案。
POST /v1/organizations/apps/projects/claude_proj_.../tags
Header: anthropic-beta: ce-project-tags-2026-10-09
Body: {"tags": {"cost_code": "CC-1042"}}
管理 API 使用 claude_proj_ ID，而不是專案 URL 中的 ID。若要列出 ID，請使用至少一天前的日期呼叫 GET /v1/organizations/analytics/apps/chat/projects?date=YYYY-MM-DD。它只傳回在該日期有聊天活動的專案。此呼叫需要 read:analytics 範圍，因此請開啟分析 API 並將該範圍新增至您的金鑰。
使用使用情況和成本報告提取支出
開啟分析 API 並建立具有 read:analytics 範圍的金鑰。每次呼叫最多可涵蓋 31 天的每日值區，因此請使用它們來提取完整月份。
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 中傳輸，因此可能會出現在請求日誌中。
目前的限制
共享：標籤名稱和值對組織中的所有使用者都可見，因此請勿在其中包含敏感資訊。
編輯：任何可以編輯專案的人都可以變更其標籤，除非是必需的，否則可以清除一個。您無法鎖定標籤。
必需標籤：這些只適用於在網路上建立的新專案，因此現有專案不受影響。在網路上，必需標籤的值可以變更但不能移除。管理 API 仍然可以移除它。
字元：值最多可以是 256 個字元，可以包含空格和逗號。依賴隱形字元的值（例如組合表情符號或某些波斯語或僧伽羅語單詞）會被拒絕。
本測試版未包含：單一聊天或工作階段上的標籤、跨標籤分割支出、重新命名標籤或值，以及按標籤的支出限制。
常見問題
一個專案可以有多個標籤嗎？
是的，使用單獨的標籤，例如 cost_center 和 client_matter，每個專案最多 16 個。每個標籤只保留一個值，因此專案的支出無法跨同一標籤的兩個值分割。
Claude 會檢查我們的標籤值嗎？
否。清單限制使用者可以選擇的內容，但值不會針對您的財務系統進行檢查。
我如何關閉專案標籤？
專案標籤在擁有者建立標籤之前不會變更任何內容。若要關閉它們，請聯絡您的帳戶團隊。