果思 让思考结出果实
进入 Vibe Mind

接入指南

把 Vibe Mind 接入你的 Agent

最快的方式：把一句话发给 Agent，让它自己接入。也可以手动配置：添加 MCP，在浏览器里授权（或使用访问令牌）。每台电脑装一次，所有项目通用。

接入进度
  • 邮箱已验证
  • 已在浏览器授权
  • Claude Code 已连接
  • project_list 调用成功
★

一句话接入（推荐）

把下面这句话发给 Agent（Claude Code、Cursor 等）。它会读取接入指南、添加 MCP，问你选浏览器授权还是访问令牌，再写好使用习惯、装上 skill。

发给 Agent 
请按 https://vibe-mind.iguos.com/install.md 接入 Vibe Mind

也可以按下面的步骤手动配置。

1

注册并验证邮箱

进入 Vibe Mind，使用邮箱注册，然后点击验证邮件中的链接完成验证。也可以跳过这一步：接入时浏览器会打开授权页，可以在那里当场注册。

进入 Vibe Mind

2

选择认证方式

支持 MCP OAuth 的 Agent（Claude Code、Cursor 等）推荐用浏览器授权：连接时打开 Vibe Mind 授权页，登录后选好可访问的项目、点「允许」即可，不用复制令牌，令牌每小时自动续期。不支持 OAuth 的 Agent，在左侧栏「AI 接入」页生成访问令牌：

  • 可以限定令牌能访问的项目，并设置有效期
  • 令牌只在生成时完整显示一次，请妥善保存
  • 建议每台电脑或每个 Agent 单独生成一个，方便单独吊销
3

把 MCP 配置加入 Agent

「AI 接入」页的「手动配置」按 Agent 给出了配置，下面是示例。推荐的 OAuth 写法不用令牌；用访问令牌时，把 vm_xxxxxxxxxxxxxxxx 替换为你的令牌。

Claude Code

推荐：执行下面两条命令，第二条会在浏览器里打开授权页，登录后点「允许」（也可以在 Claude Code 里输入 /mcp，选中 vibe-mind → Authenticate）：

终端 
claude mcp add --transport http --scope user vibe-mind https://vibe-mind.iguos.com/mcp
claude mcp login vibe-mind

或者用访问令牌：

终端 
claude mcp add --transport http --scope user vibe-mind https://vibe-mind.iguos.com/mcp \
  --header "Authorization: Bearer vm_xxxxxxxxxxxxxxxx"

也可以写进项目根目录的 .mcp.json，和团队共用同一份配置（令牌放在环境变量 VIBE_MIND_TOKEN 里，各自填写）：

.mcp.json 
{
  "mcpServers": {
    "vibe-mind": {
      "type": "http",
      "url": "https://vibe-mind.iguos.com/mcp",
      "headers": {
        "Authorization": "Bearer ${VIBE_MIND_TOKEN}"
      }
    }
  }
}

Codex

推荐：在 ~/.codex/config.toml 里加上下面这段，再在终端执行 codex mcp login vibe-mind，浏览器里登录后点「允许」：

~/.codex/config.toml 
[mcp_servers.vibe-mind]
url = "https://vibe-mind.iguos.com/mcp"

或者用访问令牌：在同一段里加上 bearer_token_env_var，再在 shell 配置里把环境变量 VIBE_MIND_TOKEN 设成你的令牌（Codex 只从环境变量读令牌）：

~/.codex/config.toml 
[mcp_servers.vibe-mind]
url = "https://vibe-mind.iguos.com/mcp"
bearer_token_env_var = "VIBE_MIND_TOKEN"

Gemini CLI

推荐：在 ~/.gemini/settings.json 的 mcpServers 里只写地址（文件已有内容就合并），然后在 Gemini CLI 里输入 /mcp auth vibe-mind，浏览器里登录后点「允许」：

~/.gemini/settings.json 
{
  "mcpServers": {
    "vibe-mind": {
      "httpUrl": "https://vibe-mind.iguos.com/mcp"
    }
  }
}

或者用访问令牌：

