告别额度焦虑！Claude Code 里实时查看 GLM Coding Plan 剩余额度

SchneiderABB
0 阅读7分钟

告别额度焦虑！Claude Code 里实时查看 GLM Coding Plan 剩余额度

5h限额+周限额+重置时间，国内/国际套餐全支持，Claude Code 底部状态栏一目了然

前言

🍊 缘起

你是不是也有过这样的经历：

正沉浸在 Claude Code 里写着代码，思路如泉涌，突然终端弹出红色警告——“额度已用完”。

那一刻，你愣住了。看看时间，明明才用了一个多小时，怎么额度就没了？

更难受的是，你根本不知道还剩多少，只能频繁去官网查，或者等到断掉那一刻才恍然大悟。

于是vibe coding个小工具。glm-quota-line，一个轻量级的命令行工具，能在 Claude Code 终端底部实时显示 GLM Coding Plan 的剩余额度。

效果是这样的：

用量截图.png

截屏2026-04-05 21.41.12.png

一、痛点：额度，一个被忽视的“隐形炸弹”

GLM Coding Plan 的计费方式很特别——不是按 token 实时扣费，而是 5小时滚动额度 + 每周限额 的双重机制。

这意味着：

  • 你有一个 5 小时的“时间池”，用完得等刷新（工具会显示剩余百分比和重置时间）
  • 每周还有总量上限，超了也得等周期重置

问题在于：官方没有提供一个直观的方式让你随时查看剩余额度。

你只能：

  • 去官网登录查看（麻烦，打断思路）
  • 等额度用完被踢下线（被动，体验极差）
  • 凭感觉估算（不靠谱）

对于重度使用 Claude Code 的开发者来说，这就像一个没有油量表的车——你永远不知道下一秒会不会抛锚。

二、解决方案：glm-quota-line

所以我写了 glm-quota-line。

它能做什么？
  • 📊 实时显示剩余额度：在 Claude Code 终端底部，一条状态栏告诉你还剩多少
  • 🎯 5h限额 + 周限额：同时展示两个维度的剩余情况
  • ⏰ 重置时间提示：5h限额的刷新倒计时，心里有数
  • 🌐 国内+国际套餐全支持：自动识别 open.bigmodel.cn 和 api.z.ai 两个端点
  • 🎨 三种显示风格：完整信息版、简洁版、进度条版，满足不同审美偏好
  • 🔄 智能缓存：按会话和 token 用量智能刷新，新会话不会显示旧配额，自动获取官方接口数据
  • ⚡ 零依赖：无运行时依赖，单一用途，轻量高效
三种显示风格一览

工具支持三种样式，通过 glm-quota-line config set style 一键切换：

① style=text（默认）—— 完整信息版

GLM Lite | 5h 91% | week 47% | reset 14:47
同时显示 5 小时配额（主要）和周配额（次要），并自动展示重置时间。

style=compact —— 简洁版
GLM 5h 91% W 47% | 14:47
紧凑布局，适合屏幕空间有限的终端。

style=bar —— 进度条版
GLM Lite █ 91% | W 47% | 14:47

最直观的视觉反馈，一眼判断剩余量。

💡 推荐搭配：深色终端选 style=bar, theme=ansi, palette=dark，浅色终端选 style=compact, theme=ansi, palette=mono

三、3 分钟快速上手

第 1 步：确保 Claude Code 已配置 GLM Coding Plan

所有平台（Windows / macOS / Linux）配置方式完全一致：只需在用户目录下的 .claude/settings.json 文件中加入环境变量。

# claude配置文件路径
~/.claude/settings.json

编辑该文件（若不存在则新建），填入以下内容：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
        "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic"
    }
}

💡 提示：API Key 可在智谱开放平台获取

⚠️ 如果你使用 cc switch 等代理工具，工具会自动读取这些环境变量，无需额外配置。若自动读取失败，可参考下面的“手动配置”章节。

第 2 步：安装 glm-quota-line
npm install -g glm-quota-line
第 3 步：一键安装到 Claude Code
glm-quota-line install

这个命令会自动：

  • 检测你的 Claude Code 环境
  • 将额度显示功能集成到底部状态栏
  • 通过 SessionStart hook 预刷新缓存，新会话不会显示旧配额
  • 完成配置，即刻生效
第 4 步：启动 Claude Code
claude

现在你的 Claude Code 终端底部就会实时显示 GLM 剩余额度了！

手动配置（解决代理/特殊环境问题）

