10 分钟搞定！零基础搭建 Codex + Obsidian AI 知识库｜保姆级全流程

🪝 开头

2026年5月的某个深夜，我盯着 Obsidian 里 1300 多条散乱的笔记，第一次认真问了自己一个问题：

这些笔记，真的有用过吗？

收藏夹里还有 400 多条网址。Notion 里有 80 多个从没打开过的 Database。手机备忘录里有 200 多条语音转文字记录——它们安静地躺着，等我哪天"有空"回来整理。

我一直以为自己在"管理知识"，但那天我意识到：我只是在管理焦虑。

真正改变这一切的，是我花了一个下午，把 Codex 接进了 Obsidian。

从那以后，这个系统开始替我思考了一部分事情。

这篇文章，我想手把手带你从零开始搭好这套系统。不需要任何代码基础，不需要你是技术人，只需要一个下午。

「工具是配角，系统才是主角。但有时候，一个对的工具，能让你的系统真正活起来。」

这套系统能做什么——

🎬 效果预览：搭好之后，你的知识库会变成什么样

搭建之前：

• 笔记记了 3 年，每次找资料还是靠"记忆"，文件夹翻遍了找不到
• 看完一篇文章写了摘要，扔进文件夹，下次要用的时候还是不知道在哪
• Obsidian 有双向链接，但连接从来都是手动打，太懒，很少真的用

搭建之后：

• 给 Codex 一句话："把 Inbox 里的笔记按主题分类，推荐归档路径" — 它直接帮你整理好
• 问它"我上个月关于知识管理写了什么" — 它帮你跨文件语义搜索，5 秒给出总结
• 给它一篇原始资料，让它整理成结构化知识页并自动关联已有笔记 — 你的知识网络开始自己生长

用一句话总结这个系统的核心价值：

「前者是存资料，后者是编译知识。」

这就是 Codex + Obsidian 和你过去所有知识管理方式最本质的区别。

🧰 开始前的准备清单

先确认你需要的东西，一共 4 个，全部免费或低成本：

预计花费时间：10 - 30 分钟（取决于你的网络环境）

⚠️ 说一个真实情况：Codex 目前需要 OpenAI 账号，按使用量计费。日常知识管理用途，每月大概 2-8 美元左右，不会是大开销。如果你只是想先体验，跑通流程，花费几乎可以忽略不计。

📋 正式开始：分步实操

Step 1｜安装 Obsidian 并建立你的第一个 Vault

① 下载安装 Obsidian

前往 obsidian.md 下载对应系统版本，安装过程和普通软件一样，无需额外配置。

② 创建你的 Vault（知识库文件夹）

打开 Obsidian，点击「创建新库」，选择一个你能记住的本地路径，建议命名为：

text

MyBrain/         ← 你的 Vault 根目录
├── Inbox/       ← 所有原始输入先放这里
├── raw/         ← 原始资料、摘要、笔记草稿
├── wiki/        ← 整理好的成熟知识页
└── AGENTS.md    ← 后面会建，这是整个系统的灵魂文件

为什么要分这几个文件夹？

这里有个很重要的原则，很多教程跳过了，但它直接决定你的知识库以后会不会乱：

「raw 是原料，wiki 是成品。知识库必须分层，否则一年之后你连自己都搜索不到。」

Inbox 是你今天的随手记，不要求质量； raw 是你整理过一遍的原始资料，有基本结构； wiki 是你反复提炼过、可以直接被引用的成熟知识。

这三层，对应的是人类大脑处理信息的三个阶段：接收 → 消化 → 沉淀。

③ 建议同时安装的 Obsidian 插件（可选但推荐）

安装方法：Obsidian → 设置 → 第三方插件 → 浏览社区插件 → 搜索名称安装

Step 2｜安装 Node.js 和配置 MCP 接入

MCP（Model Context Protocol） 是让 Codex 能「读写」你的 Obsidian 笔记的桥梁。

⚠️ 别被这个词吓到。你只需要复制粘贴几行命令，3 分钟搞定。

① 安装 Node.js

前往 nodejs.org 下载 LTS 版本，安装完成后打开终端（Mac 用 Terminal，Windows 用 PowerShell），输入：

Bash

node -v

如果显示版本号（如 v22.0.0），说明安装成功。

② 安装 enquire-mcp（推荐方案）

1 enquire-mcp 是功能最完整的 Obsidian MCP 实现，提供六层混合检索，明确支持 OpenAI Codex。

在终端输入：

Bash

npm install -g @oomkapwn/enquire-mcp

③ 初始化你的 Vault 索引

Bash

enquire-mcp setup --vault /你的Vault完整路径/MyBrain

比如我的路径是：

Bash

enquire-mcp setup --vault /Users/yourname/Documents/MyBrain

④ 启动 MCP 服务

Bash

enquire-mcp serve --vault /你的Vault路径/MyBrain \
  --persistent-index \
  --enable-reranker \
  --use-hnsw \
  --enable-write

