Codex Auth 是一个已弃用的独立技能（skill），用于处理与 OpenAI Codex OAuth 相关的身份验证流程。该工具的主要职责是生成登录 URL，并通过回调 URL 获取认证令牌，最终将配置信息写入本地 `auth-profiles.json` 文件以完成认证绑定。由于项目维护策略调整，`codex-auth` 已不再被主动更新和维护，官方建议用户转而使用功能更全面、持续维护的 **codex-profiler** 来替代所有 `/codex_auth` 和 `/codex_usage` 相关操作。尽管如此，原有的脚本仍可用于手动执行认证流程，但其安全性与兼容性不再获得保障。 该技能的设计遵循严格的安全边界：它不会执行任何远程 shell 命令（如 `curl|bash` 或 `wget|sh`），也不进行系统级修改（如使用 `sudo` 或 SSH）。所有敏感数据——包括完整的回调 URL 和状态参数——均被视为机密信息，严禁在聊天输出中明文展示。此外，写入操作仅限于本地配置文件，并采用基于文件锁的协调机制，以减少多进程并发时的竞争风险。整个流程依赖于标准的 OAuth 2.0 授权码模式，通过浏览器重定向到 `auth.openai.com` 完成用户授权，再由本地服务监听回调地址接收授权码。 值得注意的是，即使成功完成 Codex Auth 流程并获得有效令牌，也不能保证该令牌能直接通过 OpenAI 后端 API（如 `chatgpt.com/backend-api/wham/usage`）的身份校验。若出现 401 错误，应由其他专门处理使用量验证的技能（如 codex-profiler）负责后续处理。因此，尽管 `codex-auth` 仍可运行，但仅适用于需要临时恢复旧版认证逻辑的场景，不推荐在新项目中继续使用。
核心功能特点
- 支持生成 OpenAI Codex OAuth 登录 URL 并完成回调令牌捕获
- 自动将认证结果写入带文件锁保护的 auth-profiles.json 配置文件
- 提供命令行交互界面，支持按 profile 选择及队列化安全重启应用
- 严格限制敏感信息泄露，禁止在输出中显示完整回调 URL 或 tokens
- 兼容 localhost 回调流程，仅限信任域（OpenAI 主机 + 本地回调）
适用场景
虽然 Codex Auth 当前已被标记为废弃状态，但在某些遗留系统或临时恢复认证功能的场景中仍可能发挥作用。例如，当某个集成环境因网络策略无法直接使用 codex-profiler 时，可借助其脚本手动触发 OAuth 流程，完成对特定 OpenAI Codex 账户的授权绑定。此外，在开发调试阶段，若需快速验证本地网关能否正确加载新的认证凭证，也可通过该工具生成并注入有效的 `auth-profiles.json` 条目，而无需依赖完整的技能框架。 然而，这些用途应谨慎对待。由于该技能不再接收安全更新，其实现可能存在未修复的漏洞，尤其是在处理高权限操作或复杂回调路径时。同时，若尝试将生成的令牌用于生产环境的 API 调用，可能会遭遇格式不匹配导致的 401 错误，因为 OpenAI 后端对会话类型和令牌结构有严格要求。因此，即便能成功运行，也仅建议在隔离的测试环境中短期使用，并尽快迁移至 codex-profiler 以获得长期支持。 另一个潜在应用场景是对历史项目的兼容性维护。如果现有自动化流程仍调用 `/codex_auth` 命令且尚未升级接口，则可通过部署此弃用技能作为过渡层，避免立即中断服务。但这要求运维人员充分理解其局限性，并做好监控与回滚准备。总之，Codex Auth 更像是一个‘应急工具箱’中的临时组件，而非面向未来的解决方案。