在使用 Anthropic 推出的 Claude Code (CLI) 时，监控 Token 消耗和 5 小时额度非常重要。ccusage 是目前最推荐的轻量级统计工具。

📋 环境前置要求

ccusage 是基于 Node.js 开发的，因此无论哪种方案，核心目标都是获取 node、npm 和 npx 这三个命令。

🔐 方案一：拥有 Sudo 权限（个人电脑/虚拟机）

如果你是设备的主人，可以使用包管理器快速安装。

1. 安装 Node.js

以 Ubuntu/Debian 为例：

sudo apt update
sudo apt install nodejs npm -y

2. 验证环境

node -v && npm -v && npx -v

3. 直接运行

无需全局安装，直接通过 npx 随用随取：

npx -y ccusage@latest

🔓 方案二：无 Sudo 权限（公司服务器/集群/HPC）

这是最核心的部分。在没有 root 权限的情况下，我们利用 NVM (Node Version Manager) 在用户目录下构建独立环境。

1. 离线/用户态安装 NVM

执行脚本将 NVM 下载到 ~/.nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

2. 激活环境变量

将以下内容手动添加到你的 ~/.bashrc 或 ~/.zshrc 中并执行 source：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

3. 安装 Node.js (用户态)

有了 NVM 后，你可以安装任何版本的 Node，且无需权限：

nvm install --lts  # 安装长期支持版

🛠️ 配置与进阶使用 (通用)

1. 实时监控面板 (Blocks)

这是最酷炫的界面，建议在侧边窗口常驻：

npx -y ccusage@latest blocks --live

2. 集成到 Claude Code 状态栏 (推荐)

修改 Claude Code 的配置文件 ~/.claude/settings.json，让统计信息“长”在聊天窗口底部：

{
  "statusLine": {
    "type": "command",
    "command": "npx -y ccusage@latest statusline"
  }
}

常用指令

状态栏集成

ccusage 最实用的功能之一是与 Claude Code 状态栏的集成，让你在编码过程中随时掌握消耗情况。

只需要在 ~/.claude/settings.json 文件下面加上如下的配置，就可以看到 Cloud Code 的实时消耗了。

{
  "statusLine": {
    "type": "command",
    "command": "npx -y ccusage@latest statusline",
    "padding": 0
  }
}

配置完成后，Claude Code 的状态栏会实时显示：

• 当前使用的模型名称：正在使用的 Claude 模型类型
• 当前会话费用：正在进行的对话消耗
• 今日总费用：当天累计消耗金额
• 5 小时区块费用与剩余时间：当前活跃区块的使用情况
• 实时消耗速率：带颜色指示的消耗速度
• 状态栏会根据消耗速率变化颜色，帮助你直观了解当前的使用强度。
  如下：
  

多项目管理

在 ~/.ccusage/config.json 配置中添加多个项目

{
  "projects": {
    "frontend": "/Users/dev/projects/frontend/.claude",
    "backend": "/Users/dev/projects/backend/.claude",
    "mobile": "/Users/dev/projects/mobile/.claude"
  },
  "defaultCostMode": "calculate",
  "outputFormat": "table"
}

JSON 输出和数据集成

导出详细JSON报告

ccusage monthly --json --breakdown > monthly-report.json

结合jq进行数据处理

ccusage daily --json | jq ‘.sessions[] | select(.cost > 5.0) | {date, cost, tokens}’

推荐关注

笔者AI行业算法资深从业者，日常分享AI算法和技术实践、趋势，干货多多，推荐关注 wechat 公众号 Jae.Log