Appearance
CodexManager 如何使用
它是什么
CodexManager 是一个偏本地网关和账号池管理方向的工具，适合把多个账号、平台密钥和请求出口统一收口到一个桌面端或本地服务里管理，再给 Codex 或其他客户端使用。
适合谁
适合刚开始接触 CodexManager、希望先完成基础配置和常规操作的用户，也适合经常切换多个号源、多个平台或多个本地客户端的用户。
使用前准备
- 明确你是要用它做账号池管理，还是要把它当作本地网关来统一转发
- 准备好你已有的平台密钥、账号信息和目标客户端
- 预留时间检查本地端口、服务状态和网络可达性
使用技巧
- 第一次用时，先把“服务能启动”和“端口可访问”验证通过，再开始导入账号或平台配置。
- 如果你主要是给 Codex 或 cc-switch 提供统一入口，优先使用本地网关能力，这样后续切换平台会简单很多。
- 建议先只接入一个账号或一个平台做最小验证，跑通后再逐步增加更多账号，排错成本更低。
- 如果工具里提供了平台密钥或统一密钥生成功能，优先给客户端使用这一层，而不是把原始上游密钥散落到多个工具里。
- 账号轮转、排序和命中规则最好提前看懂；这类工具很多问题不是“不能用”，而是“没命中你以为会命中的账号”。
操作步骤
- 启动 CodexManager，先确认服务状态正常、端口没有冲突。
- 进入账号管理或平台管理，添加第一个可用账号或平台密钥。
- 如果你要给其他客户端使用，再配置本地网关地址和统一密钥。
- 用目标客户端做一次最小请求验证，确认链路是通的。
- 基础流程跑通后，再继续设置更多账号、轮转策略和高级规则。
注意事项
- 不建议一开始就同时叠加多个账号、多平台和多种代理规则，否则很难判断问题出在哪一层。
- 如果你修改了服务端口或本地网关地址，记得同步修改下游客户端的
base_url。 - 账号命中、跳过、冷却、禁用状态往往会直接影响请求结果，排错时要先看这些状态而不是先怀疑模型本身。
- 浏览器回调、登录导入或挑战验证失败时，优先参考官方 FAQ 和最小排障文档，不要盲改大量配置。
常见问题
为什么我应该先做“最小验证”？
因为这样能快速判断问题出在服务启动、账号配置、网关转发，还是客户端配置，而不是把所有变量混在一起。
它更适合拿来做什么？
更适合做统一入口、本地网关和账号池管理。如果你经常切换多个平台或多个账号，它的价值会更明显。