Claude 项目标签怎么用？成本归集、Code 配置与报表边界

哪些组织和角色可以使用？

官方当前说明将项目标签列为 Claude Enterprise Beta，合资格组织自动具备入口，无需单独开启。采用 HIPAA 配置、客户管理加密密钥（CMEK）、零数据保留（ZDR，含 Claude Code ZDR）、最少数据保留，或把数据存储在美国以外的组织不适用；Claude Desktop 经组织自己的模型提供方路由也不适用。

数据存储地点是组织的数据驻留条件，不能改写成用户必须在美国，也不能靠更换出口改变资格。文档未单列此功能价格或逐国家开放名单；页面仅标注“本周更新”，不能据此确定精确上线日或每个组织到账时间。

创建标签和管理取值需要 Primary Owner、Owner 或具有 Owner access 的自定义角色。设置某个项目的标签需要 Can edit 权限；查看按标签消费需要上述 Owner 角色，或同时具有 Analytics view 与 Billing view 的自定义角色。只有 Primary Owner 能创建 API keys。

先建成本代码，再给项目选值

Owner 在 Organization settings > Organization > Project tags 创建标签，例如 cost_code。名称必须小写且无空格，创建后不能改名；可限定 Predefined values only，或允许 Any value。预定义列表可逐行填写，也可导入只有一列、列头为 value 的 CSV。

项目编辑者在项目的 Tags > Add tag 中选择标签和值。每个项目最多 16 个标签，每个标签仅一个值；例如 cost_code=CC-1042 是官方示例格式，不代表真实财务代码。名称和值对全组织用户可见，不要放客户秘密或其他敏感内容。取值最长 256 个字符，可含空格和逗号，但依赖不可见字符的值可能被拒绝。

哪些工作会归到项目，哪些不会？

项目内聊天，以及项目中的统一 chat 与 Cowork 体验支持项目归集。本机 Cowork 任务需更新到 Claude Desktop 3.6556.1 或更高版本，并为任务选定一个项目。终端或桌面 Claude Code 也支持，但需先设置项目；要求 Claude Code 2.1.305 或更高版本，或 Claude Desktop 3.6556.1 或更高版本。

本次 Beta 不覆盖网页 Claude Code、Claude for Office、Claude in Chrome、Claude Design、Claude in Slack 和 Microsoft Teams、Artifacts、Voice mode，也不覆盖 Claude API 或 Claude Console。通过 Amazon Bedrock、Google Cloud Vertex AI、gateway 或 API key 使用的 Claude Code，同样不在范围内。

项目外工作不会获得项目标签。先确认实际产品入口和会话归属，再解释缺失消费；不要把安装客户端、打开项目或设置一个标签，当作所有产品用量都已归集。

Claude Code 要明确设置 attributionProject

Claude Code 没有项目选择器。打开 Claude 项目，复制 URL 最后一段项目 ID，再在仓库的 .claude/settings.json 中设置；需要跨仓库使用时，官方给出的路径是 ~/.claude/settings.json。

配置示例：{"attributionProject":"PROJECT_ID"}。把 PROJECT_ID 替换为项目 URL 的 ID，并保持整个文件为有效 JSON，不要把示例当作可直接追加到任意位置的一行文本。仓库级配置需在 Claude Code 提示时信任该文件夹，之后设置才生效。

未设置项目时，Claude Code 用量不会被打上项目标签，而且不会警告。管理者应让使用者知道这一条件；本文仅核对公开文档，没有修改配置、打开组织后台或运行真实会话。

报表为什么缺行，或与账单对不上？

在 Organization settings > Usage > Spend by project，以 Group by 选择标签，再用 Period 和 Product 缩小范围。数据截至昨日结束（UTC），不是实时余额；可用 Export CSV 导出已有结果。

标签约两小时生效，应在工作开始前设置。更早的消费不会追溯归入新标签；修改标签也不会重写过去消费，生效窗口内用量可能留在旧标签或无标签项。报表历史从组织获得此功能时开始，不能把更早日期当完整记录。

所选日期内没有使用的项目不显示。项目外消费显示 Not in a project，包含没有绑定项目的 Claude Code 会话；项目已存在但没有该标签值时，显示 No tag value。缺行或延迟不能直接解释为零消费。

金额已计入折扣、尚未扣除 credits，近期数字到月末后约一周内仍可能变化。席位覆盖的用量不计入，主要由席位覆盖的项目可能显示很少或没有消费。因此这是有范围的归集报表，不是完整发票、席位使用量或按标签预算上限。

接入 API 前，区分权限、ID 与分页

项目标签 Admin API 与用量成本 API 均为 Beta，路径和名称可能变化。标签读写使用 read:project_tags 与 write:project_tags scope；当前可列出标签、添加取值并设置项目标签，不能创建标签、归档取值或创建项目。API 使用 claude_proj_ ID，不是项目 URL 的 ID，不能照搬 attributionProject 的值。

成本报表需要开启 Analytics API，并使用 read:analytics scope。按日桶每次最多覆盖 31 天，每次最多返回 1000 行；has_more 为 true 时必须继续分页，不能把第一页当总额。金额单位为美分，可含不足一美分的小数；标签筛选文本进入 URL，可能出现在请求日志中。需要集成时以官方当前 Beta 说明核对，不公开真实 key、成本代码或原始组织报表。