核心用法
codex-usage 是一个 Telegram 斜杠命令封装，专用于 Codex CLI（OpenAI 的终端编程助手）的账户健康检查。用户发送 /codex_usage、/codex_usage default 或 /codex_usage <profile> 时，系统会调用底层 Python 脚本 codex_usage.py，以文本格式返回指定 profile 的：
- 当前用量（requests/tokens）
- 速率限制剩余额度（RPM/TPM）
- 认证状态与有效期
支持 all 参数批量扫描全部配置文件，方便多账号/多团队场景下的集中监控。
显著优点
1. 多 profile 原生支持：通过 --profile 参数无缝切换，解决 Codex CLI 本身缺乏集中视图的问题。
2. 命令行友好输出：--format text 确保在 Telegram 等 IM 场景下可读性高，无需滚动长 JSON。
3. 快速故障定位：将「账号是否欠费」「是否触发 rate limit」「凭证是否过期」三类高频问题聚合为单条命令。
潜在缺点与局限性
- 依赖本地凭证：脚本运行在本地环境，需预先配置
~/.codex/config.*.toml，无法直接查询远端他人的配额。 - 非官方 API 封装：基于 Codex CLI 的私有接口或 OpenAI Admin API，存在接口变更导致解析失败的风险。
- 仅读不写：仅能查询状态，无法主动切换模型、充值或修改 limit。
- 输出格式单一：虽支持
text，但缺乏结构化数据（如 JSON/CSV）导出选项，不利于后续自动化告警系统集成。
适合人群
- 同时使用多个 OpenAI 组织账号或 Codex profile 的开发者/团队管理员。
- 需要快速在移动端（Telegram）确认「刚才报 429 是账号问题还是代码问题」的运维场景。
- 对 CLI 不熟悉、希望通过聊天界面交互的低频使用者。
常规风险
- 凭证泄露：若脚本未妥善保管
OPENAI_API_KEY，日志或 Telegram 消息历史中可能出现敏感信息残留。 - 权限边界：脚本默认使用用户本地配置的权限，可能因组织策略差异导致查询结果与预期不符。
- 过时失效：Codex CLI 目前处于快速迭代期，官方接口调整可能导致本命令返回空或报错，需持续维护。