CodingPlan Usage Query

中文 | English  ----  Gitee | GitHub

查询各平台 Coding Plan 的套餐用量和重置倒计时，推荐搭配 ccstatusline / ccstatusline-zh 的自定义命令放在 Claude Code 状态栏查看。

支持的套餐

套餐	获取方式
火山方舟 Coding Plan / Agent Plan	火山引擎 OpenAPI
OpenCode Go	页面 HTML 解析
阿里云千问 Token Plan	控制台 Cookie

效果预览

运行 scripts/preview.cmd（或 node src/tools/preview.mjs）可用模拟数据在终端预览各百分比档位的显示效果，无需真实账号。

项目结构

coding-plan-usage-query/
├── config/
│   ├── config.example.json                 # 配置模板
│   └── config.schema.json                  # JSON Schema 校验
├── scripts/
│   ├── query-usage-all.cmd                 # Windows 双击运行（UTF-8 chcp 65001）
│   ├── login-qwen.cmd                      # Windows 双击登录千问
│   ├── login-opencode.cmd                  # Windows 双击登录 OpenCodeGo
│   └── preview.cmd                         # Windows 双击预览显示效果
├── src/
│   ├── login/
│   │   ├── login-common.mjs               # 登录公共逻辑（Playwright、profile、写回 config）
│   │   ├── login-qwen.mjs                 # 千问登录
│   │   └── login-opencode.mjs             # OpenCodeGo 登录
│   ├── query/
│   │   ├── query-usage-all.mjs            # 查询全部套餐（并行）
│   │   ├── query-usage-ark.mjs            # 火山方舟用量查询
│   │   ├── query-usage-qwen.mjs           # 千问 Token Plan 用量查询
│   │   ├── query-usage-opencode-go.mjs    # OpenCodeGo 用量查询
│   │   └── query-usage-smart.mjs          # 按 CC-Switch 自动匹配（带 5 秒缓存）
│   ├── tools/
│   │   ├── get-actual-model.mjs           # 获取真实模型名称
│   │   └── preview.mjs                    # 生成模拟用量预览输出
│   └── utils/
│       ├── utils-query-usage.mjs           # 共享工具函数
│       └── utils-cc-switch.mjs             # CC-Switch 工具
├── test/                                    # 单元测试（node --test）
└── tmp/                                     # 查询结果缓存与登录 profile（自动生成，已 gitignore）

各查询脚本为「导出函数 + CLI 壳」双入口：既可直接 node 运行，也被 smart/all 以进程内函数调用，避免子进程启动开销。

前置要求

• Node.js 22.13 或更高版本（使用 node:sqlite 内置模块，实验性警告已自动屏蔽）

快速开始

1. 创建配置文件

将 config/config.example.json 复制为 config/config.json。

2. 填写配置文件

打开 config.json，按 config.schema.json 中的字段说明填入凭据：

• 火山方舟：在火山引擎控制台创建 AccessKey，填入 accessKeyId 和 secretAccessKey
• OpenCodeGo：运行 login-opencode.cmd 登录账号，脚本自动写入 auth cookie 和 workspaceID（首次运行会自动安装 playwright-core）
• 阿里云千问：运行 login-qwen.cmd 登录账号，脚本自动写入 cookie（首次运行会自动安装 playwright-core）

详细说明见下方 配置文件说明。

3. 运行查询

# 根据 CC-Switch 当前供应商自动判断显示哪个套餐
node src/query/query-usage-smart.mjs

# 查询所有套餐
node src/query/query-usage-all.mjs

# 火山方舟（用账号 type 配置，默认 coding）
node src/query/query-usage-ark.mjs

# 火山方舟 Agent Plan（强制指定）
node src/query/query-usage-ark.mjs --type agent

# OpenCodeGo
node src/query/query-usage-opencode-go.mjs

# 阿里云千问（cookie 失效会提示运行登录命令）
node src/query/query-usage-qwen.mjs

# 登录千问刷新 cookie（Windows 双击 login-qwen.cmd，或命令行）
npm run login:qwen

# 登录 OpenCodeGo 刷新凭据（Windows 双击 login-opencode.cmd，或命令行）
npm run login:opencode

# 指定账号位置（从 0 开始）
node src/query/query-usage-ark.mjs --position 1

# 预览显示效果（无需真实账号）
node src/tools/preview.mjs

命令行参数

查询脚本支持以下参数：

参数	缩写	说明
--display	-d	显示模式：auto（默认，a）/ long（l）/ short（s）
--type	-t	火山方舟套餐类型：coding（c）/ agent（a），未传时用账号 type 配置，再回退 coding（all/smart 脚本忽略）
--position	-p	账号位置（从 0 开始，默认 0）
--hide-on-monthly-exhausted	-	月额度耗尽时不输出（true/false，默认 false，smart 脚本忽略该参数）

