管理连接

OcHub 为每个应用分别保存连接。Claude Code 中的连接不会自动出现在 Codex 中，但可以 使用“复制到应用”转换为目标工具的格式。

自动发现已有配置

打开应用页面时，OcHub 会尝试读取该工具当前的实时配置：

• 能识别的连接会出现在“直接连接”列表中。
• 已写入工具但尚未设为当前项的连接会显示“已添加”。
• 当前正在使用的连接会显示“当前”。
• 无法完整识别的自定义字段应先查看写入预览，避免重新保存时丢失。

连接的日常操作

删除前如果该连接仍是当前项，先切换到其他项。

官方登录

“使用官方登录”不会写入第三方 Base URL 或 API Key，而是沿用工具自身的登录状态。适合：

• Claude Code 或 Codex 已完成官方账号登录。
• 临时从第三方 API 切回官方服务。
• 希望保留工具原生的账号和订阅能力。

对于 Codex，auth.json 和 config.toml 都属于当前连接版本。任一文件在 OcHub 外被修改后， 如果希望保留修改，应在切走前查看差异并保存为新版。

应用专属设置

在应用页面右上角打开“应用设置”：

自定义目录会影响配置、MCP 或会话历史的读取位置。保存后建议重启 OcHub 和目标工具。

编辑器中的检查工具

• 测试 URL：测量端点返回 HTTP 响应的延迟。
• 拉取模型：使用当前地址和密钥获取模型列表。
• 查询余额：仅对实现了余额接口的供应商有效。
• 将写入的文件：展示保存或切换时生成的配置内容和目标路径。
• 通用配置：把应用级共享片段合并到启用该选项的连接。

测试成功不代表模型一定可调用。最终以目标 CLI 发起的真实请求为准。

配置被外部修改

OcHub 会把每个当前连接视为一个已保存的配置版本。切换前，它会比较这个版本与磁盘上的 当前文件：

1. 查看并排文件差异。红色是已保存版本，绿色是当前文件。
2. 选择“保存为新版”，把当前文件存入当前连接后再切换；以后切回来时会恢复这个新版。
3. 选择“回退为旧版”，丢弃磁盘上的当前修改，恢复已保存版本后再切换。
4. 选择“取消”，OcHub 数据和当前文件都不会改变。

该流程适用于所有可读取实时配置的切换型应用，包括 Claude Code、Codex、Grok Build、 Kimi Code 和切换型插件。Codex 会把 auth.json 与 config.toml 分开展示；即使 auth.json 不是合法 JSON，其原始文本也会纳入差异，并可原样保存和恢复。

不要让 OcHub、cc-switch 和手工编辑器同时修改同一份配置。

验证新连接

在任何应用中保存或切换连接后：

1. 查看生成的文件与路径。
2. 保存后确认卡片状态是“已添加”或“当前”。
3. 完全重启目标工具。
4. 选择新的 Provider 与模型。
5. 发起一条短请求。
6. 检查工具错误、OcHub 用量或上游日志。

按应用查看字段说明

需要从旧管理器带入连接时，不要手工逐条复制，先查看 从 cc-switch 迁移。