爆肝3周,我用Codex重构了整个Obsidian知识库,比手动整理强10倍
人在深夜,盯着Obsidian里1274篇未整理的笔记发呆。
这些笔记跨了三年——从读研时的论文摘抄,到工作后的会议纪要,到随手收藏的网页剪藏。文件夹套了五六层,标签打了上百个,但真正需要用的时候,什么都找不到。
直到我把Codex接进了Obsidian。
三周后,我的知识库从"文件仓库"变成了一个能自动整理、主动关联、每日推送简报的思考系统。今天把完整流程交出来,从安装到跑通,跟着做就行。
先说结论:为什么是Codex + Obsidian
你可能试过各种知识管理方案——Notion AI、飞书文档、印象笔记,甚至Roam Research。但大部分方案都有一个致命问题:整理环节全靠人。
你收藏了一篇文章,得手动分类。打了个标签,得手动建关联。攒了一周笔记,得自己复盘总结。只要你忙一周没整理,知识库就开始腐烂。
Codex补上了这块。
OpenAI在2025年4月开源了Codex CLI——一个运行在终端的AI编程代理。它能直接读写本地文件,理解项目结构,跨文件执行复杂任务。说白了,它不是一个代码补全工具,而是一个能独立干活的AI助手。
当Codex通过MCP协议接入Obsidian后,它能做到:
扫描你所有笔记,发现你没注意到的隐藏关联 自动整理Inbox里的杂乱素材,归档到对应文件夹 读取一周的会议记录,生成摘要和行动项 分析双向链接图谱,找出孤立节点和知识盲区 根据研究笔记草拟文章、报告、邮件
Obsidian负责存储和关联,Codex负责整理和思考。 一个当仓库,一个当仓管员兼分析师。
第一步:装好两个工具
Obsidian(免费)
去 obsidian.md/download 下载安装包,Windows/Mac/Linux全支持。打开后选择"Create new vault",命名你的知识库,选一个本地路径。
Codex CLI(免费)
Codex CLI需要Node.js环境。打开终端,三行命令搞定:
# 安装Codex CLI
npm install -g @openai/codex
# 设置API密钥
export OPENAI_API_KEY="你的API密钥"
# 启动
codex
如果你在国内,可以通过中转服务或镜像站接入OpenAI API。具体配置方案CSDN上有详细教程,搜"Codex CLI 国内配置"就能找到。
安装完成后,运行 codex --version 确认安装成功。当前最新版本是v0.133.0。
第二步:搭建知识库目录结构
不要一上来就搞复杂的文件夹体系。越复杂的结构越难坚持。
推荐四层极简结构:
你的知识库/
├── AGENTS.md # Codex的操作规范(核心!)
├── Inbox/ # 收件箱:所有新内容统一入口
├── Notes/ # 笔记库:已整理的外部知识
├── Ideas/ # 灵感库:自己的思考和感悟
└── Projects/ # 项目库:正在推进的工作
为什么只有四个文件夹?
Inbox是入口,所有东西先进来,不分类不打标签。Notes存外部内容,Ideas存自己的思考,Projects存行动中的项目。三分法够用了——你的知识不是图书馆,不需要杜威十进制分类法。
如果你喜欢更细的结构,也可以参考Karpathy的LLM Wiki模式,用raw/wiki双层结构。但我的建议是:先从四个文件夹开始,跑通了再说。
第三步:写AGENTS.md——给Codex立规矩
这是最关键的一步。AGENTS.md是Codex的操作手册,它决定了Codex怎么理解你的知识库、怎么执行任务。
在知识库根目录创建 AGENTS.md,写入以下内容:
# Knowledge Base Rules
## Who I Am
- Name: [你的名字]
- Work: [你的职业]
- Focus: [你今年最想提升的能力]
## Vault Structure
- /Inbox — 所有新捕获的原始素材,未整理
- /Notes — 外部文章、学习资料、干货内容
- /Ideas — 个人原创思考、灵感、复盘
- /Projects — 正在推进的工作与项目
## Operat…