本地用量

你会看到什么

每一轮可以记录输入 token、缓存读取 token、输出 token、推理 token、模型调用次数、API 时间，以及可选的费用估算。/usage 和 /usage show 打开这份账本。

看到什么取决于屏幕模式：

• 全屏 — 一个模态框。/usage 落在 Usage limit 标签。有用的是会话用量块（以及 Context usage / Session info 标签）。Usage limit 标签仍可能留下账号额度文案，例如 No billing data available. 或 Usage limits are managed by your team. 那些行不是 MatchaCode 订阅，也不是操作步骤。忽略它们。
• 极简 — 同一段会话用量文本作为系统块写入回看区。没有计费后续步骤。

典型的会话用量文本：

Session usage (since start or last resume):
  Input tokens:   1,234,567 (1,000,000 cached)
  Output tokens:  45,678 (12,000 reasoning)
  Total tokens:   1,280,245
  Model calls:    42 · API time: 3m12s
  Cost:           $1.2345

若本会话里换过模型，会追加 By model: 分解。第一次模型调用之前：

Session usage: no model calls yet in this session.

费用是服务商在本会话账本里上报的值。服务商省略时（Ollama 的内置描述符不声明用量；有些网关跳过费用），该行是 not available (not reported) —— 这不是说这次调用免费。跟踪不完整会被点出来，绝不会暗示为零。

会话无法提供本地诊断时，/usage 会被隐藏或拒绝（/usage is not available. / Local usage diagnostics are unavailable.）。

相关的、仅本地命令：

• /context — 上下文窗口分解（系统提示、消息、推理开销、剩余空间），外加工具、技能和 MCP 公告的信息行。
• /session-info — 鉴权方式、模型、轮次计数、上下文用量。
• /privacy — 设置里的 Coding data (local) 行。提示、traces 和指标留在这台机器上。不提供远程分享和训练选择加入。

你在压缩、提高力度、或把助手换成更便宜的模型之前，跑 /usage 是为了知道这段对话已经多重。那是本地转向信号。向服务商付费仍发生在该服务商自己的站点或发票上 —— Matcha CLI 不代收。

显示本会话账本

在 TUI 里：

/usage
/usage show
/cost

全屏时，在模态框里切到 Context usage 或 Session info 标签，可看窗口占用或会话元数据，而不是账本。极简模式里，读回看区里的系统块。

把数字当成本地诊断来读

• Input / cached — 已发送的 token，包括服务商上报的缓存命中。
• Output / reasoning — 补全 token；模型上报时，推理是其中的子集（见「推理力度」）。
• Model calls / API time — 服务商往返次数，以及花了多久。
• Cost — 按上报刻度的本地估算，或 not available。

不要把这块当成周额度、SuperGrok 配额或 MatchaCode 账单。

不要去管理计费，改做这些

/usage manage 不可用。要理解或支付服务商花费，用该服务商自己的控制台（xAI、OpenAI、Anthropic、你的网关）。Matcha CLI 不会打开产品计费 URL。

要降低接下来几轮的本地花费：用 /model 选更便宜的 id，降低 /effort，或 /compact 让后续提示少带历史。

别让秘密进到会分享的日志

本地日志可用 MATCHA_LOG_FILE 写出。崩溃转储留在磁盘上。不要把 API Key 放进你会分享的路径。本篇不会上传那些文件。

Matcha CLI 不会做什么

你仍可能看到 Usage limit 这类遗留模态标签。它们不是操作步骤，也不是 MatchaCode 账单。