AI 用量与预算

从助手的用量计数器打开用量报告。它把内置助手和 CLI 代理的活动汇集在一个视图中，包括已完成的工作，以及用掉了 token 的中断运行。

阅读报告

可以按项目、代理、提供商、模型或会话筛选，并用开始日期和结束日期，或 7 天、本月等快捷范围设置日期。日期和小时均为 UTC。每日 token 和按小时的活动显示工作发生的时间；分组汇总帮助你比较用量花在了哪里。导出 CSV 会保存报告。

当运行时提供数据时，报告会区分输入、输出、缓存读取和缓存创建。一项度量可能是已报告、估算或不可用。未知表示运行时没有提供足够的信息，并不表示为零。

理解费用估算

API 费用估算使用可获得的模型价格和 token 度量。CLI 代理可能使用订阅或其他计费方式，它们的 token 数量既不是账单，也不能衡量账户的剩余额度。

实际收费请查看提供商自己的账单页面。

设置项目预算

打开项目后，在设置 → AI 助手 → 提供商与密钥下设置 AI 预算。输入以美元为单位的金额并选择保存预算；清除预算会将其移除。该卡片会显示目前的预估花费。

项目预算可以在已记录的用量达到限额的 80% 时，在内置助手开始运行之前发出警告，并在达到限额时阻止新的运行。它是开始工作前的一次检查，而不是在回复过程中强行切断。

预算检查不涵盖每一种外部代理或研究任务运行时。如果你需要由服务强制执行的消费上限，请使用提供商一侧的限制。