核心用法
codex-usage 是一个 Telegram 风格的斜杠命令工具，用于检查本地 OpenAI Codex CLI 的配置文件状态与云端配额使用情况。用户可通过 /codex_usage 触发交互式选择器（支持按钮或文本菜单），或直接使用 /codex_usage default|all|<profile> 获取特定配置文件的详细报告。
脚本从 ~/.openclaw/agents/main/agent/auth-profiles.json 读取 OAuth 凭证，向受信任的 chatgpt.com/backend-api/wham/usage 端点发起 HTTPS 请求，获取 5 小时/周的使用窗口、剩余配额、重置时间等关键数据。输出包含结构化的 summary、formatted_profiles 及用户友好提示，支持 --format text 纯文本或 JSON 格式。
显著优点
- 安全优先设计：默认只读模式，所有删除操作需显式
--confirm-delete与--dry-run预览；敏感 token 全程脱敏，绝不完整打印 - 多配置管理：支持
default、all或任意自定义 profile 后缀，适配团队协作或多账户场景 - 健壮容错：网络超时（25s）、重试机制（1 次）、401 降级为本地健康报告，避免硬失败阻断用户体验
- UX 细节完备：20 秒重复请求抑制、进度通知分离、按钮/文本双模式适配、用户友好时区重置提示
潜在局限
- 依赖本地
auth-profiles.json，若用户未登录 Codex CLI 则无数据可报 - 仅限
chatgpt.com端点，不支持企业私有部署或其他 OpenAI 服务端点 - 删除操作虽有多重确认，但
--hard-delete仍不可逆（虽会提前备份） - 目前无历史趋势分析，仅呈现当前快照状态
适合人群
Codex CLI 重度用户、多账户开发者、团队管理员，以及需要监控 AI 编码助手配额消耗、避免突触服务中断的 DevOps 人员。
常规风险
| 风险项 | 说明 |
|--------|------|
| 凭证泄露 | 脚本虽脱敏处理，但源文件 `auth-profiles.json` 仍需本地妥善保管 |
| 端点变更 | 若 OpenAI 调整 usage API 路径或鉴权方式，可能导致 401 或数据缺失 |
| 误删配置 | 虽有多重确认，快速连续操作仍可能误触永久删除，建议优先使用 `--detach` 模式 |
| 网络依赖 | 完全离线时仅能报告本地健康状态，无法获取云端配额窗口 |