登录脚本（login-qwen/login-opencode）仅支持 --position/-p 参数。

配置文件说明

配置文件 config/config.json 顶层为 JSON 对象，包含 ark、opencode、qwen 三个数组，分别对应火山方舟、OpenCodeGo、阿里云千问的账号列表，每个数组支持多账号。apiKey 字段用于 query-usage-smart.mjs 匹配当前供应商，不使用 smart 脚本可不填。

火山方舟

{
    "ark": [
        {
            "apiKey": "xxx",
            "type": "coding",
            "longLabel": "火山CodingPlan",
            "shortLabel": "Coding",
            "accessKeyId": "xxx",
            "secretAccessKey": "xxx"
        },
        {
            "apiKey": "xxx",
            "type": "agent",
            "longLabel": "火山AgentPlan",
            "shortLabel": "Agent",
            "accessKeyId": "xxx",
            "secretAccessKey": "xxx"
        }
    ]
}

字段	必填	说明
type	否	套餐类型：coding（默认）或 agent
longLabel / shortLabel	否	显示标签，不填使用默认值（火山CodingPlan/Coding、火山AgentPlan/Agent）
accessKeyId	是	火山引擎 AccessKey ID
secretAccessKey	是	火山引擎 SecretAccessKey
apiKey	否	CC-Switch 里填的 API Key，smart 脚本据此匹配账号

在火山引擎控制台 https://console.volcengine.com/iam/keymanage 创建 AccessKey 子账户需具有 AccessKeySelfManageAccess 和 ArkReadOnlyAccess 权限

OpenCodeGo

{
    "opencode": [
        {
            "authCookie": "xxx",
            "workspaceID": "wrk_xxx",
            "apiKey": "xxx"
        }
    ]
}

字段	必填	说明
longLabel / shortLabel	否	显示标签，不填使用默认值（OpenCodeGo/Go）
authCookie	是	opencode.ai 的 auth cookie，运行 login-opencode.cmd 自动填充
workspaceID	是	工作区 ID，形如 wrk_...，运行 login-opencode.cmd 自动填充
apiKey	否	CC-Switch 里填的 API Key，smart 脚本据此匹配账号

运行 npm run login:opencode（或双击 login-opencode.cmd）登录后自动写入

阿里云千问

{
    "qwen": [
        {
            "apiKey": "sk-sp-xxx",
            "cookie": "cna=xxx; login_qianwenai_ticket=xxx; ...",
            "longLabel": "千问",
            "shortLabel": "千问"
        }
    ]
}

字段	必填	说明
longLabel / shortLabel	否	显示标签，不填使用默认值（千问TokenPlan/千问）
cookie	是	千问控制台登录 cookie，运行 login-qwen.cmd 自动填充
apiKey	否	CC Switch 里填的 API Key, smart 脚本据此匹配当前账号，不使用 smart 脚本可不填

千问无公开用量查询 OpenAPI，通过控制台 cookie 调用内部数据网关 cookie 会过期，失效后运行 login-qwen.cmd 重新登录 登录依赖 playwright-core（devDependency），login-qwen.cmd 首次运行会自动安装

自动匹配账号

query-usage-smart.mjs 的工作流程：

1. 读取 ~/.cc-switch/settings.json 的 currentProviderClaude 获取当前供应商
2. 获取当前供应商的 API Key（优先环境变量 ANTHROPIC_AUTH_TOKEN/ANTHROPIC_API_KEY，代理模式回退查询 ~/.cc-switch/cc-switch.db）
3. 在 config.json 中匹配 apiKey 字段相同的账号
4. 进程内调用对应查询函数获取用量

检测到免费模型时，改为显示全部账号用量 匹配不到账号时静默退出（不输出任何内容） 查询结果缓存 5 秒（tmp/cache-usage.json），高频刷新时减少上游 API 请求；手动运行各子脚本不使用缓存

搭配 ccstatusline / ccstatusline-zh 使用

推荐将 query-usage-smart.mjs 配置为 ccstatusline / ccstatusline-zh 的自定义命令，放在 Claude Code 状态栏实时查看（需使用绝对路径）：

node F:/xxx/query-usage-smart.mjs

• 自定义命令超时建议设为 6000ms
• 如需显示彩色百分比，请在 ccstatusline / ccstatusline-zh 中将自定义命令设置为保留颜色

更新日志

CHANGELOG

相关项目

• CC Launcher（Gitee | GitHub）：使用指定的 CC-Switch 供应商启动 Claude Code，可同时运行多个不同供应商的 Claude Code 实例，不影响 CC-Switch 的全局激活状态。

License

MIT License