发布日期：2026-07-20 | 最后更新：2026-07-20

现代开发者与研究者正在将 Obsidian 与 Codex 结合，打造个人知识库的智能助手。从 Andrej Karpathy 管理 LLM 论文笔记，到 Reddit 用户通过 GitHub 远程触发 vault 操作，再到 2026 年社区插件市场的集中爆发，这套组合的价值已被广泛验证。但配置路径多样，容易让人困惑。本文为你梳理出 三种清晰的方向，每种都对应不同的工作习惯，你只需按需选择即可。

先想清楚你要什么

在装任何插件之前，先明确一个问题：你是想在 Obsidian 里开 Codex 对话窗口，还是让 Codex 能读写你的 Obsidian 笔记库？

三个方向，核心区别在于工作中心在哪里：

• 方向 A：Obsidian 侧插件——在 Obsidian 里直接调出 Codex 侧边栏，把当前笔记作为上下文提问、让 Codex 帮你重写段落、提交文件修改审查。工作中心在 Obsidian，Codex 是助手。适合写作型用户。
• 方向 B：Codex 桌面端 + vault 文件夹——打开 Codex 桌面应用，直接把 Obsidian vault 文件夹选为 workspace。不需要在 Obsidian 里装任何插件，适合不喜欢插件或已有 Codex 桌面端习惯的用户。
• 方向 C：Codex 侧 MCP——给 Codex CLI 装一个 MCP 服务器，让 Codex “看到”整个 vault 的文件结构、能搜索笔记、执行整理任务。工作中心在 Codex，Obsidian vault 是数据源。适合大规模知识库和自动化工作流。

方向 A 和方向 C 依赖 Codex CLI 本地安装：

# 安装 Codex CLI（官方安装脚本）
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# 运行后在项目目录里执行：
codex
# 首次会引导你"Sign in with ChatGPT"，登录完成后即可使用

方向 A：Codex Panel 插件（推荐新手，5 分钟上手）

Codex Panel 是 Obsidian 社区插件市场里目前下载量最高的 Codex 集成插件（5k+ 下载，Apache-2.0 协议）。它通过启动本地 codex app-server 工作，把 Obsidian 侧边栏变成一个 Codex 对话面板。

安装步骤：

1. 打开 Obsidian → 设置 → 第三方插件 → 关闭安全模式 → 浏览社区插件
2. 搜索 Codex Panel → 安装 → 启用

3. 如果 Obsidian 找不到 codex 命令：

   进入 设置 → Codex Panel → Codex executable，手动填入绝对路径：

   # macOS（Homebrew 安装）
   /opt/homebrew/bin/codex
   
   # 查找自己的安装路径
   which codex

4. 打开命令面板（Cmd/Ctrl + P）→ 输入 Codex Panel: Open panel → 回车

使用方式：

• 打开一篇笔记，在面板里输入问题时用 @active 引用当前文件内容
• @selection 引用你选中的文本
• 开启 Daily Notes 插件后可用 @today、@tomorrow、@yesterday 引用日记
• 选中一段 Markdown 文字后，运行 Rewrite selection 让 Codex 直接改写，改前可预览 diff
• 完成的对话可以 Archive as note，保存成一篇 Markdown 笔记归档

注意：该插件依赖 codex app-server（实验性 API，目前测试版本为 CLI v0.144.5），功能在未来版本中可能有变化。

小提示：如果启动后侧边栏空白，请检查终端中 codex app-server 是否在运行，或尝试重启 Obsidian。

适合场景：写作时随手问、整理笔记、局部重写、对话归档。

方向 A 的备选：Codex AI Agent 插件

如果你需要更强的自主 Agent 能力（如一次性处理多个文件、规划并执行多步骤任务），可以用 Codex AI Agent 插件。它支持 Ask（只读）/ Agent（可写）两种模式，有 Skills 体系，每个操作都会显示审批卡片而非静默执行。

目前该插件仍需从 GitHub 源码手动安装（非 Community Plugins 一键安装），适合熟悉命令行的用户。

还有一个专为“证据收集 → Codex 合成”工作流设计的插件 Codex Vault Agent（Community Plugins 可安装）：先从 vault 里手动圈定相关笔记，人工审核候选列表，再把审核后的内容包交给 Codex 生成报告或仪表盘，全程不静默写入。适合对笔记内容有控制欲、不想 Codex 自由发挥的用户。

方向 B：Codex 桌面端直接打开 vault（无需插件，最简单）

这是最容易被忽略的方案——Codex 桌面应用本身就能把任意本地文件夹作为 workspace 打开，Obsidian vault 是纯文本 Markdown 文件夹，完全可以。

配置步骤：

1. 下载并安装 Codex 桌面应用（在 chatgpt.com 登录后下载）
2. 打开桌面应用 → New workspace → 选择你的 Obsidian vault 文件夹

3. 在 vault 根目录创建 AGENTS.md，告诉 Codex 这是什么内容：

   # My Knowledge Vault
   
   这是我的 Obsidian 个人知识库，使用 Markdown 格式。
   - 笔记之间用 [[双链]] 互相引用
   - 每篇笔记都有 frontmatter（title、tags、date）
   - 修改笔记前先告诉我你要做什么，等我确认再执行

