跳到文档内容
Anygent.ai文档

Agent 账号库:保存、应用、额度与批量轮换

在一处管理所有机器上的订阅账号和 API Key:看剩余额度,换 Key 后一键同步,额度用完时自动换号。

注意凭据等同账号密码,不要贴进对话、知识库或公开分享页面。

开始前

  • 至少一台已接入、在线的电脑或服务器。
  • 要用自动换号,这台机器的 Agent Core 需 0.3.523 或更新版本。

操作步骤

  1. 打开「Agent 账号库」

    在设置中心打开「Agent 账号管理」;只看某台机器时,在「对话主机管理」点这台机器的 ⋯ →「高级」→「管理认证」。

    完成后弹出「Agent 账号库」窗口,有「账号列表」「API 列表」「机器配置」三个页签。

    说明「账号列表」放订阅账号,「API 列表」放 API Key,「机器配置」是每台机器上的认证配置,一个配置可以给多个对话共用。

  2. 新建独立配置

    在「机器配置」点「新建」,展开后用「网页登录」或「导入 auth.json」写入账号。

    注意带 ~/.codex 标记的是默认目录,也就是这台机器终端里 Codex 当前登录的账号。新建独立配置时别选它,以免覆盖那边的登录。

  3. 查看额度

    列表里是上次查询的额度;点账号的「刷新额度」,或顶部「一键刷新额度」重新查询。

    完成后每个订阅账号显示各时间窗口的剩余额度,例如 Codex 的 5 小时和 7 天。

  4. 换 Key 并同步

    在「API 列表」点「编辑」换好 Key,再点「同步并重启全部」;配置标着「此配置待更新」时,点「去替换」→「应用」(或「应用并重启」)。

    完成后「Worker 恢复进度」里在用这个配置的 Agent 全部恢复在线;没在运行的 Agent 下次启动时用新凭据。

  5. 开启自动换号

    在 CLI 对话的「自动恢复」里打开「额度用完自动换号」,按顺序加好备用账号(订阅和 API 都可以),点「保存并应用」。

    完成后额度或余额耗尽时按顺序换到下一个账号,进度在通知中心;发「继续」接着聊。

    说明网络错误、登录失效和普通限流不会换号,失败的那一轮也不会重发。

常见问题

换了 Key,对话还在用旧凭据

在用这个配置的 Agent 要重启后才会用新凭据。点「同步并重启全部」,或在标着「此配置待更新」的配置上点「去替换」→「应用并重启」。

终端接管时没有自动换号

终端接管期间不会自动重启或换号,回到网页托管后恢复。

注意事项

  • Codex「覆盖写入 auth.json」不会备份旧凭据,写入前确认无误。