OcHub 的核心工作很简单：选择一个 AI 工具，再决定让它直接连接供应商，还是先经过 OcHub 的本地网关。第一次使用时，先只完成其中一条路径。
从这里开始先选择要由 OcHub 管理的 AI 工具
直接连接
适合第一次配置，或每个工具分别使用一个上游
工具直接读取并使用供应商配置
模型供应商
适合共用上游、模型映射、接口转换和故障转移
O
请求先经过 OcHub 本地网关
最后必须从目标 CLI 发起一次真实请求
怎样算首次配置成功
同时满足下面三点，才算完成第一次配置：
- 目标应用页面把预期连接显示为“当前连接”。
- 重新打开的 CLI 能成功发起一条真实请求。
- 你知道如何切回官方登录或之前使用的连接。
在这个最小闭环跑通前，先不要继续配置 MCP、技能、定价、同步或复杂路由。
开始前
- 退出正在运行的 cc-switch，避免两个程序同时写入工具配置。
- 备份目标工具的配置目录，例如
~/.claude或~/.codex。 - 准备要使用的 API 地址与密钥；如果使用工具自身的官方登录，则不需要第三方密钥。
已经长期使用 cc-switch 时，建议先浏览迁移教程，再决定首次启动提示 中是否导入。
首次启动
-
确认欢迎提示。 阅读配置写入说明；如果检测到 cc-switch，OcHub 会列出可导入的连接、MCP 服务器和技能仓库。
-
决定是否迁移。 选择“导入并开始”会读取 cc-switch 数据；选择“跳过”不会删除或修改 cc-switch，之后仍可从设置 → 数据与备份重新导入。
-
选择要管理的应用。 在设置 → 应用与插件中保留需要的工具。停用应用只会把它从侧栏和系统菜单移除，不会删除已有数据或改动它的配置文件。
-
回到应用页面。 从左侧“应用”分组选择 Claude Code、Codex、Cherry Studio、Grok Build、Kimi Code、OpenCode、OpenClaw、Hermes 或 Claude Desktop。
逐步界面示意点击画面放大，左右方向键切换步骤；蓝色描边是当前要对照的位置。
STEP 01阅读欢迎提示
STEP 02决定是否导入
STEP 03选择要管理的应用
STEP 04打开第一个应用页面
认识主界面
| 区域 | 用途 |
|---|---|
| 应用 | 管理每个 AI 工具的直接连接和应用专属设置 |
| MCP 服务器 | 统一保存 MCP 配置并同步到多个工具 |
| 技能 | 搜索、安装、更新并分发可复用技能 |
| 用量 | 查看 Token、成本、缓存、延迟和请求明细 |
| 会话 | 浏览本机 CLI 的会话记录 |
| 高级工具 | 处理 CLI、备份、环境变量和工具专属配置 |
| 模型供应商 | 管理本地网关上游、模型映射和故障转移 |
| 主题 / 设置 | 管理外观、应用行为、数据和远端同步 |
选择连接方式
| 你的目标 | 建议方式 |
|---|---|
| 给一个工具配置一个 API 地址 | 直接连接 |
| 沿用工具自身的账号登录 | 直接连接中的“官方登录” |
| 多个工具共用同一个上游 | 模型供应商模式 |
| 需要模型改名、接口转换或故障转移 | 模型供应商模式 |
第一次使用建议先完成直接连接。确认目标 CLI 能正常发起一次请求后，再配置 MCP、技能或 更复杂的转发规则。