跳至指南

在 Claude Code 中使用 onemind

Claude Code（目标 id 为 claude_code，别名 claude）支持 onemind macOS 应用和 CLI。onemind 会把服务器组合的一个原子包写入明确绑定的 Project 目录中的 CLAUDE.md。原生 BETA 同步还会维护 ~/.claude/CLAUDE.md 中的稳定用户级引导区块；Project 内容保留在已绑定文件夹。

macOS 应用

  1. 登录 OneMind BETA.app；若宿主支持可验证的连接，从团队连接 Claude Code。
  2. 打开 Mind，选择目标 Project，在这台 Mac 上绑定精确文件夹。
  3. 打开已批准 Mind，选择同步，核对工具／设备后选择立即同步，等待交付确认。
  4. 从该文件夹新建 Claude Code 任务。等待、离线与恢复说明见 Mind 同步。

原生应用自行管理连接和文件夹绑定；CLI 仓库检测是独立终端流程。

CLI

在用于 Claude Code 的代码仓库中运行：

onemind project claude_code .

CLI 会检测到 Claude Code，并打印提示，要求你打开 onemind 并为检测到的文件夹选择 Project Mind。打开 onemind 应用，在同步设置中找到检测到的文件夹，将其绑定到目标 Project Mind。然后运行：

onemind sync
onemind status

确认 <代码仓库>/CLAUDE.md 包含组合后的 onemind 管理区块。首次写入时，onemind 会将此前的文件保存到 <代码仓库>/.one-mind/CLAUDE.md.backup。新建 Claude Code 会话。

Claude Code skills 安装在 ~/.claude/skills。使用 onemind integrations install claude_code 安装或更新该集成。

如果仓库或任意父目录已存在 AGENTS.md 文件且不存在 CLAUDE.md，CLI 将拒绝创建 CLAUDE.md，以避免改变 Claude Code 加载的共享指令。请先手动配置该 Project 的 CLAUDE.md 及所需导入，再运行同步。

Claude Code 任务运行期间，工具权限请求将出现在 Matrix 中。作为设备所有者，你可以在 Matrix 或 macOS 应用中回应请求，无需停止任务。在 Matrix 编辑器中，/ 斜杠命令可触达 Claude Code 操作，@ 会列出活跃会话的 Claude Code 子智能体。