直接连接会把连接配置写入指定 AI 工具,由该工具直接请求上游供应商,不经过 OcHub 本地网关。这是最适合第一次上手的方式。
什么时候使用直接连接
- 第一次配置 OcHub。
- 一个工具只需要直接请求一个供应商地址。
- 希望继续使用工具自身的官方账号登录。
如果多个工具需要共用路由、模型别名或备用上游,请改用 模型供应商。
新增连接
-
选择应用。 从左侧“应用”分组打开要配置的工具。
-
打开编辑器。 点击“添加连接”。如果页面已经自动识别出本机配置,可以先编辑识别结果,不必重复创建。
-
选择起点。 有合适预设时先选预设;否则从空白配置开始。填写一个能区分用途的名称,例如“工作账号”或“备用节点”。
-
填写连接信息。 输入供应商要求的 API 地址和密钥。地址按供应商文档填写;模型供应商编辑器会自动处理
/v1,直接连接编辑器则以页面生成的文件预览为准。 -
检查配置。 底部“检查配置”验证格式和必填信息。高级页提供受支持的网络检查,但 URL 测试成功不代表账号或模型可用。
-
查看候选配置。 切到“配置文件”,确认目标路径和关键字段;最终文件由目标环境合并生成。
-
保存草稿或应用。 “保存到 OcHub”保留独立编辑草稿,未填完也能保存。准备完成后选择“应用到应用”或“写入应用”;草稿保存本身不会改写正式连接和目标配置。
逐步界面示意点击画面放大,左右方向键切换步骤;蓝色描边是当前要对照的位置。
STEP 01选择目标应用
STEP 02打开连接编辑器
STEP 03选择直接连接或模型供应商
STEP 04填写地址和密钥
STEP 05执行可用检查
STEP 06检查生成文件
STEP 07保存草稿或明确应用
添加与切换
连接卡片可能显示以下操作:
| 操作 | 含义 |
|---|---|
| 添加到工具 | 把连接加入工具配置,但不一定把它设为当前项 |
| 切换 | 写入或选择该连接,并把它设为当前项 |
| 导入 | 打开目标应用并由它确认导入,例如 Cherry Studio |
| 从工具移除 | 从工具配置移除该项,OcHub 中保存的连接仍然存在 |
| 删除 | 从 OcHub 删除连接;这是不可撤销操作 |
切换成功后,页面顶部“当前连接”会显示新的连接,并在卡片上标记“当前”。
验证是否生效
- 退出并重新打开目标 CLI,避免旧进程继续使用缓存配置。
- 发起一条短请求。
- 如果请求成功,再回到 OcHub 的用量页面刷新,确认是否出现会话或请求记录。
- 如果工具仍使用旧配置,检查应用设置中的配置目录是否与实际安装一致。
处理外部修改
如果当前连接的文件在 OcHub 之外被改动,下次切换时会显示并排差异:
- 保存为新版:把当前文件存入当前连接,再完成切换;以后切回来时恢复这个新版。
- 回退为旧版:丢弃当前文件修改,恢复已保存版本,再完成切换。
- 取消:当前文件和 OcHub 中保存的连接都不改变。
对于 Codex,弹窗会分别比较 auth.json 和 config.toml,格式错误的 auth.json 原始文本
也会纳入其中。
撤回
编辑器结果区仅在具备完整回执时显示“撤回本次应用”。它会先检查是否存在之后的新改动, 有冲突就拒绝覆盖。详见保存与应用的区别。
- 要换回其他连接,直接在同一应用页面点击其“切换”。
- 要恢复工具自身的登录状态,切换到“官方登录”连接。
- 要完全停止 OcHub 管理该工具,可在设置 → 应用与插件中点击“停用管理”;停用不会主动改写当前工具配置。