~/.gemini/settings.json 
{
  "mcpServers": {
    "vibe-mind": {
      "httpUrl": "https://vibe-mind.iguos.com/mcp",
      "headers": {
        "Authorization": "Bearer vm_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursor

推荐：在 Cursor 的 MCP 配置文件（全局的 ~/.cursor/mcp.json，或项目内的 .cursor/mcp.json）里只写地址，然后在 Cursor 的 MCP 设置里点登录、在浏览器里点「允许」：

mcp.json 
{
  "mcpServers": {
    "vibe-mind": {
      "url": "https://vibe-mind.iguos.com/mcp"
    }
  }
}

或者用访问令牌：

mcp.json 
{
  "mcpServers": {
    "vibe-mind": {
      "url": "https://vibe-mind.iguos.com/mcp",
      "headers": {
        "Authorization": "Bearer vm_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

通用 Agent

任何支持远程 MCP（Streamable HTTP）的 Agent 都可以接入：支持 OAuth 的只填服务地址，按提示在浏览器里授权；不支持的在请求头中携带 Authorization: Bearer <你的访问令牌>。服务地址为 https://vibe-mind.iguos.com/mcp

4

验证连接

新开一个 Agent 对话（已经开着的对话看不到刚接上的 Vibe Mind），让它调用 project_list。能看到项目列表（新账号至少有默认项目 @knowhow，也就是通用经验）就说明接入成功，「AI 接入」页也会显示这个授权或令牌的最近使用时间。你的习惯偏好默认不开：想让 Agent 按你的习惯做事，在控制台的「灵犀」页启用，列表里会多出 @brain。

5

装上钩子，让每次工作都走 Vibe Mind

光靠使用习惯，Agent 会忘。钩子保证每次都以 Vibe Mind 为准（Claude Code、Codex、Gemini CLI、Cursor 都支持）：

  • 开工时自动把当前项目的记忆和使用规则放进上下文，不用 Agent 自己去读；你发第一句话时，再按那句话补上相关的记忆（每个会话只查一次）
  • 收尾时，如果改了代码、做了提交，或你说了纠正、定规矩的话，却还没写进 Vibe Mind，会拦一次让 Agent 补记；会话中途关掉或被压缩，下次开工补上（纯聊天不拦）
  • Agent 自带的本机记忆保留作兜底，两边不一致时以 Vibe Mind 为准

Claude Code：下载钩子脚本，再把下面这段合并进 ~/.claude/settings.json。钩子令牌放在 ~/.vibe-mind/hook-token：用 OAuth 授权的，让 Agent 调用 MCP 工具 hook_token 生成；用访问令牌的，放同一个令牌。

终端 
mkdir -p ~/.vibe-mind && curl -fsSL https://vibe-mind.iguos.com/hooks/vibe-mind-hook.sh \
  -o ~/.vibe-mind/hook.sh && chmod +x ~/.vibe-mind/hook.sh
~/.claude/settings.json 
{
  "hooks": {
    "SessionStart": [{ "matcher": "startup|clear|compact",
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh claude start zh" }] }],
    "UserPromptSubmit": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh claude prompt zh" }] }],
    "Stop": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh claude stop zh" }] }],
    "SessionEnd": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh claude end zh" }] }],
    "PreCompact": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh claude end zh" }] }]
  }
}

Codex：同一个脚本，把下面这段合并进 ~/.codex/hooks.json，再在 Codex 里输入 /hooks 信任这几个钩子（不信任不会运行）。

~/.codex/hooks.json 
{
  "hooks": {
    "SessionStart": [{ "matcher": "startup|resume|clear|compact",
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh codex start zh" }] }],
    "UserPromptSubmit": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh codex prompt zh" }] }],
    "Stop": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh codex stop zh" }] }],
    "SessionEnd": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh codex end zh" }] }],
    "PreCompact": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh codex end zh" }] }]
  }
}

Gemini CLI：同一个脚本，把下面这段合并进 ~/.gemini/settings.json。

~/.gemini/settings.json 
{
  "hooks": {
    "SessionStart": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh gemini start zh" }] }],
    "BeforeAgent": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh gemini prompt zh" }] }],
    "AfterAgent": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh gemini stop zh" }] }],
    "SessionEnd": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh gemini end zh" }] }],
    "PreCompress": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh gemini end zh" }] }]
  }
}

Cursor：同一个脚本，把下面这段合并进 ~/.cursor/hooks.json。Cursor 发话时的钩子补不了上下文，所以没有「第一句话」这一项，开工时的使用规则会让 Agent 收到第一句话后自己查。

~/.cursor/hooks.json 
{
  "version": 1,
  "hooks": {
    "sessionStart": [{ "command": "bash ~/.vibe-mind/hook.sh cursor start zh" }],
    "stop": [{ "command": "bash ~/.vibe-mind/hook.sh cursor stop zh" }],
    "sessionEnd": [{ "command": "bash ~/.vibe-mind/hook.sh cursor end zh" }],
    "preCompact": [{ "command": "bash ~/.vibe-mind/hook.sh cursor end zh" }]
  }
}

一句话接入会把这些全部装好。完整说明（含项目级 / 云端安装）见 install.md

6

用好 Vibe Mind 的记忆

接入后，可以这样让 Agent 更好地记录和复用经验：

  • 开工前，让 Agent 用 memory_context 带上这次要做的事，一次读到项目说明和相关记忆
  • 做完一个决策或解决一个问题后，让 Agent 把背景、结论和原因写进对应模块
  • 定期在控制台中审阅，把确认无误的版本存成快照
  • 需要你过目的总结、进度和待决定的问题，让 Agent 写进工作手记

把这些习惯写进 Agent 的全局说明（Claude Code 是 ~/.claude/CLAUDE.md，Codex 是 ~/.codex/AGENTS.md，Gemini CLI 是 ~/.gemini/GEMINI.md），每次开工都会遵循。可以直接使用下面这段，首尾两行标记别删：以后出了新版，Agent 会按提示只替换标记之间的内容。

~/.claude/CLAUDE.md · ~/.codex/AGENTS.md · ~/.gemini/GEMINI.md 
<!-- VIBE_MIND_START -->
## Vibe Mind：脑、手与工作手记（用途不同，别放错）
- 判断标准：以后的 Agent 开工时需要读到它吗？需要 → 记忆（memory_write）；只是写给人看 → 工作手记（worknote_write）。
- 记忆写哪里：只对这个项目成立的（换一个人来接手也要遵守）→ 当前项目，project 用仓库名，路径「模块/分类/标题」，分类用 conventions / decisions / pitfalls / runbooks / external / architecture / todo；关于用户本人、换个项目也成立的 → project=@brain（用户叫它「灵犀」）的 5 份固定文件（boundaries 能不能做 / soul 怎么取舍 / goals 为了什么 / workstyle 怎么做 / profile 我是谁），只记用户当面说过或纠正过的，每条写依据，用 append / replace_text 改；换个项目也用得上的本事 → project=@knowhow。
- 用户纠正你、定规矩时，先看适用范围再定去处，别按「是用户说的」就写灵犀：只在这个项目成立的（分支怎么拉、怎么发版、谁执行 SQL、这个产品的功能取舍）→ 项目的 conventions；换个项目也成立的个人习惯（回复语言、提交署名、审美、沟通方式）→ @brain；拿不准先放项目。例：「修 bug 从 next 拉分支」是项目约定，不是灵犀。
- 开工：先 project_list，再用 memory_context 带上这次要做的事，一次拿到 Brain、相关的通用经验、项目说明和记忆；按 Brain 做事，底线最优先，拿不准按灵魂取舍。新项目先补齐三篇：README（项目是什么）、project/runbooks/setup（新电脑怎么搭环境，钥匙只写放哪）、project/todo/next-steps（进度和下一步）。做完一个决策、解决一个问题就写进去，沿用已有的项目名和模块名；收尾前把进度和下一步更新到 todo。现状以代码为准，「为什么、以后要怎样」以记忆为准，对不上就当场改记忆。
- 整理：用户说「整理一下」，或开工上下文提示建议整理时，调 memory_tidy 拿整理清单，照着合并重复、挪对地方、改正过时的、把通用的本事提炼进 @knowhow，写一篇「整理记录」工作手记，再带 done=true 调一次。手头有活先干活。
- 工作手记：写给人看的东西（开工时不用读）——工作总结、进度说明、排查过程、方案对比、需要人决定的问题。用 worknote_write 按「项目 + 标题」写（同一标题再写会更新同一篇，append 可追加进度），写完把返回的链接告诉用户。你写的可以用 worknote_list / worknote_read 查看、worknote_delete 删除（进回收站）；用户写的（或用户已接管的）只能看。
- 不要把给人看的总结、汇报写进记忆；也不要把以后要用的经验只写进工作手记（开工时读不到）。
- 以 Vibe Mind 为准：经验一律写进 Mind；你自带的本机记忆只作兜底（Mind 连不上时先记在本机，连上后补写进 Mind），两边不一致时以 Mind 为准。
- 用户让你用的 Vibe Mind 工具在你的工具列表里找不到，说明这次 MCP 连接是在那个工具上线前建立的：提醒用户重连 Vibe Mind MCP 或新开一个会话，不要换别的办法绕过。
- 这段说明的版本：vibe-mind-habits-v6。开工上下文提示有新版时，按提示替换 VIBE_MIND_START 与 VIBE_MIND_END 之间的内容，不用问用户。
<!-- VIBE_MIND_END -->

还可以装上 Vibe Mind skill：Claude Code 放在 ~/.claude/skills/vibe-mind/，Codex、Gemini CLI、Cursor 放在 ~/.agents/skills/vibe-mind/。 SKILL.md

终端 
# Claude Code
mkdir -p ~/.claude/skills/vibe-mind && curl -fsSL https://vibe-mind.iguos.com/skills/vibe-mind/SKILL.md \
  -o ~/.claude/skills/vibe-mind/SKILL.md
# Codex, Gemini CLI, Cursor
mkdir -p ~/.agents/skills/vibe-mind && curl -fsSL https://vibe-mind.iguos.com/skills/vibe-mind/SKILL.md \
  -o ~/.agents/skills/vibe-mind/SKILL.md

还有疑问？查看 常见问题