如果工具无法自动读取环境变量（例如运行在代理网关后面，注入的环境变量不是实际值），或者你想覆盖默认配置，可以使用以下命令手动设置：

# 设置 API Key
glm-quota-line config set auth-token YOUR_API_KEY

# 设置 Base URL（国内/国际二选一）
glm-quota-line config set base-url https://open.bigmodel.cn/api/anthropic   # 国内
# 或
glm-quota-line config set base-url https://api.z.ai/api/anthropic           # 国际

# 手动保存的值优先级高于 Claude 注入的环境变量
# 查看当前配置
glm-quota-line config show

这种方式完美兼容 cc switch 等代理模式——即使 ANTHROPIC_BASE_URL 被改成了 localhost，你依然可以手动指定真实的智谱端点。

其他进阶命令
# 切换显示风格（text / compact / bar）
glm-quota-line config set style bar

# 切换配色方案（plain / ansi）
glm-quota-line config set theme ansi

# 切换色板（dark / mono）
glm-quota-line config set palette dark

# 检查更新
glm-quota-line check-update

# 卸载
glm-quota-line uninstall

四、国内+国际套餐全支持

很多开发者使用 cc switch 等工具来切换 API 代理，这通常会修改环境变量中的 ANTHROPIC_BASE_URL 为 localhost 地址。

glm-quota-line 提供了两种兼容方案：

  1. 自动识别：直接从环境变量读取，无论 Base URL 是指向智谱官方地址还是本地代理，都能正确工作。同时支持国内端点 open.bigmodel.cn 和国际端点 api.z.ai 的自动识别。
  2. 手动覆盖：如果自动读取失败（例如代理网关隐藏了真实端点），使用 glm-quota-line config set base-url 手动指定即可。手动保存的值会优先使用。
# 使用 cc switch 后，依然可以正常工作
glm-quota-line install   # 自动模式
# 或手动指定
glm-quota-line config set base-url https://open.bigmodel.cn/api/anthropic

五、效果对比

场景使用前使用后
想知道还剩多少额度打开浏览器→登录官网→找到页面看一眼终端底部
额度快用完了不知道，直到被踢下线进度条变红，提前预警
高频使用频繁查询，打断思路静默显示，零打扰
切换代理/套餐担心配置失效自动适配，无需重配
新会话启动手动查额度SessionStart hook 自动预刷新

六、开源与社区

项目已在 npm 和 GitHub 开源：

目前已迭代到 v0.8.0，核心功能稳定，持续优化中。

如果你：

  • 遇到了 bug → 欢迎提 Issue
  • 有改进想法 → 欢迎提 PR
  • 觉得有用 → 给个 Star ⭐️

七、常见问题

Q：支持哪些套餐？
A：完整支持 GLM Coding Plan Lite、Pro、Max 全系列套餐，国内和国际端点均支持。

Q：兼容 cc switch 吗？
A：兼容。工具支持自动读取环境变量，也支持手动指定 Base URL，两种方式都能完美工作。

Q：需要额外配置 API Key 吗？
A：通常不需要。只要你按文章配置好了 ~/.claude/settings.json，工具会自动读取。如果读取失败，使用 glm-quota-line config set auth-token 手动设置即可。

Q：Windows 上配置文件路径也是 ~/.claude/settings.json 吗？
A：是的，Claude Code 在 Windows 上也支持 %USERPROFILE%.claude\settings.json，同样可以用 ~ 表示用户目录。完全一致。

Q：会影响 Claude Code 性能吗？
A：不会。工具极其轻量，采用智能缓存机制，只在终端 UI 层增加一个状态栏显示，无性能损耗。

Q：怎么更新到最新版本？
A：执行 npm install -g glm-quota-line 更新，然后运行 glm-quota-line check-update 验证。

Q：怎么卸载？
A：执行 glm-quota-line uninstall 即可。

总结

glm-quota-line 纯javascript实现，仅仅为了实现功能，不过度引入依赖。它只是vibe coding出来的小工具，但解决了一个真实存在的痛点——额度焦虑,至少我之前是会频繁刷新页面看额度。

特别值得一提的是，它通过直接读取 Claude Code 环境变量的方式，实现了：

  • 零配置：配好 Claude Code 就能用，无需额外配置
  • 跨平台：国际/国内线路、代理模式全兼容
  • 轻量级：不增加任何额外负担
  • 多风格：三种显示样式自由切换，适配你的终端主题
  • 精准性：同步自官网接口数据，非估算，精准且及时

希望这个小工具能帮到你。

avatar
文章
阅读
粉丝