用量与限额

从侧边栏或命令面板打开用量；在 Web 应用和桌面应用上，当终端未处于焦点时，也可以按 mod+u。在设置 → 快捷键中自定义 usage.open。

在移动应用上，于工作区导航中选择用量。

了解你的用量

用量汇总来自已连接环境（environment）的 Codex、Claude Code、Grok Build、OpenCode、Antigravity、Pi、Muse Code 和 Cursor 历史。它显示 token 用量、缓存节省、模型明细，以及按 API 等价估算的费用，并按 token 类型和速度拆分。这些估算不是你的订阅账单。溢价是 Fast 和 Ultrafast 请求超出标准费率的费用。无法拆分的费用，例如提供方（provider）针对没有公开费率的模型所报告的费用，显示为其他。在明细下选择一个模型，即可查看它的趋势、缓存命中率，以及每百万 token 的费用。

合计取决于每台服务器上可用的历史。没有保存已完成回合（turn）记录的 Grok 回合，不会计入合计。文本生成（对话线程（thread）标题、提交说明、PR 文本、分支名称和审查指南）不计入 Codex，也不计入 Claude Code 2.0.63 及更新版本的合计，因为这些运行不保存提供方会话（session）历史。

OpenCode 读取它的 SQLite 数据库和较旧的 JSON 历史。Antigravity 读取本地对话数据库，包括 T3 管理的配置档案。在服务器上设置 OPENCODE_DATA_DIR 或 ANTIGRAVITY_DATA_DIR，即可读取另一个数据目录；以逗号分隔的路径会读取多个目录。

Cursor 通过 Cursor 的 API 读取账号用量，对应你在 T3 中登录的账号，或设为 CURSOR_API_KEY 的账号。这包括无头 T3 提供方会话，以及跨机器的桌面用量；同一账号在已连接的环境之间只计一次。T3 不会根据对话文本估算缺失的 token。

用量包含每个已配置账号的历史，包括已禁用的账号。自定义主目录遵循该账号的主目录设置，或其 CODEX_HOME、CLAUDE_CONFIG_DIR 或 GROK_HOME 环境变量。Pi 读取 ~/.pi/agent/sessions，或 sessions 目录，该目录位于 PI_CODING_AGENT_DIR 之下。设置 PI_CODING_AGENT_SESSION_DIR，即可读取另一个提供方会话目录。若要纳入通过 --session-dir 或 Pi 的 sessionDir 设置保存的提供方会话，请把该环境变量设为同一个目录。Pi 会在 Tools/summaries 下计入已记录的工具费用和摘要费用。Muse Code 从已配置的 Muse CLI 所报告的主目录读取原生提供方会话历史，包括子提供方会话。它的环境设置（包括 XDG_DATA_HOME）会生效。没有已知价格的模型仍会计入 token，并显示为未定价；设置自定义价格即可估算其费用。在账号的环境设置中使用绝对路径或 ~/ 路径；相对的环境路径取决于每个项目（project）的工作目录，用量无法可靠地发现它们。共享同一个历史目录的账号只计一次。

服务器把首次使用的主机名保存在 <T3 home>/usage-host-id 中，因此当 T3 主目录被持久保存时，重建后的容器会保留它的用量身份。设置 T3CODE_HOST_ID，即可显式选择该身份。

当你的应用和服务器所支持的提供方不同时，用量合计可能只覆盖你的应用能够识别的提供方。更新应用，以纳入新支持的提供方。

在 Web 和桌面上，用环境下拉菜单筛选费用、token 和限额。默认选中全部环境。下拉菜单会显示哪些环境仍在扫描；每个环境一响应，结果就会出现，仍在更新的数字会变暗。Cursor 先显示上次保存的合计，再在 Cursor 的 API 响应时更新这些数字。

如果最近的工作没有出现，或某个新模型没有显示费用，请刷新，以重新扫描提供方会话历史并更新模型定价。

设置自定义模型价格

在 Web 或桌面上，打开用量中的环境下拉菜单，然后选择模型价格，以添加、编辑或重置某个模型的估算价格。应用到一开始就是你当前的用量筛选；可以选择全部环境（environment），也可以逐个选择目标。输入准确的模型 ID，以及每百万输入 token 和输出 token 的美元费率。可以输入任何模型 ID，包括没有公开定价的模型。当用量上的某个模型没有已知价格时，在明细下选中它，再选择设置价格，即可打开已经加入该模型的这张表。

