# AI 用量与预算

查看各项目、模型和代理的 token 用量、预估费用和活动。

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

## 阅读报告

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

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

## 理解费用估算

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

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

## 设置项目预算

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

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

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