CodexBar 是一个通过 CLI 查询 AI 服务用量和配额的技能，适用于用户询问 AI 订阅使用情况、速率限制、剩余额度，或“Codex/Claude/Kimi 还剩多少”的场景。
主要能力
它可以查询多家 AI 服务商的限额、额度和重置时间。默认调用 codexbar usage 会遵循应用内已启用的服务商开关，也可以使用 codexbar usage --format json 获取 JSON 输出。通过 --provider 参数可指定服务商，支持 codex、claude、kimi、gemini、copilot、cursor、openrouter 等，具体列表见 codexbar --help。示例包括 codexbar usage --provider codex --json 和 codexbar usage --provider claude --json。多账号场景可使用 --account <label>、--account-index <n> 或 --all-accounts，其中 --all-accounts 仅限单个服务商。
认证模型
服务商数据获取依赖已有会话，包括 OAuth 缓存、CLI 凭据或浏览器 Cookie，不会在命令行传递密钥。Codex 通过 OAuth 使用 OpenAI 网页仪表盘，并回退到 Codex CLI。Claude 通过浏览器会话 Cookie 使用 claude.ai API，并回退到 Claude CLI；如果提示“No Claude session key found in browser cookies”，意味着需要在受支持的浏览器中登录 claude.ai，或依赖 CLI 回退。基于令牌的服务商会读取 CodexBar 配置文件。
仪表盘端点
菜单栏应用在回环地址上提供仪表盘。页面会请求 /dashboard/v1/snapshot 和 /cost；不存在 /api/* 命名空间，因此这些路径会返回 404，而不是提示路径猜测错误。snapshot 端点需要认证，因此当 CLI 不可用时，最快的可靠检查方式是在浏览器中打开仪表盘。
使用说明与限制
usage --all-accounts 会串行轮询每个账号，耗时可能远超九十秒。如果标准输出和标准错误都为零字节，说明它并非缓慢，而是被阻塞：该 CLI 是 CodexBar.app 内的辅助程序，待处理的 macOS Gatekeeper 提示会使其无输出停止。调试命令前应先截屏。对于从未配置过的服务商，相关错误属于噪声而非失败，只应报告用户实际使用的服务商。输出解读应关注剩余百分比、相对预期的节奏以及重置时间，其中节奏行（“in deficit”或“in reserve”）是最具可操作性的信息。Claude 行读取 claude-swap 存储的备份，会产生两种容易混淆的读数：当前活动槽显示没有存储凭据，因为实时登录是活动配置文件，其备份只有在切换离开后才会出现；而 claude-swap 保留的最后已知百分比会为凭据已消失的账号持续渲染，因此已失效账号可能多日显示为健康。一个看似合理的百分比并不能证明凭据可用，只有 claude-swap list --token-status 中 refresh token yes 才能证明。安装方式为 Homebrew，二进制名为 codexbar。