Claude Code 使用状态栏

用图标替代标签

• ⌛ 5 小时滚动窗口
• 📅 7 天窗口，涵盖所有模型
• F 当前模型的使用量，这里是 Fable
• 💰 剩余余额或额度
• 💸 会话费用，适用于按 API 计费的账户
• 🧠 上下文窗口

每个模型的使用量仍保留一个首字母（F、s、o），而不是图标：标签来自 API，并会随模型变化，固定图标最终会产生误导。

三种操作系统均可正常显示

在 Linux 下，旧版会话符号显示出来是一个方框。这不是编码问题，输出确实是 UTF-8：该字符属于一个等宽字体根本不支持的 Unicode 区块。

所选图标默认采用彩色显示的 emoji，因此会根据系统由 Segoe UI Emoji、Apple Color Emoji 或 Noto Color Emoji 负责渲染。在精简版 Linux 发行版上，安装 fonts-noto-color-emoji 即可解决。

按模型和额度显示用量

对于已迁移的账户，Anthropic 不再返回 Sonnet 和 Opus 两个固定用量条，而是返回与当前模型关联的每周窗口。因此，显示的字母会跟随模型变化，F 代表 Fable。

当窗口达到上限并由额度接替时，💰 段会切换到详细模式，显示已用额度、上限和剩余额度：💰 €12.56/€14 (left €1.44)。未迁移的账户仍保留旧版显示方式，使用 s 和 o。

简化目录显示

状态行不再显示 ~/My Projects/Brol，而只显示 Brol。在已经定位于项目目录的终端中，完整路径很少有用：简短的目录名足以帮助定位，还能为指标信息腾出空间。

当数据已过期时，也就是缓存已失效但 API 正处于 429 backoff 状态或不可用时，某个值前会显示 ~ 前缀（例如 ~5%）。

自动检测项目

显示当前目录的名称（路径的最后一级）。您始终知道正在处理哪个项目，而不会让完整路径占据整行。

当前模型

直接在状态栏中查看正在使用的模型（Opus、Sonnet、Haiku 或 GLM）。提供商会自动检测。

使用百分比

显示 5 小时、7 天的窗口以及当前模型的用量（对于尚未迁移的账户，Sonnet 和 Opus 分开显示），并配有彩色指示器：绿色、黄色、红色。

倒计时

准确了解限制何时重置。每项相关指标旁都会显示 ↻ 倒计时。

上下文窗口

监控上下文窗口的使用情况，避免在对话过程中达到上限。

支持 z.ai / GLM

显示您的 z.ai 账户余额（💰 9.88$），并自动转换为您选择的货币（EUR、GBP、CAD……）。

过期数据指示器

数值前的 ~ 前缀表示缓存已过期，但 API 不可用（429 退避）。您始终清楚自己看到的是什么。

智能缓存与退避

每个 provider 缓存 1 分钟，以减轻 API 的负担。出现 429 时自动退避 5 分钟，避免触发速率限制。

零配置（Claude）

启动安装程序即可。它会自动从 ~/.claude/.credentials.json 读取您的 Claude 凭据（macOS 上还会读取 Keychain）。

步骤 1：获取 JWT

1. 在您常用的浏览器中打开 z.ai/manage-apikey/billing
2. 登录（如果要求，请完成验证码）
3. 使用 F12 打开 DevTools，进入 Network 标签页
4. 使用 F5 刷新页面
5. 点击名为 accountBalance 的请求
6. 在 Headers 中，复制 Authorization 的值，不包含 Bearer 前缀（令牌以 eyJhbGciOiJIUzUxMiJ9 开头）

步骤 2：保存 JWT

安装包中附带了一个配套二进制程序 ClaudeUsageStatusline.ZaiRefresh。它会验证令牌格式，并将其写入 ~/.claude/.zai-credentials.json。

Windows：

& "$env:LOCALAPPDATA\ClaudeUsageStatusLine\ClaudeUsageStatusline.ZaiRefresh.exe"

Linux / macOS：

~/.local/bin/ClaudeUsageStatusline.ZaiRefresh

第 3 步（可选）：显示货币

余额默认以 USD 返回。若要以 EUR（或其他货币）显示，请编辑可执行文件旁的 appsettings.json：

{
  "Zai": {
    "NativeCurrency": "USD",
    "DisplayCurrency": "EUR",
    "ExchangeRateCacheHours": 24
  }
}

汇率每天从一个免费的 API 获取一次，并在本地缓存。

何时刷新 JWT？

会话 JWT 没有明确的过期日期：其有效期由 z.ai 的服务器控制。经过一段时间的不活动或明确断开连接后，它最终可能会失效。

需要续期的迹象：

• 状态栏显示 z.ai: token missing，并提示您按照新窗口中的说明操作
• 过期数据前缀（~💰）持续存在
• 日志中包含 401 Unauthorized

在这两种情况下，ZaiRefresh 会自动在窗口中打开：您只需粘贴一个新的 JWT。