先问自己一个问题你电脑里的笔记、文档、碎片想法是不是存完就再也不打开了我过去也是这样。笔记越积越多但真正要用的时候既搜不到也串不起来。直到把 Codex 和 Obsidian 组合成一套流程才真正把这些素材变成随时可以调用的“第二大脑”。本文是一篇完整实操教程从零开始带你在大约 20 分钟内完成这套知识库系统。整个过程会覆盖工具选型原因、Obsidian 库的规划、Codex 的接入方式、自动化脚本、以及常见报错排查。无论你是 Obsidian 老用户还是第一次接触 Codex都可以按步骤跟下来。1. AI 第二大脑是什么为什么需要它1.1 “第二大脑”的核心不是存储而是调用很多人对第二大脑有个误解以为把资料整理得井井有条就够了。实际上存储只是基础真正的价值在于当你想写一篇文章、做一个方案、或复盘某个项目时系统能在几秒内把相关素材送到你面前甚至替你完成初稿。传统目录树管理方式有几个明显瓶颈笔记之间缺乏关联信息被“文件夹”割裂。关键词记忆模糊时根本搜不到。内容即使找到了还要自己重新阅读、提炼、组织耗时很长。AI 的介入改变了这条链路。它不只是帮你“找”而是帮你“想”直接从已有笔记中提炼观点、生成大纲、串联不同主题的素材甚至能把几百条碎片内容压缩成一份结构化文档。1.2 为什么选择 Obsidian Codex 组合Obsidian 和 Codex 是目前这套方案里组合性价比最高的两个工具。Obsidian 的优势在于本地化存储纯 Markdown 文件数据完全自主可控。双向链接、标签体系、图谱视图适合知识关联。插件生态强大界面高度可定制。所有数据都是普通文本文件方便 AI 程序读取。Codex 的价值在于它是 OpenAI 的 AI 编程与自动化智能体不只是聊天工具。Codex CLI 可以运行在终端中直接读写文件、执行命令、调用模型能力等于给 Obsidian 配了一个能操作整个笔记库的 AI 助手。两者结合后的实用场景非常直接对某篇笔记提问AI 结合库内内容回答。把一堆同类笔记合并自动去重并生成结构化文档。根据笔记内容自动生成标签、反向链接、摘要。用自然语言下达指令自动化处理文件不用手写脚本。下面进入正题按照 20 分钟的时间线逐步完成搭建。2. 环境准备与版本说明开始前先确认你本机的环境。本文的操作环境配置如下项目版本或工具操作系统macOS 14 / Windows 11 / Ubuntu 22.04Obsidian1.5 及以上版本Codex CLInpm 最新稳定版Node.js18.0 及以上版本OpenAI 账号已登录并具备 API 或订阅权限如果你使用的是 Windows建议优先使用 PowerShell 或 Windows TerminalmacOS 和 Linux 直接用系统终端即可。本文以 macOS 作为主演示环境所有命令与 Windows 相差不大遇到差异时会单独标注。2.1 Obsidian 安装前往 Obsidian 官网下载对应系统的安装包安装后不需要做任何特殊配置。这里建议创建一个新库Vault专门用于本次实战避免干扰你已有的正式笔记库。操作路径打开 Obsidian。点击“Create new vault”。Vault 名称填写AI-Second-Brain。选择一个容易定位的本地路径例如~/Documents/AI-Second-Brain。Obsidian 会在这个文件夹下自动创建一个.obsidian目录用于存放插件和配置。所有笔记内容就是你目录下的 Markdown 文件这也为 Codex 操作文件提供了前提。2.2 Node.js 与 npm 环境检查Codex CLI 依赖 Node.js。打开终端输入以下命令确认环境node -v npm -v如果提示找不到命令需要先安装 Node.js。推荐通过 nvm 安装便于后续切换版本curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash安装完成后重新打开终端执行nvm install 20 nvm use 20确认输出类似v20.11.0和10.2.4环境就准备好了。3. Codex CLI 安装与初始化3.1 安装 Codex CLI使用 npm 全局安装 Codex CLInpm install -g openai/codex安装完成后执行初始化命令codex init初始化过程中会询问几个问题按下面建议选择是否使用 ChatGPT 登录推荐 Yes如果你有 ChatGPT 订阅权限。CLI 本地模型配置若机器内存充足可选本地小模型否则选 No走云端推理。自动应用文件修改推荐询问模式避免 AI 改动文件时失控。初始化完成后可以执行一次登录验证codex login这个命令会打开浏览器完成 OAuth 授权。授权完成后回到终端会看到登录成功提示。3.2 验证 Codex 是否可用先在一个空白目录里测试一下codex 用一句话介绍你自己如果能正常返回结果说明 Codex CLI 已经可以调用模型能力。此时可以进到 Obsidian 库目录中进行下一步操作。cd ~/Documents/AI-Second-Brain codex 列出当前目录有哪些文件正常情况下 Codex 会先读取目录结构然后返回文件列表。这代表 AI 已经能够“看到”你的知识库文件。4. 搭建 Obsidian 知识库的目录与模板体系很多人在知识库搭建时卡住是因为一开始就想把结构设计成完美的大树。实际更聪明的做法是轻量起步让知识库在使用中长出自己的结构。在 AI-Second-Brain 库中建议先创建以下目录AI-Second-Brain/ ├── 00-Inbox/ ├── 01-Projects/ ├── 02-Areas/ ├── 03-Resources/ ├── 04-Archive/ ├── 90-Templates/ └── 99-Attachments/这套结构参考了 PARA 方法含义如下00-Inbox所有新笔记、临时想法、未分类内容先丢这里。01-Projects有明确目标和截止时间的项目资料。02-Areas长期维护的责任领域比如“前端开发”“身体健康”。03-Resources兴趣主题、参考资料、文章素材。04-Archive不再活跃但仍需保留的内容。90-Templates统一模板文件。99-Attachments图片、PDF 等非 Markdown 资源。执行命令mkdir -p 00-Inbox 01-Projects 02-Areas 03-Resources 04-Archive 90-Templates 99-Attachments4.1 创建默认笔记模板Obsidian 的核心是 Markdown模板决定了笔记的底子。创建模板文件90-Templates/default.md--- title: tags: [] created: {{date}} --- # {{title}} ## 核心观点 ## 关键信息 ## 行动项 ## 相关链接Obsidian 自带{{date}}模板变量插入文件时会自动替换为当前日期。如果希望 Codex 创建笔记时自动应用这个模板可以在后续自动化脚本中读取该模板内容再让 Codex 按此格式生成笔记这样 AI 写出的内容也保持统一风格。5. Codex 与 Obsidian 的三种集成模式这是全文最重要的章节。Codex 与 Obsidian 的集成方式不止一种下面拆成三个层次从简单到深入分别适合不同的使用习惯。5.1 模式一终端对话直接读写这是最基础的方式也是最快上手的。进入 Obsidian 库目录后直接使用自然语言向 Codex 下达指令。例如你有一堆随手记录的灵感散落在 Inbox 中希望把它们整理成一篇可发布的长文可以这样操作codex 阅读 00-Inbox 下的所有笔记提炼共同主题然后在 03-Resources 下创建一篇结构化长文笔记文风偏技术教程并自动生成标签Codex 会读取文件分析内容直接生成新文件。你可以随时打开 Obsidian 查看结果。这种方式适合零基础用户因为它没有额外代码逻辑本质上是把 Codex 当作一个会自动操作文件系统的 AI 助手。5.2 模式二MCP 服务把 Obsidian 变成 AI 的可交互应用MCPModel Context Protocol是 Codex 支持的一种扩展协议可以让模型访问外部工具和上下文。如果希望在 Obsidian 界面内直接用 AI 操作笔记而不是跑到终端敲命令可以使用社区插件。常用的社区插件名称是“Codex MCP”或类似工具。安装流程打开 Obsidian 设置。进入“第三方插件”。关闭“安全模式”。浏览社区插件市场搜索 Codex。安装并启用。启用后进入插件设置需要填写 Codex 的调用方式一般默认即可。这样你在 Obsidian 里就能通过一个面板向 AI 提问AI 返回的内容可以直接插入当前笔记或新建笔记。这种模式的优点是流程闭环你可以在阅读笔记时直接调起 AI 进行提炼而不需要切换到终端。5.3 模式三自定义自动化脚本如果你具备一些编程基础可以通过 Node.js 或 Python 写一个脚本把 Obsidian 的批量任务定期交给 Codex 处理。下面是一个简单的 Node.js 脚本示例作用是将某个目录中的所有 Markdown 文件合并后交给 Codex 生成摘要。// 文件名: scripts/summarize.js const fs require(fs); const path require(path); const { execSync } require(child_process); const targetDir path.join(__dirname, ../00-Inbox); const outDir path.join(__dirname, ../03-Resources); const files fs.readdirSync(targetDir).filter((f) f.endsWith(.md)); let combined ; for (const file of files) { const content fs.readFileSync(path.join(targetDir, file), utf-8); combined ---\n文件名${file}\n---\n${content}\n; } const prompt 以下是多篇笔记内容请提炼核心主题并生成一篇结构化文档。\n\n${combined.substring(0, 4000)}; const result execSync(codex ${prompt.replace(//g, \\)}, { encoding: utf-8, maxBuffer: 20 * 1024 * 1024, }); fs.writeFileSync(path.join(outDir, summary-${Date.now()}.md), result); console.log(摘要生成完成);运行方式node scripts/summarize.js这个脚本只是基础示例实际使用时建议结合错误处理、文件去重、token 长度限制等逻辑避免内容过长导致请求失败。6. 完整实战从 Inbox 到成品知识笔记这部分用一个实际案例完整走一遍流程。场景设定你最近收集了十条关于“如何高效阅读技术文档”的碎片笔记先把它们放进00-Inbox。6.1 准备示例碎片笔记手动创建00-Inbox/read-001.md# 读文档技巧 01 先看目录再读概述跳过安装细节重点理解示例。再创建00-Inbox/read-002.md# 读文档技巧 02 - 看官方文档比看二手博客更可靠。 - 遇到不懂的 API直接去源码里面搜索。继续创建类似的多篇碎片笔记内容随意即可目的是演示多文件处理场景。6.2 让 Codex 完成整理任务执行以下命令codex 阅读 00-Inbox 目录下的所有笔记完成任务1. 找出这些笔记之间的共同主题2. 剔除重复内容3. 在 03-Resources 下生成一篇名为《高效阅读技术文档的实践方法.md》的正式笔记4. 给新笔记添加合适的 frontmatter 标签5. 把已处理的源文件移动到 04-ArchiveCodex 会按顺序执行。由于 Codex 支持多步骤规划它会先列出文件清单再逐一读取内容最后生成正式笔记并移动文件。完成后你会发现03-Resources下多了一篇整理好的正式笔记。00-Inbox下原来的碎片文件被移动到04-Archive。标签和标题自动生成。如果你在 Obsidian 中打开新笔记会看到通顺、有结构的文档而不是简单的内容拼接。6.3 利用双链构建知识关联知识库不等于文件柜它更接近一张网。Obsidian 的核心能力就是双向链接。手动为笔记添加链接太繁琐但 Codex 可以自动完成。执行指令codex 扫描 03-Resources 下所有笔记为每篇笔记添加相关链接把涉及同一主题的笔记用 [[]] 双向链接关联起来并将链接放在笔记底部的相关笔记区域Codex 会根据内容语义为笔记建立关联。这种自动化的好处是不需要记住每篇笔记写了什么AI 会读取内容并主动建立连接。6.4 让 Codex 生成每日回顾知识库只有持续使用才有价值。可以每天早上让 Codex 自动生成“今日回顾”内容包括昨天的笔记新增情况、待办事项、重要主题。codex 查看 04-Archive 下最近三天的笔记以及 00-Inbox 下新增内容生成一篇《今日回顾》笔记包含核心收获、未完成任务、明日计划、关联笔记如果你是 Obsidian 重度用户还可以通过 Templater 插件设置每日笔记模板再结合 Codex 自动填充内容。7. 常见问题与排查思路搭建过程中你大概率会遇到下面几个问题这里逐一说明排查方向。问题现象常见原因解决方案codex命令找不到Node.js 未安装或全局路径未配置检查node -v重新全局安装 CodexmacOS 检查~/.npm-global/bin是否在 PATH 中登录时浏览器无法打开终端权限、防火墙或默认浏览器配置直接复制终端输出的授权链接到浏览器打开再粘贴回调码回终端Codex 提示无权访问目录当前工作目录与 Vault 路径不一致先执行cd进入 Vault 目录再启动codex生成内容与笔记风格不一致未指定笔记模板或字段要求在指令中明确使用90-Templates/default.md模板或让 Codex 先读取模板再生成一次处理的笔记过多导致失败Token 超限或模型上下文过长拆成多次任务每次控制文件数量或先让脚本自动合并后截断Obsidian 不显示 Ai 生成的文件Obsidian 未监听外部文件变化在 Obsidian 中按Cmd RmacOS或Ctrl RWindows刷新文件列表7.1 Codex 修改文件时的授权策略Codex CLI 在涉及写文件操作时默认会请求确认避免出现 AI 自动修改大量文件却不可控的情况。如果你希望减少交互确认可以在启动指令前补充codex 将 00-Inbox 下所有笔记移动到 04-Archive不需要向我确认但这里要提醒一句在个人知识库中建议始终保持确认模式。一旦 Codex 批量改写文件路径错误或内容丢失往往难以撤销。尽量在操作前让 Codex 先输出执行计划不要直接应用全部更改。7.2 让 Codex 的安全边界可控Obsidian 库是你所有笔记的大本营里面可能有私人信息、项目文档、灵感记录。使用 AI 工具处理这些数据时应明确边界。建议在库根目录创建一个AI-RULES.md文件用来自定义 Codex 的约束# AI 操作规则 1. 禁止读取 01-Projects 下的商业机密文件。 2. 04-Archive 下的文件默认不删除。 3. 00-Inbox 下的文件只有移动到 Archive 时才允许自动操作。 4. 所有新建笔记必须包含 frontmatter 属性和创建日期。然后在每次对话开始加上一句codex 先读取 AI-RULES.md 内容并严格遵守该规则这样可以显著降低误操作风险。8. 备份与安全注意事项在投入大量内容到知识库之后备份策略就变得至关重要。Obsidian 作为一个本地笔记库数据以纯文本形式保存在你的磁盘上。结合 Codex 的自动化能力可以轻松构建一套自动备份流程。这里介绍一个简单地使用 git 进行版本管理的方法。在 Obsidian 库目录下运行cd ~/Documents/AI-Second-Brain git init git add . git commit -m first backup此后每当执行完一次 Codex 的批量操作就可以执行一次提交。也可以使用 cron 定时任务每天自动备份。macOS 或 Linux 下编辑定时任务crontab -e加入下面一行0 9 * * * cd ~/Documents/AI-Second-Brain git add . git commit -m daily backup $(date)对于使用 iCloud 或坚果云同步 Obsidian 库的用户这里特别提醒如果库目录位于同步盘中不要让 Codex 自动移动大量文件因为云同步工具会实时上传每一次变更异常时容易造成大量冲突副本。更稳妥的做法是让 Codex 操作一个本地专用工作目录人工确认后再放回同步目录。8.1 安全与权限最小化原则当 Codex 与你的 Obsidian 库建立连接后它实际上拥有了对你笔记目录的读写权限。这里要强调最小权限原则日常对话操作时只在当前 Vault 目录内进行。不要让 Codex 访问你的系统级目录例如/etc、~/Library、C:\Windows。涉及登录凭证或 API Key 的信息绝不能作为普通文本笔记存放。如果使用远程模型服务注意上传的数据量敏感数据建议先本地脱敏再交给 Codex 处理。9. Obsidian 插件增强Templater 与 DataviewCodex 负责“生成内容”而 Obsidian 插件负责“让内容活起来”。这里介绍两个对知识库最有价值的插件。9.1 Templater动态模板自动化Templater 是 Obsidian 社区最强大的模板插件支持脚本、变量、条件判断。结合 Codex 生成的内容效果很实用。安装方式第三方插件中搜索Templater启用即可。在90-Templates下创建一个动态模板codex-note.md--- creation date: % tp.date.now(YYYY-MM-DD HH:mm) % type: Codex Note tags: - AI - Knowledge --- # % tp.file.title % ## AI 生成摘要 % tp.system.prompt(请粘贴 Codex 生成的摘要内容) % ## 后续行动项 - [ ]新建笔记时选择这个模板再粘贴 Codex 生成的摘要就能快速形成一条结构完整的知识笔记。9.2 Dataview让笔记库自动生成索引Dataview 可以基于笔记的 frontmatter 和内容自动生成列表、表格不需要手动维护目录。在03-Resources目录下创建仪表盘.md# 知识库仪表盘 ## 最近添加的笔记 dataview TABLE file.cday AS Created, tags AS Tags FROM 03-Resources SORT file.cday DESC LIMIT 10所有待处理事项TASK FROM 00-Inbox代码块的 Dataview 语法只在 Obsidian 中渲染不需要在普通 Markdown 阅读器中理解。这样你的知识库会自动展示最新内容不用手工维护索引。10. 常见高频指令集为了让你更快上手下面整理了一些可直接复制使用的 Codex 指令。实际使用时根据 Vault 目录结构和自身需求微调。10.1 整理与归档codex 扫描 00-Inbox 下的所有 Markdown 文件根据主题分为 3-5 个类别为每篇笔记添加标签然后移动文件到对应的 02-Areas 或 03-Resources 目录。分析过程要输出简要总结10.2 反向链接自动补充codex 阅读 03-Resources 目录下所有笔记找出内容包含相同主题关键词的笔记为它们添加双向链接。链接放在文档底部10.3 文章生成codex 基于 03-Resources 下的 5 篇相关笔记生成一篇 3000 字左右的技术博客文章风格要结构化包含代码示例、图表说明和常见问题总结。保存到 01-Projects/article-draft.md10.4 标签规范化codex 扫描整个 Vault统计所有笔记的 tags 字段将语义相同但写法不同的标签统一比如 AI、ai、人工智能 合并为一个11. 进阶方向把知识库带向真正的自动化如果你完成了前面所有步骤你的 Obsidian 库已经不是静态的文件集合而是一个能主动生长、自动整理、随时提取内容的系统。在此基础上还有三个值得尝试的进阶方向。第一结合 GitHub Actions 实现远程自动化。你可以把 Obsidian 库同步到一个私有 Git 仓库设置定时任务自动调用 Codex 处理新笔记再把结果提交回仓库。这样即使不开电脑知识库也能每天自动更新。第二利用 Obsidian 的 URI 接口实现快捷命令。Obsidian 支持通过链接格式直接新建笔记、打开指定文件。在 Codex 生成的输出中可以拼接这类地址让你在 AI 生成内容后一键跳转到对应笔记。示例格式obsidian://open?vaultAI-Second-Brainfile03-Resources%2F%E9%AB%98%E6%95%88%E9%98%85%E8%AF%BB%E6%8A%80%E5%B7%A7第三将知识库内容作为问答机器人的数据集。未来如果希望搭建一个个人知识助手可以让 Codex 对指定目录建立索引然后基于这些内容进行问答。这比直接让 AI 凭记忆回答可靠得多因为答案有据可查能追溯到具体笔记文件。如果你对知识工程、AI 自动化工作流感兴趣下一步可以研究两个方向一个是向量化检索利用 Embedding 技术把笔记内容转换为向量实现语义搜索另一是 RAG检索增强生成让 AI 在回答问题时自动从你的知识库中检索片段作为上下文。这两项技术都是打造高质量个人 AI 助手的核心。这套方案最值得坚持的一点是你用自然语言驱动 AI 整理自己的数字资产而不需要把所有工具链学完才能开始。动手搭建好第一个 Vault每天往 Inbox 里丢几条笔记再定期让 Codex 做一次整理二十天后你会看到一个完全不同、真正属于你自己的知识库。