发布日期2026-07-20 | 最后更新2026-07-20Obsidian 和 Codex 的组合正在成为开发者和研究者的新标配。Andrej Karpathy 用这套工具管理自己的 LLM 研究笔记库Reddit 上有人发现可以通过 GitHub 从手机远程触发 Codex 操作自己的 vaultObsidian 社区插件市场里与 Codex 相关的插件在 2026 年集中爆发。本文把配置思路整理清楚三个方向各有适用场景按需选一个。先想清楚你要什么在装任何插件之前先明确一个问题你是想在 Obsidian 里开 Codex 对话窗口还是让 Codex 能读写你的 Obsidian 笔记库三个方向核心区别在于工作中心在哪里方向 AObsidian 侧插件——在 Obsidian 里直接调出 Codex 侧边栏把当前笔记作为上下文提问、让 Codex 帮你重写段落、提交文件修改审查。工作中心在 ObsidianCodex 是助手。适合写作型用户。方向 BCodex 桌面端 vault 文件夹——打开 Codex 桌面应用直接把 Obsidian vault 文件夹选为 workspace。不需要在 Obsidian 里装任何插件适合不喜欢插件或已有 Codex 桌面端习惯的用户。方向 CCodex 侧 MCP——给 Codex CLI 装一个 MCP 服务器让 Codex 看到整个 vault 的文件结构、能搜索笔记、执行整理任务。工作中心在 CodexObsidian vault 是数据源。适合大规模知识库和自动化工作流。方向 A 和方向 C 依赖Codex CLI 本地安装# 安装 Codex CLI官方安装脚本curl-fsSLhttps://chatgpt.com/codex/install.sh|sh# 运行后在项目目录里执行codex# 首次会引导你Sign in with ChatGPT登录完成后即可使用方向 ACodex Panel 插件推荐新手5 分钟上手Codex Panel是 Obsidian 社区插件市场里目前下载量最高的 Codex 集成插件5k 下载Apache-2.0 协议。它通过启动本地codex app-server工作把 Obsidian 侧边栏变成一个 Codex 对话面板。安装步骤打开 Obsidian → 设置 → 第三方插件 → 关闭安全模式 → 浏览社区插件搜索Codex Panel→ 安装 → 启用如果 Obsidian 找不到codex命令进入设置 → Codex Panel → Codex executable手动填入绝对路径# macOSHomebrew 安装 /opt/homebrew/bin/codex # 查找自己的安装路径 which codex打开命令面板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功能在未来版本中可能有变化。适合场景写作时随手问、整理笔记、局部重写、对话归档。方向 A 的备选Codex AI Agent 插件如果你需要更强的自主 Agent 能力如一次性处理多个文件、规划并执行多步骤任务可以用Codex AI Agent插件。它支持 Ask只读/ Agent可写两种模式有 Skills 体系每个操作都会显示审批卡片而非静默执行。目前该插件仍需从 GitHub 源码手动安装非 Community Plugins 一键安装适合熟悉命令行的用户。还有一个专为证据收集 → Codex 合成工作流设计的插件Codex Vault AgentCommunity Plugins 可安装先从 vault 里手动圈定相关笔记人工审核候选列表再把审核后的内容包交给 Codex 生成报告或仪表盘全程不静默写入。适合对笔记内容有控制欲、不想 Codex 自由发挥的用户。方向 BCodex 桌面端直接打开 vault无需插件最简单这是最容易被忽略的方案——Codex 桌面应用本身就能把任意本地文件夹作为 workspace 打开Obsidian vault 是纯文本 Markdown 文件夹完全可以。配置步骤下载并安装 Codex 桌面应用在 chatgpt.com 登录后下载打开桌面应用 →New workspace→ 选择你的 Obsidian vault 文件夹在 vault 根目录创建AGENTS.md告诉 Codex 这是什么内容# My Knowledge Vault 这是我的 Obsidian 个人知识库使用 Markdown 格式。 - 笔记之间用 [[双链]] 互相引用 - 每篇笔记都有 frontmattertitle、tags、date - 修改笔记前先告诉我你要做什么等我确认再执行在 Codex 对话框里直接描述任务例如在 Projects/ 文件夹里找所有包含 待办 标签的笔记列出清单把 Inbox/ 里的新笔记按话题分类建议归档路径找出所有没有出链的孤立笔记当前的一个限制桌面应用每个 workspace 目前只支持一个文件夹GitHub issue #27943Open 状态。如果你把 AI 工作区和 vault 分开存放不在同一目录下可以用 CLI 的--add-dir参数变通# 同时挂载 AI 工作区读写和 vault只读codex --add-dir /path/to/obsidian-vault或者最简单的办法把 vault 和工作区放在同一个父文件夹下打开父文件夹作为 workspace。适合场景不想折腾插件、已经在用 Codex 桌面端做其他工作、想最快上手的用户。方向 CMCP 接入 vault推荐进阶适合大型知识库MCPModel Context Protocol方案让 Codex 在终端里就能直接操作你的 vault不需要打开 Obsidian 界面。有三个选择从轻到重选项 1kika-obsidian-mcp轻量12 个工具适合刚开始探索的用户Python 方案不需要在 Obsidian 里装任何插件。gitclone https://github.com/aka-kika/kika-obsidian-mcp.gitcdobsidian-codex-mcp python3-mvenv .venv.venv/bin/python-mpipinstall-rrequirements.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 可执行读写笔记、全文搜索、按标签查找、管理文件夹、获取反向链接。选项 2enquire-mcp重型44 个工具大 vault 首选万级笔记规模下的高性能方案支持六层混合检索BM25 语义搜索 HNSW 向量索引NDCG10 比标准全文搜索提升 15.5 分10ms 内完成检索。npminstall-goomkapwn/enquire-mcp# 初始化索引首次运行建立向量库enquire-mcp setup--vault/path/to/your/vault# 在 codex 里添加codex mcpaddobsidian -- npx-yoomkapwn/enquire-mcp serve\--vault/path/to/vault\--persistent-index --enable-reranker --use-hnsw写入功能默认关闭需要显式加--enable-write才能让 Codex 修改笔记。Karpathy 的用法自动化交叉链接Andrej Karpathy 用 Obsidian Codex 维护他的 LLM 论文笔记库核心是让 Codex 自动完成交叉链接——每新增一篇论文笔记Codex 扫描库里的相关笔记双向添加引用并更新主索引。具体流程新增笔记 → Codex 提取关键概念 → 与已有笔记比对 → 注入双向链接 → git commit 记录变更。这个模式的价值在于规模效应约 50 篇笔记以上交叉链接开始显现价值超过 100 篇自动化的回报开始超过手动维护。GitHub 上有开箱即用的起点实现greg-asher/codex-obsidian包含 7 个 Obsidian 工作流 Skill涵盖笔记读写、Bases 查询、workspace 管理等。你现在就能做五分钟验证方案如果你想先验证效果再决定深入哪个方向按这个顺序确认 Codex CLI 已安装并登录codex --version有输出打开 Obsidian装Codex PanelCommunity Plugins 搜索1 分钟打开一篇笔记开 Codex Panel输入active 帮我提炼这篇笔记的三个核心观点看到结果后选中笔记里的一段话试试Rewrite selection跑通了再按需选择是否升级到桌面端 workspace 或 MCP 方案。结语三个方向没有绝对优劣看你的工作习惯在 Obsidian 里写作的人用 Codex Panel不想装插件的人直接用桌面端打开 vault 文件夹需要自动化批量处理的人用 MCP。大部分人会发现结合用最顺手——写作时在 Obsidian 里开侧边栏问问题需要批量整理时切到 Codex 桌面端或 CLI 跑任务。本文配置步骤基于 Codex CLI 2026 年 7 月当前版本含app-server实验性 API插件更新较快遇到问题优先查各插件的 GitHub 仓库 Issues。参考资料Codex Panel Obsidian 插件页community.obsidian.md/plugins/codex-panelCodex AI Agent 插件页community.obsidian.md/plugins/codex-ai-agentCodex Vault Agent 插件页community.obsidian.md/plugins/codex-vault-agentCodex CLI 官方文档learn.chatgpt.com/docs/cliGitHub issue #27943桌面端多文件夹 workspacegithub.com/openai/codex/issues/27943codex-obsidian Codex 插件github.com/greg-asher/codex-obsidiankika-obsidian-mcp原 obsidian-codex-mcpgithub.com/aka-kika/kika-obsidian-mcpenquire-mcpnpmjs.com/package/oomkapwn/enquire-mcp
