Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (claude-code-glm-statusline) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

claude-code-glm-statusline

English | 中文

Claude Code 自定义状态栏，专为 智谱 GLM Coding Plan 订阅用户设计。

实时显示模型信息、上下文使用率、5 小时 / 7 天配额用量，让你对 API 消耗一目了然。

效果预览

preview

📁 statusline | 🧠 glm-5.1 | 📋42% ██████░░░░ | ⏳5h 62% 2h30m | 📅7d 45% 5d12h | 🕐13:16

目录名 — 当前工作目录
模型 — 当前使用的 GLM 模型
上下文 — 上下文窗口使用率，带颜色进度条（绿→黄→红）
5h 配额 — 5 小时滑动窗口 Token 用量 + 重置倒计时
7d 配额 — 7 天滑动窗口 Token 用量 + 重置倒计时
时间 — 当前时间

前置条件

Node.js >= 18
Claude Code CLI
智谱 Coding Plan 订阅（开通地址）
智谱用量查询插件（glm-plan-usage） — 配额数据依赖此插件

安装用量查询插件： 推荐使用智谱官方一键安装助手自动配置：
npx @z_ai/coding-helper
进入向导后选择 插件市场 → 安装 glm-plan-usage 插件即可。

也可手动安装：
claude plugin marketplace add zai-org/zai-coding-plugins
claude plugin install glm-plan-usage@zai-coding-plugins
详见智谱官方文档 - 用量查询插件和一键安装助手

快速安装

npx claude-code-glm-statusline

安装完成后重启 Claude Code 即可看到状态栏。

手动安装

如果 npx 不可用，可以手动安装：

下载 src/statusline.mjs 到 ~/.claude/ 目录：

curl -o ~/.claude/statusline.mjs https://raw.githubusercontent.com/Darkycl/claude-code-glm-statusline/main/src/statusline.mjs

编辑 ~/.claude/settings.json，添加 statusLine 配置：

{
  "statusLine": {
    "type": "command",
    "command": "node ~/.claude/statusline.mjs"
  }
}

Windows 用户使用完整路径：

{
  "statusLine": {
    "type": "command",
    "command": "node C:/Users/<your-username>/.claude/statusline.mjs"
  }
}

配置环境变量

确保 ~/.claude/settings.json 中的 env 已配置智谱 API：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<your-api-token>"
  }
}

卸载

编辑 ~/.claude/settings.json，删除 statusLine 字段
删除 ~/.claude/statusline.mjs 和 ~/.claude/quota_cache.json

rm ~/.claude/statusline.mjs ~/.claude/quota_cache.json

工作原理

脚本从 Claude Code 的 stdin 读取 JSON 数据，提取模型和上下文信息
配额数据通过智谱平台 API (/api/monitor/usage/quota/limit) 获取
配额数据缓存 5 分钟，避免频繁请求
使用 ANSI 颜色编码和 Unicode 字符渲染进度条

常见问题

Q: 状态栏没有显示配额信息？

确保 ANTHROPIC_BASE_URL 指向 https://open.bigmodel.cn/api/anthropic，且 ANTHROPIC_AUTH_TOKEN 已正确设置。

Q: 支持 Anthropic 官方 API 吗？

配额显示功能依赖智谱平台的专属 API。如果你使用 Anthropic 官方 API，上下文使用率和模型信息仍然可以正常显示。

Q: 支持 Windows 吗？

支持。安装脚本会自动检测操作系统并使用正确的路径格式。

协议

MIT