你有没有这种体验:打开 Obsidian,想让 AI 帮你整理笔记,然后……只能把内容复制出来,粘到 ChatGPT,再把结果粘回去。来回折腾三次,你已经不想整理了。
更别提收藏了几百篇文章、记了几年笔记,却从来没有"融合"成一个真正属于你的知识系统。每次要用时,你只能靠记忆搜索,或者随缘翻到。
苏米注:这正是 Obsidian 用户的痛点——笔记越积越多,但"调用"成本越来越高。AI Agent 的出现,第一次让笔记真正"活"了起来。
但现在,已经有了一个干净的解法。

核心思路:用 Codex CLI 直接操作你的 Obsidian 知识库
不用多买任何东西,有 ChatGPT Plus(¥140/月)就够了。你现有的笔记,将变成一个能被 AI 搜索、整理、自动更新的活系统。
很多人以为 Codex 只是 OpenAI 的一个代码工具,其实它早就不止于此了。简单说:Codex CLI 是一个跑在你本地终端里的 AI Agent。它能读你电脑上的任何文件、搜索、修改、新建,还能调用外部工具。你给它一句指令,它自己想办法完成。
而 Obsidian 的笔记,说白了就是一堆本地 Markdown 文件。Codex CLI 天然可以直接操作它们——不需要任何 API,不需要云端同步,完全在你自己的机器上跑。
目前,Codex CLI 最新版本是 0.131.0,支持 macOS、Windows、Linux,已有超过 300 万周活用户。
费用说明:Codex CLI 已包含在 ChatGPT Plus(¥140/月)、Pro、Business 等所有付费计划中,不需要额外付费。如果你已经在用 ChatGPT,直接装就能用。
三步装好
不用担心技术门槛,流程非常直接:
① 安装 Codex CLI
确保电脑装了 Node.js(推荐 v22),然后终端运行:
npm install -g @openai/codex@0.131.0
# macOS 也可以用 Homebrew
brew install --cask codex
② 登录你的 ChatGPT 账号
终端输入 codex,第一次运行会弹出浏览器让你登录 ChatGPT 账号,授权后自动完成。用你已有的 Plus 账号就行,不需要额外设置 API Key。
③ 进入 Obsidian Vault 目录,使用
关键在这里——把终端工作目录切到你的 Obsidian Vault 文件夹,Codex 就能"看见"你所有的笔记了:
cd ~/Documents/MyObsidianVault
codex
就这三步。Codex 打开后是一个交互式终端界面,你可以直接用中文跟它对话。
5 个实用场景
光说"能管理笔记"太虚。来看几个真实能用的场景:
场景 1:一句话生成年度会议索引
对 Codex 说:"帮我把 work-meetings 文件夹里 2025 年所有的会议笔记,整理成一个带链接的 index.md。"30 秒后,一份格式整齐、链接全部可点的索引文件就生成了。
场景 2:自动同步 Linear/Notion 任务
通过 Codex 的 Skills 功能,可以把待办任务自动同步到 Obsidian 的 Tasks.md。配置一次,之后每次只需输入一个自定义命令,AI 就帮你完成同步,不用手动复制粘贴。
场景 3:跨笔记语义检索
问 Codex:"我有哪些笔记提到了'认知负荷'?帮我找出来并总结关键观点。"它会遍历整个 Vault,返回所有相关内容的摘要,比搜索关键词精准得多。
场景 4:用你的历史笔记辅助写作
写公众号文章时,让 Codex 搜索你三年来所有相关笔记中的金句和观点,自动融合进草稿。你的文章,真的开始有你自己的积累了。
场景 5:自动抓取网页存入知识库
配合 MCP fetch 工具,让 Codex 读取任意网页内容,提炼摘要后自动存成 Obsidian 笔记。读到好文章,再也不只是"收藏"了。
用 Skills 定制 AI 工作流
Codex 有一个叫Skills的功能,相当于"自定义工作流脚本"。你可以写一个 Skills 文件,告诉 Codex 遇到某种任务时该怎么做,之后用 / 加名称一键触发。
比如你可以创建一个叫daily-review的 Skill:
# ~/.agents/skills/daily-review.md
## 任务
每天结束时,汇总今天新增或修改的所有笔记
## 步骤
1. 找到今天创建或编辑的所有文档
2. 阅读内容,提炼今日学到了什么
3. 按照 daily-template 模板生成日报
4. 保存到 daily-notes/ 目录
配置好后,每天晚上输入 /daily-review,Codex 自动帮你完成复盘。不用思考流程,只用享受结果。
目前社区里已经有官方 Codex Obsidian 插件(codex-obsidian),内置了六大类 Obsidian 操作技能,包括笔记读写、双向链接、同步发布等,可以直接从 Codex 插件市场安装,不需要手写配置。

避坑指南
讲完优点,说几个实际使用中要注意的地方:
- ① 用量限制:Codex CLI 的用量计入 ChatGPT 的 Agent 额度,Plus 用户每周有限制。笔记库越大、指令越复杂,消耗越快。建议先用小范围测试,别一上来就让它扫描 3000 个文件。
- ② 操作前备份:Codex 会直接修改你的 Markdown 文件。使用前强烈建议先用 Git 做一次提交,或者开启 Obsidian 的版本历史。出了问题可以一键回滚。
- ③ 权限模式要选对:Codex 默认是 Auto 模式,会自动修改文件。如果只是想查询,可以加
-s read-only参数,只读不写,更安全。 - ④ 需要 Node.js 环境:Windows 用户推荐用 WSL2,体验比 PowerShell 更稳定。官方也提供了 Windows 专用的安装指南。
总结
花了很多年时间搭建知识库——GTD 系统、PARA 法则、双链笔记、卡片盒……每次都觉得找到了完美的方法,但最终笔记还是死在那里,等着你记起它们的存在。
Codex CLI + Obsidian 的组合,第一次让这些笔记真正"可被调用"。不是你去找笔记,而是 AI 帮你把笔记送到你需要的地方。
你存下来的每一个想法、读过的每一篇文章、开过的每一次会——它们不再只是文件夹里的一个文件名,而是真正构成了你的"第二大脑"。
苏米注:这个组合的核心价值在于"调用"——不是整理,不是归档,而是调用。当你需要某个信息时,AI 能帮你从海量笔记中精准找到,这才是"第二大脑"的真正含义。