跳到正文
OcHub

使用参考

支持应用、默认路径、连接模式和常用术语速查。

更新于 查看 Markdown
For humans

支持的应用

应用 连接写入方式 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 与其他配置管理工具同时写入同一文件。
Navigation

Type to search…

↑↓ navigate↵ selectEsc close