Agent 标签页的结构
打开 配置中心 → Agent 后，左侧是 Agent 列表，右侧是所选 Agent 的详情区。详情区从上到下有三张卡片：模型供应商不是独立标签页。它挂在每个 Agent 下面，因为不同 Agent 支持不同的通信协议和模型目录。
添加 Agent
左侧列表按状态分组，每个条目右侧的动作取决于当前状态：
Vibex 自带四个内建预设：Claude Code、Codex、ZCode、OpenCode。ACP 目录另外提供 Google Antigravity、Cline、Codebuddy Code、GitHub Copilot、Cursor、DeepSeek Harness、Devin CLI、Gemini CLI、Grok、Hermes、Kimi Code CLI、Pi 等集成。
添加自定义 ACP Agent
点击列表底部的 添加自定义 ACP Agent，填写：
自定义 Agent 目前只能新建，不能编辑；关闭开关会删除它，但会话历史保留。
登录 Agent 账号
原生凭证 卡片管理 Agent 自己的账号，它与外部 CLI 共享同一份凭据——卡片上会明确写出 “Agent-native account · shared with the external Agent CLI”。- 可用的登录方式由 Agent 决定，常见的有 登录、保存并登录、打开登录终端。
- 卡片提供 刷新认证方式、验证账号、刷新模型、重新认证、退出登录。
- 重新认证会影响正在使用旧凭据的 Agent 进程；界面会先给出提示。
- 退出登录 同时影响外部 CLI 和 Vibex 会话，执行前会显示受影响的会话数量。
配置模型供应商
在 模型供应商配置 卡片中点击 添加配置，或对已有配置点击编辑。编辑器分三段：基本信息
连接与凭证
API Key 输入框是只写的：默认掩码显示，点眼睛图标可以显示明文；已保存时会标出 已保存。没有改动过的字段不会重写已保存的值，留空保存会保留原值；要清除就点 清除，此时状态变成 保存后清除，按钮变成 保留密钥。
模型
编辑器把模型分成两栏：左栏是 可选模型 选择器，右栏是所选模型的 模型设置。选择器是唯一的模型列表——点选一行，右栏就显示它的可编辑字段，而不是把列表再重复一遍。 Vibex 不预置模型列表：- 拉取模型 —— 需要已填 API Key 和地址，拉取该账号可用的模型来填充 可选模型。拉取本身不写入任何配置。
- 可选模型 —— 勾选一行会把这个模型加入草稿；取消勾选会移除它但保留已声明的能力，重新勾选即可恢复。全选 / 全部启用 可以批量处理；没有可拉取的模型时，在 自定义模型 里手动输入 id 再加入。
- Model ID / 显示名称 —— 在右栏编辑。选中状态按模型 id 跟踪，所以重命名之后右栏仍停在正在编辑的模型上。
- 模型接口协议 —— 每个模型可以单独指定通信协议，默认 继承（继承供应商设置）。
- 推理能力 / 思考档位 —— 选择是否推理，或声明思考深度档位。
- 上下文窗口 / 最大输出 Token —— 在 高级 折叠区中声明模型上限。
off、minimal、low、medium、high、xhigh、max。
在会话中使用
发送消息前，从输入框顶部的级联菜单选择 Agent、模型供应商、模型 和 思考深度。切换只影响后续运行；已有时间线保留原运行的 Agent 和模型信息。故障排查
- Agent 不在列表中：确认可执行文件在
PATH中，或检查自定义命令和参数。 - 模型不可选：先 刷新模型，再检查该模型是否已启用。
- 认证失败：确认账号状态，重新登录；不要在 Issue 中粘贴响应头或 token。
- 远程端看不到配置：确认设备权限级别是否为
full_control，以及当前连的是哪个权威运行时。 - 托管 Agent 安装失败：检查网络是否能访问 GitHub 与 nodejs.org，然后重试。