AiBall 新功能：Codex 代理池控制面板，一键连接、无感切

多个 Codex 账号管在一起，额度看得见，用完自动换下一个。

封面图

开篇

如果你在用 OpenAI Codex CLI 写代码，大概率遇到过这些烦恼：

手里好几个账号，终端却只能「记住」一个；
5 小时额度用完了，要手动换鉴权、重启；
不知道哪个号还剩多少额度，只能反复开网页查；
写到一半 429 限流，心流直接断掉。

AiBall （Windows 桌面悬浮球）在控制面板里提供了 Codex 代理池控制面板------把多账号管理、额度监控、本地代理、自动切号，全部收进一个窗口。

配图 1：Codex 代理池控制面板（主界面）

图注：单击悬浮球 → 控制面板 → Codex ------ 这就是 Codex 代理池控制面板 全貌

一张图里能看到：

区域	作用
顶部信息卡	号池简介、连接状态、一键连接
工具栏	添加账号 · 刷新 · 导入 · 导出全部
全选栏	勾选账号后批量导出所选 / 删除所选
账号卡片	邮箱、Plus 标签、5h/周额度、单号刷新与重登

上图中已有 2 个账号，junen18555 标记为「当前」，5 小时额度 99%、周额度 53%，重置时间一目了然。

这是什么？

Codex 代理池 = 多个 Codex 账号 + 本地 HTTP 代理 + 自动轮换。

能力	说明
多账号管理	添加、导入、导出、删除，支持全选批量操作
额度可视	5 小时 / 周额度进度条，低额度高亮
一键连接	自动配置本机 `codex`，走本地代理
无感切号	401 / 429 时自动换池中下一个号
数据本地	鉴权存在 `~/.codex/`，不上传云端

工作原理（一图看懂）

图注：终端 codex → AiBall 本地代理（8741）→ 代理池选号 → OpenAI

在控制面板点 「一键连接」 ，AiBall 改写 ~/.codex/config.toml，启动本地代理（127.0.0.1:8741）。
终端里照常敲 codex，请求先进代理池。
代理优先用「当前」账号；401 / 429 时自动试下一个号。
成功的号会更新为「当前」，尽量不打断编码心流。

核心功能

1. 内置 OAuth 添加账号

点工具栏 「添加账号」 → 浏览器 OpenAI 授权 → 自动入库。无需 codex login，不装 CLI 也能加号。

【配图建议】 截取 OAuth 授权页或「等待授权中」状态 → 截图/03-oauth-login.png

2. 导入 / 导出

导入：批量 JSON 鉴权入库
导出全部：备份整个代理池
导出所选：勾选后只导出部分账号

主界面截图里已展示 全选 2/2 与批量操作栏，发文时可裁切局部作细节图。

3. 额度监控

每个账号卡片显示：

5 小时剩余 % 与恢复时间（如：今日 12:54）
周额度剩余 % 与恢复时间（如：07-07 01:45）
套餐标签：Plus / Pro / Team 等
工具栏 「刷新」：全部账号
卡片 「刷新额度」：仅当前账号

4. 一键连接

未连接时（灰点 +「未连接」）点蓝色 「一键连接」 ；连接后变为绿点 + 代理地址，按钮变为 「断开」。

点连接后，AiBall 会自动改写本机 ~/.codex/config.toml，把 Codex CLI 的请求指向本地代理池------不用手改配置、不用记端口。

配图 2：一键连接后，config.toml 长什么样

图注：VS Code 打开 C:\Users\你的用户名\.codex\config.toml，首行 # managed by AiBall 表示由 AiBall 托管

连接成功后，文件内容大致如下（端口默认 8741）：

toml 复制代码

# managed by AiBall
model_provider = "aiball"
model = "gpt-5.4"

[model_providers.aiball]
name = "AiBall Codex Pool"
base_url = "http://127.0.0.1:8741/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "local-dev-key"

几个关键点：

字段	含义
`# managed by AiBall`	托管标记；断开时会按此识别并恢复原配置
`model_provider = "aiball"`	让 Codex CLI 走 AiBall 代理池，而非默认 OpenAI
`base_url = "http://127.0.0.1:8741/v1"`	请求先进本地代理，再由代理池选号转发
`experimental_bearer_token`	本地代理鉴权，仅本机 loopback，不对外暴露

之后终端里照常 codex，IDE 插件若读同一份 config.toml 也会自动走代理池------写代码、跑 CLI，配置只改一处。

点 「断开」 时，AiBall 会还原连接前的 config.toml（若原本没有该文件则删除托管配置）。

5. 「当前」是什么？

号池里的 优先账号 ，也是最近一次代理成功使用的账号。可手动 「设为当前」，也会在无感切号后自动更新。

四步上手

步骤	操作
①	悬浮球 → 控制面板 → Codex
②	添加账号或导入 JSON
③	看额度，必要时刷新
④	一键连接，终端用 `codex`

配图 3：终端实战

Windows Terminal 运行 codex，侧边开着已连接的控制面板；或展示额度打满后自动切号、终端无感继续。

适合谁？

多个 Codex 账号，想统一管理、自动轮换
单号额度常打满，不想手动换鉴权
需要桌面常驻 额度看板
已用 Codex CLI，希望 零配置接入

常见问题

Q：和「号池」有什么区别？

A：同一个功能------Codex 代理池控制面板 是入口界面，背后是本地代理 + 多账号池。

Q：数据安全吗？

A：鉴权仅存本机 ~/.codex/，不上传云端。

Q：不用时要断开吗？

A：建议点 「断开」 ，恢复原有 config.toml。

Q：一键连接会覆盖我自己的 config.toml 吗？

A：会暂存你原来的内容；断开时完整还原。若原本没有该文件，断开后会删除 AiBall 写入的配置。

Q：config.toml 里为什么 model 是 gpt-5.4？

A：这是 AiBall 代理池的默认模型标识，实际请求由池中账号转发，与你在 OpenAI 侧的 Codex 能力一致。

Q：号过期了？

A：卡片点 「重登」 OAuth 刷新。

写在最后

Codex 代理池控制面板 的目标：让你专注写代码，而不是折腾账号。

文末信息

项目	内容
工具	AiBall · Windows 桌面悬浮球
入口	悬浮球 → 控制面板 → Codex
版本	v0.3.0
下载	https://mp.weixin.qq.com/s/q3J50mi97Xs3idihhKjlKw