缓存读取费率和缓存写入费率是可选的，留空时使用输入费率。对于免费的 token，输入 0。保存的价格会替换该环境全部历史记录的自动定价，并与连接到该环境的客户端（client）共享。当各环境的价格不同时，单元格显示混合。直接在表中编辑费率，然后选择保存更改，以应用所有已编辑的行。未改动的单元格保留各环境自己的费率。选择一个环境，即可查看它的价格。重置为自动会把某个模型的覆盖项标记为保存时移除；保存之前可以撤销。

若要把一个模型计成另一个模型，例如把预览版模型计到它的正式名称之下，请在映射到中输入目标模型 ID。被映射的模型不再出现在用量上：它的 token 和费用会转移到目标模型，并使用目标模型的价格。清除映射到，或重置该行，即可再次单独显示这个模型。

每个目标都会报告这次更改是否已保存。离线或不可用的环境标记为未保存。重新连接它们，然后选择重试失败的保存，即可完成同一次更改，并且不会再次写入已经保存成功的环境。关闭对话框之后，这些更改不会继续排队。

只显示部分模型

若只统计部分模型，或排除部分模型，请把 usageModelFilter 添加到服务器的 settings.json 中，该文件位于它的 userdata 目录，例如 ~/.t3/userdata/settings.json：

{
  "usageModelFilter": {
    "include": [{ "provider": "claude", "model": "orbit-1" }, { "model": "orbit-2" }],
    "exclude": [{ "model": "drift-9" }]
  }
}

include 只保留列出的模型，exclude 则排除列出的模型。provider 是 claude、codex、cursor、grok、opencode、antigravity、pi 或 muse 之一；省略它，即可匹配任意提供方（provider）的模型 ID。使用用量在没有映射到时所显示的模型 ID，例如 Pi 带提供方前缀的 ID。筛选在映射到之前生效，因此你排除的模型不会按其映射后的名称计入。用量应用每个环境自己的筛选。移除该设置，即可再次显示全部模型。

如果该设置无效，用量会忽略它并显示全部模型，而且下一次保存任何其他设置时，会把它从 settings.json 中移除。

跟踪订阅限额

用量 → 限额按提供方（provider）把所能看到的每一个订阅账号汇入同一个池。因此，当已启用的环境（environment）和枢纽中有多个 Codex 或 Claude 账号时，每个时间窗读到的是一个数字，而不是一份列表。每张时间窗卡片显示池中还剩多少，以及一根按账号分段的条；各账号在不同时间窗中保持在同一列。账号按其下一次 5 小时补充的时间排序，最近的排在前面。对于周配额已经用尽的账号，这个时间就是它的提供方会话（session）可以再次使用的时刻。如果没有任何账号报告 5 小时限额，就使用第一个可用的时间窗。出现空缺，表示该账号不报告这个时间窗。当提供方报告重置时间时，卡片还会说明下一次重置在什么时候到来，以及会返还多少。分段中画有斜线的部分，就是这次重置所恢复的量。点按某一段或账号行，可查看该账号的套餐、登录位置和重置时间。在 Web 上也可以悬停查看。拥有已累积重置额度的 Codex 和 Claude 账号，会在账号详情中显示票据数量和使用重置操作。当服务器运行在 macOS 上时，Claude 的重置不可用，因为 Claude 把登录信息保存在钥匙串（Keychain）中。在窄屏幕上，条下方带编号的行会显示每个账号的配额、倒计时和额度。点按某一行即可打开它的详情。

同一个账号在不止一个环境中登录，或同时也由某个枢纽报告时，只计一次。用环境下拉菜单筛选，即可查看单台机器上的情况。

当某个 Claude 或 Codex 账号的总体周配额已经用尽时，它汇入池中的会话贡献显示为剩余 0%。下一次补充取决于两个重置时间：已经耗尽的提供方会话也必须重置，而只消耗了一部分的提供方会话，可能要等到这一周重置时，才能收回尚未使用的那一部分。重置时间缺失或已经过期时，没有补充估算；请刷新限额以取得新的读数。Claude 按模型划分的每周额度保持其报告的数值。

打开限额时，会自动检查所选中的已连接环境。每个客户端（client）对同一个环境的自动检查至少间隔五分钟，检查失败之后也是如此。如果某个时间窗看起来仍然过期，请刷新限额，重新检查每一个提供方和枢纽。

