cc-glm-status

Claude Code 的状态行工具，为 GLM Coding Plan 用户显示实时 token 配额、MCP 用量和上下文窗口。

效果预览：

GLM-5-Turbo | Tokens ████████░░ 78% (0h23m) | MCP ●○ 84 | Ctx 35%

前置条件

• Node.js >= 18（运行 node --version 确认）
• Claude Code 已安装且正常使用
• GLM Coding Plan (Z.ai) 账号，需要能调用配额查询 API

安装

方式一：从 npm 安装（推荐）

npm install -g cc-glm-status

方式二：从 GitHub 安装

npm install -g github:hugo617/cc-glm-status

如果 npm 未安装，先安装 Node.js，npm 会自带。

配置

只需两步。

第 1 步：设置 API Key

在终端中运行（三选一，按优先级排列）：

# 选项 A：Z.ai API Key（推荐）
echo 'export ZAI_API_KEY="你的key"' >> ~/.zshrc
source ~/.zshrc

# 选项 B：智谱 (GLM) API Key
echo 'export ZHIPU_API_KEY="你的key"' >> ~/.zshrc
source ~/.zshrc

# 选项 C：Anthropic 认证令牌
echo 'export ANTHROPIC_AUTH_TOKEN="你的key"' >> ~/.zshrc
source ~/.zshrc

写入 ~/.zshrc 是为了让环境变量永久生效。如果你用 bash，替换为 ~/.bashrc。

API Key 获取方式：登录 z.ai 后台，在 API Key / 开发者设置页面复制。

第 2 步：配置 Claude Code

编辑 ~/.claude/settings.json，在已有配置中添加 status_line 字段：

{
  "其他已有配置": "...",
  "status_line": "cc-glm-status"
}

注意是合并，不要覆盖文件中已有的内容。

验证

重新打开 Claude Code，底部状态行应显示配额信息。也可在终端手动测试：

cc-glm-status --version        # 确认安装成功
echo '{}' | cc-glm-status      # 应输出带颜色的状态行（显示 Unknown 模型名）
echo '{}' | cc-glm-status --debug  # 查看详细诊断信息

状态行说明

各段以 | 分隔：

| 段 | 示例 | 说明 | |---|---|---| | Model | GLM-5-Turbo | 当前使用的模型 | | Tokens | Tokens ████████░░ 78% (0h23m) | Token 配额用量 + 进度条 + 重置倒计时 | | MCP | MCP ●○ 84 | MCP 工具用量（● > 50%，○ ≤ 50%）+ 总计 | | Ctx | Ctx 35% | 上下文窗口使用率 |

颜色含义：绿色 < 50%、黄色 50–79%、红色 ≥ 80%。

无配额数据时显示 Quota ---。

故障排查

状态行显示 "Quota ---"

echo '{}' | cc-glm-status --debug

• 看到 未找到 API Key → 环境变量未设置，检查第 1 步

• 看到 认证失败 → API Key 无效，重新复制正确的 Key

• 看到 Z.ai 服务器错误 → Z.ai 暂时故障，稍后重试

• 有数据但仍显示 --- → 清除缓存：

  macOS / Linux：

  rm ~/.claude/cache/glm-status-cache.json

  Windows（cmd 或 PowerShell）：

  del %USERPROFILE%\.claude\cache\glm-status-cache.json

Node.js 版本太旧

node --version  # 需要 v18.0.0 或更高

如果版本低于 18，通过 nvm 升级：

nvm install 18
nvm use 18

命令未找到

which cc-glm-status  # 确认安装路径在 PATH 中
npm list -g cc-glm-status  # 确认全局安装成功

CLI 选项

| 选项 | 说明 | |---|---| | --help / -h | 显示帮助信息 | | --version / -v | 显示版本号 | | --debug | 输出诊断信息到 stderr（排查问题用） |

环境变量

| 变量 | 说明 | |---|---| | ZAI_API_KEY | Z.ai API Key（最高优先级） | | ZHIPU_API_KEY | 智谱 (GLM) API Key | | ANTHROPIC_AUTH_TOKEN | Anthropic 认证令牌（最低优先级） | | CC_GLM_DEBUG | 设为 1 启用调试输出（等同于 --debug） |

开发

git clone https://github.com/hugo617/cc-glm-status.git
cd cc-glm-status
npm install   # 无依赖，仅验证环境
npm test      # 运行测试

零外部依赖，仅使用 Node.js 18+ 原生模块。

许可证

MIT