支持的应用
| 应用 | 连接写入方式 | MCP | 技能 | 专属能力 |
|---|---|---|---|---|
| Claude Code | 当前连接切换 | 支持 | 支持 | 插件、角色模型、会话 |
| Claude Desktop | 当前连接切换 | 不支持 | 不支持 | 官方与第三方连接 |
| Codex | 当前连接切换 | 支持 | 支持 | OAuth、模型目录、会话历史 |
| Cherry Studio | Deep Link 确认导入 | 不支持 | 不支持 | 供应商与 API Key 导入 |
| Grok Build | 当前连接切换 | 支持 | 不支持 | Profile、API Backend |
| Kimi Code | 当前连接切换 | 不支持 | 不支持 | 供应商、模型、限制与能力 |
| OpenCode | 多连接共存 | 支持 | 支持 | 多模型、会话、OMO |
| OpenClaw | 多连接共存 | 不支持 | 不支持 | 默认模型、工具与环境变量 |
| Hermes | 多连接共存 | 支持 | 支持 | 模型、速率限制与记忆 |
“当前连接切换”表示实时配置重点保存当前连接;“多连接共存”表示多个连接可同时写入, 再由工具或 OcHub 选择当前项。 Cherry Studio 导入会打开它自己的确认弹窗,不直接写入应用数据库。
默认路径
| 内容 | 默认位置 |
|---|---|
| OcHub 数据 | ~/.ochub/ |
| OcHub 数据库 | ~/.ochub/ochub.db |
| 用户应用插件 | ~/.ochub/apps/*.toml |
| cc-switch 迁移源 | ~/.cc-switch/ |
| Claude Code | ~/.claude/,MCP 通常为 ~/.claude.json |
| Codex | ~/.codex/ |
| Grok Build | ~/.grok/ |
| Kimi Code | ~/.kimi-code/ |
| Cherry Studio | OcHub 不写入其数据目录;通过 cherrystudio:// 导入 |
| OpenCode | ~/.config/opencode/ |
| OpenClaw | ~/.openclaw/ |
| Hermes | ~/.hermes/ |
| Claude Desktop(macOS) | ~/Library/Application Support/Claude/ 与 Claude-3p/ |
| Claude Desktop(Windows) | %LOCALAPPDATA%\\Claude\\ 与 Claude-3p\\ |
应用设置中的自定义目录会覆盖表中默认路径。路径变化后建议重启 OcHub。
连接状态
| 状态 | 含义 |
|---|---|
| 当前 | 目标应用当前正在使用 |
| 已添加 | 已存在于工具配置,但不是当前连接 |
| 直接连接 | 工具直接请求供应商 |
| 模型供应商模式 | 工具先请求 OcHub 本地网关 |
| 已应用 | 某个模型供应商已经写入指定应用 |
| 已停用 | 配置仍保留,但不能被应用或路由 |
模型供应商接口
| 接口 | 常见客户端 |
|---|---|
| Anthropic Messages | Claude 兼容客户端 |
| OpenAI Chat | OpenAI Chat Completions 兼容客户端 |
| OpenAI Responses | 使用 Responses API 的客户端 |
自动路由优先使用客户端原生接口,并在模型不可用或接口故障时尝试其他已启用接口。接口转换 不能补足上游本身不支持的模型或能力。
MCP JSON 最小示例
stdio:
{
"type": "stdio",
"command": "my-mcp",
"args": ["--stdio"]
}SSE:
{
"type": "sse",
"url": "https://example.com/sse"
}服务器配置必须是 JSON 对象。具体字段由 MCP 服务器和目标应用共同决定。
常用术语
- 应用
- 由 OcHub 管理配置的 AI 工具,例如 Claude Code 或 Codex。
- 连接
- 提供 API、官方登录或模型服务的一组连接配置。
- 直接连接
- 目标工具直接请求供应商,不经过 OcHub 网关。
- 模型供应商
- OcHub 本地网关使用的上游配置,可处理接口转换、模型映射和接口候选重试。
- 配置漂移
- OcHub 上次读取后,实时配置又被其他程序或用户修改。
- 计价模型
- 用量统计实际套用价格的模型,可以来自请求模型或响应模型。
- 配置档
- 远端同步目录中的逻辑名称,用于让多套 OcHub 数据彼此隔离。
安全要点
- 不在问题、截图或文档中公开 API Key、OAuth 令牌和个人会话。
- 不把本地网关地址直接暴露到公网。
- 只运行可信来源的 MCP 命令和技能。
- 覆盖数据库、删除会话或删除连接前先备份。
- 不让 OcHub 与其他配置管理工具同时写入同一文件。

