cpa-codex-auth-sweep-cliproxy 是一个专为 CLI Proxy 管理端设计的自动化工具，核心功能是通过调用其内置的认证文件接口与管理 API，实现对 Codex 授权凭证的高并发探活扫描。该工具能够识别出失效或返回 401 状态的账号，并在用户明确授权后执行清理操作，适用于日常维护中常见的‘扫号’‘清死号’以及‘清理 Codex 401’等运维场景。使用前必须提供 `base_url` 和 `management_key` 两个关键参数，确保操作具备合法的管理权限。 该工具的安全机制较为严格：默认仅允许向 `https://chatgpt.com/…` 发起探测请求，若需更改探活目标（即 `probe-url`），则必须由用户主动确认并显式启用 `–allow-unsafe-probe-host` 参数。此外，出于安全考虑，默认禁止 `–insecure` 模式，只有在内网调试且获得用户明确许可时，才可使用 `–insecure –allow-insecure-tls`。这些限制旨在防止因配置错误导致敏感凭证泄露或非法访问。 整个执行流程强调透明性与可控性：系统会在开始前主动询问必要参数，扫描过程中持续输出进度信息（如“第 N 条 / 共 M 条”），最终汇总展示统计结果（包括总数、正常数、401 数、额度耗尽数及错误数）。特别值得注意的是，除非用户明确表达删除意图（例如使用关键词“删掉”“清理”等），否则工具将仅执行只读扫描，不会自动删除任何凭证，从而避免误操作风险。
核心功能特点
- 通过 CLI Proxy Management API 获取并管理 Codex 授权文件列表
- 高并发探测每个凭证的有效性，精准识别 HTTP 401 及额度耗尽状态
- 支持在用户明确授权后安全删除无效凭证，默认仅扫描不删除
- 内置严格安全策略，默认仅允许白名单域名探活，防止越权访问
- 实时进度反馈与详细统计报告，提升运维可见性和控制力
适用场景
该工具主要面向需要定期维护大量 Codex 代理账号的运维人员或开发者，典型应用场景包括批量检测代理池中哪些账号已失效、哪些因周额度耗尽而无法使用，以及清理长期未活跃或已被封禁的凭证。在日常运营中，随着账号数量增长，手动逐个检查不仅耗时耗力，还容易遗漏问题节点；而使用此工具可在短时间内完成全量扫描，显著提升效率。 另一个重要用途是应对突发情况，例如当部分账号突然返回 401 错误时，可能是由于密钥泄露、服务变更或平台风控所致。此时利用此工具快速定位受影响账号，并结合业务判断决定是否保留或移除，有助于维持系统的稳定性和可用性。尤其对于依赖 Codex 进行自动化任务的企业级应用而言，及时清理无效凭证能有效避免因异常响应导致的流程中断。 此外，该工具也适合用于审计与合规检查。通过定期运行扫描脚本，团队可以建立一套标准化的账号健康度监控机制，记录每次扫描的结果趋势，辅助制定账号轮换策略或预算分配计划。由于其设计注重安全性与可解释性，即使是非专业运维人员也能在指导下稳妥使用，降低人为操作失误的可能性。