看到类似 MCP Server running on port 3000 的字样，就成功了。

⚠️ --enable-write 参数允许 Codex 写入你的笔记，默认是只读的，数据安全有保障。如果你只是想先测试不想让 AI 修改笔记，可以去掉这个参数。

Step 3｜在 Codex 中注册你的 Vault

打开 Codex Desktop（或 Codex CLI），进入设置 → MCP，添加一个新的 MCP Server：

JSON

{
"name": "obsidian-vault",
"command": "npx",
"args": [
"-y", "@oomkapwn/enquire-mcp", "serve",
"--vault", "/你的Vault路径/MyBrain",
"--persistent-index",
"--enable-write"
  ]
}

保存后重启 Codex，你会在工具栏看到 Obsidian 的 Vault 图标——这说明 Codex 已经「认识」你的知识库了。

Step 4｜写你的第一个 AGENTS.md（最重要的一步）

AGENTS.md 是 Codex 的自定义指令文件，允许你为 Codex 设置全局指导和工作流规范，Codex 在启动时会自动读取这个文件。

这是整个系统的灵魂。

很多教程走到上一步就结束了。但我发现，如果不写好 AGENTS.md，Codex 就像一个刚入职的实习生——聪明，但不知道你的规则，只能乱猜。

在你的 Vault 根目录下新建 AGENTS.md，写入以下内容（这是我用了3个月不断迭代出来的基础模板，直接复制可用）：

Markdown

# 关于我的知识库
## 身份
我是一个知识工作者，正在用这个 Obsidian Vault 管理我的个人成长笔记、读书摘要和工作思考。
## 知识库结构
- `Inbox/`：原始输入区，所有新内容先放这里，不要求格式
- `raw/`：经过一次整理的原始资料，有基本 frontmatter
- `wiki/`：成熟知识页，可以被其他笔记引用，需要高质量
## 核心规则
1. 不要未经确认删除或覆盖已有笔记内容
2. 新建正式笔记时必须加 frontmatter（包含 date、tags、status 字段）
3. 鼓励使用双向链接，将相关笔记连接起来
4. wiki/ 下的页面是精华，修改前需要告知我
5. 所有回复和笔记请使用中文
## 我的思考偏好
- 我偏好结构化输出：先结论，再论据，最后行动建议
- 我喜欢类比和隐喻，帮助我理解抽象概念
- 复杂概念请给我一个「一句话版本」和一个「详细版本」
## Vault 固定路径
主要 Vault：/你的Vault路径/MyBrain

写完保存，从现在起，Codex 每次启动都会先读这个文件。它终于开始「认识你」了。

Step 5｜跑通第一个真实任务（验收时刻）

在 Obsidian 的 Inbox 文件夹里，随手新建一个笔记，粘贴任何你最近看到的内容——一段话、一篇文章的链接、一个想法都行。

然后在 Codex 里输入：

text

读取我 Inbox 文件夹下的最新笔记，
帮我：
1. 提炼 3 个核心观点
2. 在 raw/ 下创建一页结构化摘要
3. 检查 wiki/ 下是否有相关笔记，如果有，在结尾加上关联链接

等待 10 - 30 秒……

如果你在 raw/ 文件夹下看到一个新的、已经格式化好的笔记出现了——

恭喜你，你的 AI 知识库已经活了。

❓ 常见问题 FAQ

Q1：MCP 服务启动了但 Codex 连接不上？ A：检查防火墙设置，确保 3000 端口没有被拦截。另外，Codex Desktop 和 MCP 服务需要在同一台设备上运行。

Q2：我的 Vault 里有很多旧笔记，会影响系统吗？ A：不影响。建议先把旧笔记放进 raw/ 文件夹，等系统跑稳了再让 Codex 帮你批量整理。不要一开始就让它处理全库，先从 Inbox 的新笔记开始练手。

Q3：Codex 会不会修改我的笔记把原来的内容弄丢？ A：默认配置下是只读的。开启 --enable-write 后建议同时用 Git 做版本备份，这样任何修改都可以回滚。

Q4：不懂代码，终端命令看起来很恐怖，怎么办？ A：复制粘贴就够了。这篇文章里所有命令你只需要把路径换成自己的就行。遇到报错，把报错信息直接粘贴给 Codex 或 ChatGPT，它们会告诉你怎么修。

Q5：Node.js 安装完路径有问题怎么办？ A：Mac 用户建议用 nvm 管理 Node 版本，Windows 用户安装时勾选「自动配置 PATH」选项。

🔮 进阶方向

这篇是起点，不是终点。

你现在搭好的是一个基础版的 AI 知识库。接下来还有很多可以做的事：

「一个真正好用的第二大脑，不是靠纪律堆出来的，是靠工具替你省掉那些机械操作。」

现在，你已经把这扇门推开了一条缝。