从 Composer（编写器）的命令（command）菜单中选择 /usage-limits，或把它作为一条消息发送，即可在不离开对话的情况下检查当前模型的限额。结果在编写器上方打开，并在你把它关掉或发送下一条消息时关闭。它使用与用量 → 限额相同的快照，因此不会运行智能体，也不会刷新任何内容。该命令只对出现在用量 → 限额下的提供方提供。

若要在 Web 和桌面上让这些限额保持可见，请在设置 → 外观 → 对话线程（thread）详情中打开用量限额，或右键单击对话线程详情卡片。对话线程详情卡片的底部随后会显示，当前提供方账号的每一个限额时间窗还剩多少。有些时间窗只统计一个模型，例如每周的 Opus 限额。悬停在某一行上，可查看它何时重置，以及你的消耗节奏。打开上下文窗口，还会显示该对话线程的上下文用量相对于模型上限的情况。如果提供方报告了自动压缩的位置，条上的刻度会标出这一点。

当 OpenCode 在该环境中本地运行时，OpenCode Go 会报告它的会话额度、每周额度和每月额度。T3 无法报告外部 OpenCode 服务器的限额，因为它们的凭据属于远程服务器。限额需要一把 OpenCode Go API 密钥，或者在 OpenCode 中连接了带 API 密钥的 OpenCode Console。仅通过 Console 的浏览器登录，并不会报告这些限额。你也可以把 Go 的 API 密钥作为 OPENCODE_API_KEY，添加到该 OpenCode 提供方实例的环境变量中，然后刷新提供方状态。Cursor 会报告月度额度，并把 Auto 用量和 API 用量分开计算：如果设置了 CURSOR_AUTH_TOKEN，就针对该值，否则针对你在 T3 中登录的账号，或设为 CURSOR_API_KEY 的账号。登录和 API 密钥只有在使用 Cursor 的默认 API 端点时才会报告限额。如果配置了自定义的 Cursor 端点，请为限额显式设置 CURSOR_AUTH_TOKEN。

使用 grok login 登录之后，Grok 会报告当前计费周期内剩余的订阅额度，以及重置时间。显式的 XAI_API_KEY 连接，以及自定义的身份验证或端点配置，不会报告订阅限额。

一旦 Muse CLI 在某个对话线程中运行过，Muse Code 就会报告它的会话时间窗、每周时间窗以及等级。在此之前，它不显示限额。读数不会保留到服务器重启之后。

使用 API 密钥的账号可能不会报告订阅限额。通过 ANTHROPIC_AUTH_TOKEN 使用代理的 Claude 连接也同样如此。

连接 CLIProxyAPI 枢纽

要查看汇入池中的账号，请打开设置 → 提供方（provider）→ 用量提供方 → 添加枢纽。选择将要连接到该枢纽的环境（environment），并输入它的 URL 和管理密钥。

该枢纽的 Codex、Claude、xAI（显示为 Grok）和 Antigravity 账号会出现在用量 → 限额下；其他提供方的账号不会被读取。Codex 账号会显示已累积的重置额度；选中一个账号并选择使用重置，即可兑换一次。不需要枢纽插件。

此连接提供的是用量信息；若要通过该枢纽发送智能体请求，请另行配置提供方。不再需要时，从同一处设置中移除该枢纽。

订阅用量小组件

从 iOS 或 Android 的小组件库中添加订阅用量，即可查看剩余的 Codex 和 Claude 配额。点按它会打开用量 → 限额；在 Android 上，T3 正在后台运行时这样可以打开，否则请从启动器打开应用。在 iOS 上，使用编辑小组件，为每个提供方（provider）选择会话（Session）、每周（Weekly），或两者都选。重新打开 T3，以刷新已经过期的读数。

键盘快捷键

在 Web 和桌面上，从命令（command）面板打开用量。位于用量页面，且当前没有在字段中输入时，按 C、T 或 L，分别对应费用、Token 或限额。使用 Ctrl+Shift+1/2/3/4（在 macOS 上为 Cmd+Shift+1/2/3/4）切换过去 24 小时、7 天、30 天或 90 天。时间段快捷键在限额页不起作用。按 Escape 返回上一页。在设置 → 快捷键中自定义这些快捷键。