「CPA-Helper」给 CLIProxyAPI 做本地自托管多用户面板：API Key、用量和 Codex 凭证一起管

如果你在用 CLIProxyAPI / CPA 给自己或小团队共享模型服务，最麻烦的往往不是“能不能转发请求”，而是后面的账：谁用了多少 Token，哪个 Key 在跑，余额怎么扣，失败请求去哪儿查，Codex 账号的 auth file 又该怎么巡检。CPA-Helper 就是为这个场景做的一套本地自托管管理面板。

它不是新的代理层，Agent 发起的模型请求仍然直接走 CPA；CPA-Helper 负责把 CPA 的 usage 队列、API Key 创建删除、凭证维护等接口组织成一个后台。这样做的好处是边界很清楚：请求链路不多绕一层，但管理者可以在本地 SQLite 里看到用量、请求明细、用户维度统计和价格估算。

共享 CPA 服务时，终于能按人看账

项目支持管理员和普通用户两套视图。每个用户可以创建和管理自己的 API Key，只看属于自己的请求、Token 和费用；管理员则能查看全局用量、用户排行、模型分布、失败请求和接口维度明细。对于几个朋友、一支小团队，或者一台内网 CPA 服务来说，这比把所有请求混在一个 Key 里清爽很多。

它还把余额规则做得比较细：管理员可以设置每月余额和不限时余额，用量按模型价格折算为 USD，余额不足时只暂停对应用户的 CPA API Key，而不是影响整套服务。模型价格也能在后台维护，按输入、输出、缓存 Token 或 image 模型的固定调用价格来估算成本。

Codex auth file 巡检是一个很实用的小钩子

CPA-Helper 里比较有意思的一块，是 Codex auth file 巡检。它支持 Cron 调度、额度阈值、并发 Worker、优先级规则，以及“只检查不修改”的安全模式，适合需要维护多组 Codex 账号状态的人。相比写一堆临时脚本，放在同一个管理面板里会更容易持续使用。

项目采用 Go + SQLite 做后端，前端是 Vue 3 + Vite + Naive UI，默认数据写到仓库根目录的 data/。部署上提供 Docker Compose，默认访问地址是 http://127.0.0.1:18317，第一次打开会引导创建管理员账号。仓库目前是 MIT License，最新 release 是 v0.3.1，GitHub 上约 165 stars。

如果你只是单人临时用 CPA，它可能显得有点“后台化”；但只要进入多用户、共享 Key、费用分摊、账号巡检这些场景，CPA-Helper 的价值就会很明显：把原本散落在日志、表格和脚本里的管理动作，收进一个可以自托管的本地控制台。