Agent 账号库:保存、应用、额度与批量轮换
用“认证配置”组织对话,用“Agent 账号库”按指纹管理实际订阅账号或 API 并查看各账号额度;同一账号可以被多台机器上的多个配置复用。
开始前
- 已接入一台带 Whalent daemon 的机器
- 已创建或准备创建 Codex / Claude Code Agent
操作步骤
从机器菜单打开“管理认证”
从目标机器的“管理认证”进入,页面会先加载当前机器;机器下拉也可切到“全部机器”,其它机器的配置会逐台补齐,并实时显示已加载数量。
先理解两层对象
“认证配置”是某台机器上的命名 provider instance,一个配置可供多个对话使用;“Agent 账号库”记录实际订阅账号或 API,并按指纹合并。HP 和 A1 上的两个配置可以共同指向同一个凭据条目。带 ~/.codex 标记的是 CLI 默认目录,Memory 对话应新建独立配置而非直接使用。
创建或选择认证配置
订阅账号:点「新建」创建独立配置(不在 ~/.codex),展开后粘贴 auth.json 或网页登录;API Key 可在新建 Agent 时填写“配置名称、API Key、Base URL”。
看额度:缓存优先,手动刷新
“账号列表”里每个 Codex / Claude 订阅账号下方常驻额度条(5h、7d 等窗口的剩余百分比与重置时间),显示的是平台按该邮箱指纹保存的上一次查询结果,并标注“查询于”时间;打开页面不会向机器重新查询。想拿最新值点该账号的“刷新额度”或顶部“一键刷新额度”,结果会写回缓存,聊天页 header 的配额条也复用同一份。
轮换 / 泄露:应用到全部配置
凭据更新后,在账号或 API 列表点击“应用”。确认框会列出该凭据关联的所有配置名;确认后统一写入当前版本,并自动重启正在使用这些配置的 Agent。未运行的 Agent 会在下次启动时使用新凭据。
确认自动重启
写入或轮换账号后,按提示重启正在使用该认证配置的 Agent,并等待“Worker 恢复进度”全部在线。
注意事项
- 对话只绑定认证配置,不再为每个对话复制一份 API Key。
- 指纹相同只代表实际账号 / API 相同,不会合并不同机器上的认证配置。
- Codex 覆盖写入 auth.json 不会备份旧凭据,操作前确认无误。
- 凭据等同账号密钥,不要贴进对话、知识库或公开分享页面。