果思 讓思考結出果實
進入 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

還有疑問？請查看 常見問題