Codex Usage 是一个已弃用的命令行工具，用于检查和报告本地 OpenAI Codex 身份验证配置文件的 API 使用情况。该工具通过读取 `~/.openclaw/agents/main/agent/auth-profiles.json` 中的 OAuth 凭证，向 OpenAI 的 `/backend-api/wham/usage` 端点发起请求，获取当前账户在 Codex 服务上的使用配额状态。由于项目维护策略调整，该独立技能已被标记为不再维护，所有后续功能已迁移至 `codex-profiler` 工具中实现。尽管如此，其核心逻辑仍可用于理解和管理 Codex 相关的身份验证与资源消耗情况。 该脚本支持多种运行模式，包括查看默认配置文件、全部已发现配置或指定某个具体 profile 的使用详情。它具备完善的错误处理机制：当远程 API 不可达时自动降级为仅输出本地健康检查信息；若返回 401 错误，则提示认证未被接受而非直接崩溃。此外，脚本严格遵循安全规范，禁止执行任何远程 shell 命令（如 curl/bash）、系统权限操作（sudo/ssh），并限制网络调用仅限可信域名（chatgpt.com）下的 HTTPS 请求。
核心功能特点
- 支持按指定配置文件查询 Codex 使用状态，包括默认、全部或单个 profile
- 提供本地健康检查与远程 API 查询双重保障，断网时仍可输出基础信息
- 内置防误操作保护机制，删除操作需显式确认且支持 dry-run 预览
- 自动格式化时间重置提醒（按用户本地时区显示 reset_at 和剩余时长）
- 严格限制敏感信息输出，禁止打印完整令牌或执行高危系统命令
适用场景
此工具主要面向需要监控和管理个人或团队 Codex 使用配额的开发者或系统管理员。例如，在频繁调用 Codex API 进行代码生成或调试的场景下，用户可通过定期运行该脚本来了解每周 5 小时免费额度是否即将耗尽，避免因超限导致服务中断。尤其适用于那些依赖 OpenAI 开发者账户但缺乏图形化界面管理工具的技术人员。 另一个典型应用场景是在部署自动化流水线时集成使用检查功能。比如在 CI/CD 流程中加入对 Codex 配额状态的预检步骤，确保只有在有足够额度的情况下才允许触发高成本任务。虽然原工具已停止更新，但其设计理念——即轻量级、只读优先、明确反馈进度——仍然值得借鉴。对于希望构建类似功能的开发者而言，可以参考其交互适配器设计，适配不同终端环境（如有按钮支持则展示选择器，否则提供文本菜单选项）。