CodingPlan Usage Query

中文 | English ---- Gitee | GitHub

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

支持的套餐

套餐	获取方式
火山方舟 Coding Plan / Agent Plan	火山引擎 OpenAPI(AK/SK)
Ollama Cloud	页面 HTML 解析(cookie)
OpenCode Go	页面 HTML 解析(cookie)
阿里云千问 Token Plan	控制台内部 API(cookie)

效果预览

运行 scripts/preview.cmd（或 node src/tools/preview.mjs）可用模拟数据预览显示效果。

项目结构

coding-plan-usage-query/
├── config/
│   ├── config.example.json                # 配置模板
│   └── config.schema.json                 # JSON Schema 校验
├── docs/
│   ├── CHANGELOG.md                       # 更新日志
│   ├── README_EN.md                       # 英文版 README
│   └── preview.png                        # 效果预览图
├── scripts/
│   ├── login-opencode.cmd                 # Windows 双击登录 OpenCode Go
│   ├── login-qwen.cmd                     # Windows 双击登录千问
│   ├── preview.cmd                        # Windows 双击预览显示效果
│   └── query-usage-all.cmd                # Windows 双击运行（UTF-8 chcp 65001）
├── src/
│   ├── login/
│   │   ├── login-opencode.mjs             # OpenCode Go 登录
│   │   └── login-qwen.mjs                 # 千问登录
│   ├── query/
│   │   ├── query-usage-all.mjs            # 查询全部套餐（并行）
│   │   ├── query-usage-ark.mjs            # 火山方舟用量查询
│   │   ├── query-usage-ollama.mjs         # Ollama Cloud 用量查询
│   │   ├── query-usage-opencode-go.mjs    # OpenCode Go 用量查询
│   │   ├── query-usage-qwen.mjs           # 千问 Token Plan 用量查询
│   │   └── query-usage-smart.mjs          # 智能查询：根据实际使用的套餐自动匹配（带缓存）
│   ├── tools/
│   │   ├── colorful-tokens.mjs            # 上下文 token 数按阈值着色
│   │   ├── get-actual-model.mjs           # 获取真实模型名称
│   │   └── preview.mjs                    # 生成模拟用量预览输出
│   └── utils/
│       ├── utils-cc-switch.mjs            # CC-Switch 工具
│       ├── utils-login.mjs                # 登录公共逻辑（Playwright、profile、写回 config）
│       └── utils-query-usage.mjs          # 共享工具函数
├── 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 中的字段说明填入凭据：

火山方舟 Coding Plan / Agent Plan：在火山引擎控制台创建 AccessKey，填入 accessKeyId 和 secretAccessKey
Ollama Cloud：根据 config.schema.json 提示填写 cookie
OpenCode Go：运行 login-opencode.cmd 自动写入 authCookie 和 workspaceID，或根据 config.schema.json 提示填写
阿里云千问 Token Plan：运行 login-qwen.cmd 自动写入 cookie，或根据 config.schema.json 提示填写

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

3. 运行查询

# 智能查询：根据实际使用的套餐自动匹配（带缓存）
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

# Ollama Cloud
node src/query/query-usage-ollama.mjs

# OpenCode Go
node src/query/query-usage-opencode-go.mjs

# 阿里云千问
node src/query/query-usage-qwen.mjs

# 使用浏览器登录千问，自动读取凭据
node src/login/login-qwen.mjs

# 使用浏览器登录 OpenCode Go，自动读取凭据
node src/login/login-opencode.mjs

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

# 预览显示效果
node src/tools/preview.mjs

上述命令也可通过 npm scripts 快捷运行：npm run query（smart）、npm run query:all、npm run query:ark/query:ollama/query:opencode/query:qwen（各套餐）、npm run login:qwen/login:opencode（登录）。透传参数时需加 --，如 npm run query:ark -- --type agent。

命令行参数

查询脚本支持以下参数：

参数	缩写	说明
`--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 脚本忽略该参数）
`--hide-on-no-active-plan`	-	无活跃套餐时隐藏该条查询（`true`/`false`，默认 `false`，仅 `all` 脚本生效）

登录脚本（login-qwen/login-opencode）仅支持 --position/-p 参数。position 取 0~N（N 为当前账号数）：< N 更新已有账号，= N 新建第 N+1 个账号；越界时会提示重新输入，开浏览器前会要求确认。

配置文件说明

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

火山方舟 Coding Plan / Agent Plan

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

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

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

Ollama Cloud

{
    "ollama": [
        {
            "apiKey": "xxx",
            "shortLabel": "Ollama",
            "longLabel": "Ollama",
            "cookie": "xxx"
        }
    ]
}

字段	必填	说明
`longLabel` / `shortLabel`	否	显示标签，不填使用默认值（Ollama/Ollama）
`cookie`	是	`__Secure-session` cookie 的值，从浏览器 DevTools 手动复制
`apiKey`	否	CC-Switch 里填的 API Key，smart 脚本据此匹配账号

Ollama 登录受 Cloudflare 人机验证保护，Playwright 启动的浏览器会被判定为自动化而无法通过验证，故未提供登录脚本。请登录 https://ollama.com 后从浏览器 DevTools -> Application -> Cookies 复制 __Secure-session 的值填入配置。

OpenCode Go

{
    "opencode": [
        {
            "apiKey": "xxx",
            "shortLabel": "Go",
            "longLabel": "OpenCodeGo",
            "workspaceID": "wrk_xxx",
            "authCookie": "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 脚本据此匹配账号

阿里云千问 Token Plan

{
    "qwen": [
        {
            "shortLabel": "千问",
            "longLabel": "千问",
            "apiKey": "sk-sp-xxx",
            "cookie": "xxx"
        }
    ]
}

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

自动匹配账号

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

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

说明：

检测到使用免费模型或匹配不到账号时，显示全部账号用量
查询结果缓存 5 秒，错误结果缓存 30 秒（tmp/cache-usage.json），减少高频刷新时的 API 请求
手动运行子脚本时不使用缓存

搭配 ccstatusline / ccstatusline-zh 使用

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

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

建议将自定义命令超时设为大于脚本内部超时（10 秒），否则状态栏会出现显示错误
如需显示彩色百分比，请在 ccstatusline / ccstatusline-zh 中将自定义命令设置为保留颜色

更新日志

CHANGELOG

License

MIT License

Name		Name	Last commit message	Last commit date
Latest commit History 10 Commits
config		config
docs		docs
scripts		scripts
src		src
test		test
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

CodingPlan Usage Query

支持的套餐

效果预览

项目结构

前置要求

快速开始

1. 创建配置文件

2. 填写配置文件

3. 运行查询

命令行参数

配置文件说明

火山方舟 Coding Plan / Agent Plan

Ollama Cloud

OpenCode Go

阿里云千问 Token Plan

自动匹配账号

搭配 ccstatusline / ccstatusline-zh 使用

更新日志

相关项目

License

About

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

CodingPlan Usage Query

支持的套餐

效果预览

项目结构

前置要求

快速开始

1. 创建配置文件

2. 填写配置文件

3. 运行查询

命令行参数

配置文件说明

火山方舟 Coding Plan / Agent Plan

Ollama Cloud

OpenCode Go

阿里云千问 Token Plan

自动匹配账号

搭配 ccstatusline / ccstatusline-zh 使用

更新日志

相关项目

License

About

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages