跳到文档内容
Anygent.ai文档

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

用“认证配置”组织对话,用“Agent 账号库”按指纹管理实际订阅账号或 API 并查看各账号额度;同一账号可以被多台机器上的多个配置复用。

开始前

  • 已接入一台带 Whalent daemon 的机器
  • 已创建或准备创建 Codex / Claude Code Agent

操作步骤

  1. 从机器菜单打开“管理认证”

    从目标机器的“管理认证”进入,页面会先加载当前机器;机器下拉也可切到“全部机器”,其它机器的配置会逐台补齐,并实时显示已加载数量。

  2. 先理解两层对象

    “认证配置”是某台机器上的命名 provider instance,一个配置可供多个对话使用;“Agent 账号库”记录实际订阅账号或 API,并按指纹合并。HP 和 A1 上的两个配置可以共同指向同一个凭据条目。带 ~/.codex 标记的是 CLI 默认目录,Memory 对话应新建独立配置而非直接使用。

  3. 创建或选择认证配置

    订阅账号:点「新建」创建独立配置(不在 ~/.codex),展开后粘贴 auth.json 或网页登录;API Key 可在新建 Agent 时填写“配置名称、API Key、Base URL”。

  4. 看额度:缓存优先,手动刷新

    “账号列表”里每个 Codex / Claude 订阅账号下方常驻额度条(5h、7d 等窗口的剩余百分比与重置时间),显示的是平台按该邮箱指纹保存的上一次查询结果,并标注“查询于”时间;打开页面不会向机器重新查询。想拿最新值点该账号的“刷新额度”或顶部“一键刷新额度”,结果会写回缓存,聊天页 header 的配额条也复用同一份。

  5. 轮换 / 泄露:应用到全部配置

    凭据更新后,在账号或 API 列表点击“应用”。确认框会列出该凭据关联的所有配置名;确认后统一写入当前版本,并自动重启正在使用这些配置的 Agent。未运行的 Agent 会在下次启动时使用新凭据。

  6. 确认自动重启

    写入或轮换账号后,按提示重启正在使用该认证配置的 Agent,并等待“Worker 恢复进度”全部在线。

注意事项

  • 对话只绑定认证配置,不再为每个对话复制一份 API Key。
  • 指纹相同只代表实际账号 / API 相同,不会合并不同机器上的认证配置。
  • Codex 覆盖写入 auth.json 不会备份旧凭据,操作前确认无误。
  • 凭据等同账号密钥,不要贴进对话、知识库或公开分享页面。