4. 在 Codex 对话框里直接描述任务，例如：

   • 在 Projects/ 文件夹里找所有包含 "待办" 标签的笔记，列出清单
   • 把 Inbox/ 里的新笔记按话题分类，建议归档路径
   • 找出所有没有出链的孤立笔记

当前的一个限制：桌面应用每个 workspace 目前只支持一个文件夹（GitHub issue #27943，Open 状态）。如果你把 AI 工作区和 vault 分开存放（不在同一目录下），可以用 CLI 的 --add-dir 参数变通：

# 同时挂载 AI 工作区（读写）和 vault（只读）
codex --add-dir /path/to/obsidian-vault

或者最简单的办法：把 vault 和工作区放在同一个父文件夹下，打开父文件夹作为 workspace。

常见问题：如果桌面应用无法识别 vault 中的 Markdown 链接，请确保使用了 AGENTS.md 文件告知 Codex vault 的结构，否则它可能无法理解双链语法。

适合场景：不想折腾插件、已经在用 Codex 桌面端做其他工作、想最快上手的用户。

方向 C：MCP 接入 vault（推荐进阶，适合大型知识库）

MCP（Model Context Protocol）方案让 Codex 在终端里就能直接操作你的 vault，不需要打开 Obsidian 界面。有三个选择，从轻到重：

选项 1：kika-obsidian-mcp（轻量，12 个工具）

适合刚开始探索的用户，Python 方案，不需要在 Obsidian 里装任何插件。

git clone https://github.com/aka-kika/kika-obsidian-mcp.git
cd obsidian-codex-mcp
python3 -m venv .venv && .venv/bin/python -m pip install -r requirements.txt

然后在 ~/.codex/config.toml 里添加 MCP 服务器配置，指定 Python 路径和 vault 路径：

[mcp_servers.obsidian]
command = "/path/to/obsidian-codex-mcp/.venv/bin/python"
args = ["-m", "obsidian_codex_mcp"]

[mcp_servers.obsidian.env]
OBSIDIAN_VAULT_PATH = "/Users/你的用户名/Documents/ObsidianVault"
OBSIDIAN_READ_ONLY = "true"        # 建议先开只读，熟悉后再关
OBSIDIAN_BACKUP_ON_WRITE = "true"  # 写入前自动备份

连接后 Codex 可执行：读写笔记、全文搜索、按标签查找、管理文件夹、获取反向链接。

选项 2：enquire-mcp（重型，44 个工具，大 vault 首选）

万级笔记规模下的高性能方案，支持六层混合检索（BM25 + 语义搜索 + HNSW 向量索引），NDCG@10 比标准全文搜索提升 15.5 分，10ms 内完成检索。

npm install -g @oomkapwn/enquire-mcp

# 初始化索引（首次运行，建立向量库）
enquire-mcp setup --vault /path/to/your/vault

# 在 codex 里添加
codex mcp add obsidian -- npx -y @oomkapwn/enquire-mcp serve 
  --vault "/path/to/vault" 
  --persistent-index --enable-reranker --use-hnsw

写入功能默认关闭，需要显式加 --enable-write 才能让 Codex 修改笔记。

注意：MCP 方案需要 Codex CLI 版本支持 mcp 子命令，请确保更新到最新版：codex update。

Karpathy 的用法：自动化交叉链接

Andrej Karpathy 用 Obsidian + Codex 维护他的 LLM 论文笔记库，核心是让 Codex 自动完成交叉链接——每新增一篇论文笔记，Codex 扫描库里的相关笔记，双向添加引用，并更新主索引。

具体流程：新增笔记 → Codex 提取关键概念 → 与已有笔记比对 → 注入双向链接 → git commit 记录变更。

这个模式的价值在于规模效应：约 50 篇笔记以上，交叉链接开始显现价值；超过 100 篇，自动化的回报开始超过手动维护。

GitHub 上有开箱即用的起点实现（greg-asher/codex-obsidian），包含 7 个 Obsidian 工作流 Skill，涵盖笔记读写、Bases 查询、workspace 管理等。

你现在就能做：五分钟验证方案

如果你想先验证效果再决定深入哪个方向，按这个顺序：

1. 确认 Codex CLI 已安装并登录（codex --version 有输出）
2. 打开 Obsidian，装 Codex Panel（Community Plugins 搜索，1 分钟）
3. 打开一篇笔记，开 Codex Panel，输入：@active 帮我提炼这篇笔记的三个核心观点
4. 看到结果后，选中笔记里的一段话，试试 Rewrite selection

跑通了再按需选择是否升级到桌面端 workspace 或 MCP 方案。

选择最适合你的组合

三个方向没有绝对优劣，完全取决于你的工作习惯：在 Obsidian 里写作的人用 Codex Panel，不想装插件的人直接用桌面端打开 vault 文件夹，需要自动化批量处理的人用 MCP。许多人会发现结合使用最顺手——写作时在 Obsidian 里开侧边栏问问题，需要批量整理时切到 Codex 桌面端或 CLI 跑任务。配置步骤基于 Codex CLI 2026 年 7 月当前版本（含 app-server 实验性 API），插件更新较快，遇到问题优先查各插件的 GitHub 仓库 Issues。

参考资料

• codex-obsidian Codex 插件：github.com/greg-asher/codex-obsidian
• kika-obsidian-mcp（原 obsidian-codex-mcp）：github.com/aka-kika/kika-obsidian-mcp

《夸克》非常好用的免费AI浏览器

下载APP查看