我大概有三年时间一直处在一种“素材很多稿子很赶”的状态里。浏览器收藏夹存了几百个链接微信收藏里堆着各种截图本地文件夹里的半成品文档更是数不清。等到真要动笔的时候光是把这些散落的东西找齐就能耗掉半天。后来我搭了一套 Obsidian × Claude Code 的内容工厂把素材统一收进 Obsidian 知识库再让 Claude Code 这个命令行 AI 去读库、检索、生成初稿、整理格式。跑通之后我的内容生产节奏从“找素材两小时写作两小时”变成了“校准 AI 半小时人工深改一小时”。这套组合最近在热搜词里也很直观——obsidian知识库搭建、claude code安装、vscode配置claude code、claude code使用教程说明大家的需求点非常集中。这篇稿子不是按键级教程我更想讲清楚三件事这套流水线为什么要这么设计实际搭建过程里有哪些关键选择以及哪些环节最容易翻车。内容创作者、知识管理爱好者或者单纯想把 Claude Code 用起来的开发者都可以沿着这条路径直接上手。1. 为什么是 Obsidian Claude Code从“素材找不到”到“流水线组装”1.1 内容生产最耗时的不是“写”是“找”我不否认 AI 生成文字本身很厉害但真正让一个写作者抓狂的从来不是“写不出来”而是“找不到”。写一段行业分析想找一个三个月前看过的数据写一篇评测想翻一张当时拍的截图写一个教程想确认某个操作细节——这些碎片散落在不同 App、不同文件夹里检索它们的时间成本远高于实际打字的时间。Obsidian 解决的就是这个“找”的问题。它把所有笔记变成磁盘上的 .md 文件天然结构化、可全文搜索、可用链接串联。我把过去两年积累的素材统一迁移进 Obsidian 之后第一感受是终于有一个所有内容都在里面、可以用命令直接检索的地方了。1.2 底座选 Obsidian纯本地 Markdown 文件体系是关键选底座的时候我其实对比过不少工具思源笔记、Notion、语雀都试过。思源笔记的块引用和内置数据库做得不错尤其适合结构化记录Notion 的协作和数据库能力很强语雀的文档体验也很顺。但我的场景里有一个硬指标文件必须能被命令行工具直接读取。在这个前提下Obsidian 的纯本地 Markdown 文件体系几乎没有对手。维度Obsidian思源笔记Notion纯本地是是否文件直读性高.md 直接可读中块结构依赖软件低数据库存储插件生态强中强CLI/脚本友好度高中低我最后选 Obsidian 还有个私心它不会绑架我的数据格式。就算 Obsidian 这个软件某天不更新了我的几百篇笔记仍然是纯文本随时可以在任意工具里继续用。这对内容生产者来说是一种安全感。1.3 引擎选 Claude Code能进文件系统的 AI 才能进工厂Claude Code 不像网页版 Claude 那样需要你复制粘贴对话它运行在终端里能直接读写你电脑上的文件。这就产生了一个质变你可以让 AI 直接读 Obsidian 库里的几十篇笔记基于这些内容写初稿可以让它批量把图片引用移动到指定文件夹可以让它按照 CLAUDE.md 里的规范批量格式化所有文稿。这些动作如果靠网页版交互可能要几百次复制粘贴。跟 Codex 的对比也很直接最近“claude code和codex”这个热搜很多人都关注。Codex 是 OpenAI 的命令行工具同样能读本地目录、执行任务但 Claude Code 在长上下文文本理解和 Skills 体系上更成熟尤其适合“读一堆资料→产出长文”这种内容工厂主流程。这不是说谁更好而是我实测下来谁更贴我这个场景。日常我会两个都装Claude Code 写重活Codex 做批量轻量处理。维度Claude CodeCodex长文本理解能力突出良好Skills 机制成熟正在完善本地文件系统集成好好典型场景长文阅读、稿件生成批量任务、代码处理1.4 这套组合真正解决的问题一句话定性素材层用 Obsidian 做统一收口加工层用 Claude Code 做检索、生成、格式整理输出层用规范模板保证所有稿件结构一致。当这三层打通后内容生产就不再是一篇稿子一篇稿子地“写”而是一条流水线在“组装”。这也是为什么我把这套东西叫内容工厂而不是叫“写作工具套餐”。2. 环境准备Claude Code 安装、VSCode 接入与 Obsidian 库的目录骨架2.1 Claude Code 安装的两条路径与 Windows 11 注意事项装 Claude Code 的方式主要有两种。第一种走 npm适合已经装了 Node.js 环境的用户第二种走官方安装脚本适合 mac 用户。# 方式一npm 全局安装Windows / macOS / Linux 通用 npm install -g anthropic-ai/claude-code claude --versionWindows 11 用户我建议优先用 PowerShell 7 或者 Git Bash 来执行安装命令CMD 对特殊字符和路径的处理容易出问题。装完之后第一次运行 claude它会自动引导登录账号然后申请本机权限。关于 claude code 卸载有朋友问过npm 方式安装的用npm uninstall -g anthropic-ai/claude-code就能清理干净脚本方式安装的直接删除对应二进制和配置目录即可。下载慢是另一个常见的拦路虎。Obsidian 下载慢、Claude Code 依赖包下载慢这些都是老问题。我的建议很朴素不要反复刷新页面用下载工具多线程拉取官方安装包或者错峰安装。依赖包层面可以检查 npm 源是否可用。这里特别提醒一句不要使用来源不明的第三方安装包安全第一。2.2 VSCode 里的 Claude Code 配置思路很多人的 Obsidian 库本身就是纯文本工程配合 VSCode 做素材管理特别顺。Claude Code 可以直接在 VSCode 终端里跑也可以装官方扩展把 AI 面板嵌进编辑器右侧。最近热搜里的“vscode配置claude code”指的就是这两件事扩展安装、终端集成。我的配置思路是把 Obsidian 库作为一个 workspace 直接拖进 VSCode然后在设置里给 Claude Code 绑定一个快捷键需要的时候随时呼出终端窗口。这样 Obsidian 负责日常记录和浏览VSCode Claude Code 负责批量处理和生成两个窗口各司其职。实测下来比来回切软件高效很多尤其当你需要边看素材边给 AI 下指令的时候。2.3 CLI 完全访问权限的正确理解第一次运行 Claude Code 时它会申请文件系统访问、命令执行等权限。很多人看到“完全访问权限”几个字就慌了但其实这是一个可以管理的东西。核心原则是给权限但圈好边界。我一般只让它访问 Obsidian 库所在的目录然后在这个目录下放一个 CLAUDE.md 文件把所有规则写死。比如哪些文件夹只读、哪些文件夹可以写入、不要碰系统目录、不要执行危险命令。权限的真正价值不是让 AI 为所欲为而是让它能在你划定的场地里自由干活。提示如果发现 Claude Code 读不到 Obsidian 库优先检查三件事目录路径是否含有中文或空格、终端工具有没有被系统拦截、当前工作目录是不是你授权的那一层。macOS 上还要去系统设置里确认终端的磁盘访问权限是开启状态。2.4 Obsidian 库的目录结构先把流水线站位画出来内容工厂要跑起来目录结构必须先立好。我目前的库名是 content-factory内部按编号分层。content-factory/ ├── 00_inbox/ # 收集箱所有新想法先扔这 ├── 10_sources/ # 素材库按主题分子目录 ├── 20_drafts/ # 草稿区AI 生成的初稿都在这 ├── 30_published/ # 成稿区发布后的文件归档 ├── 90_attachments/ # 图片/PDF/附件统一放这 └── .claude/ └── CLAUDE.md # 工作区规范AI 优先读它这个编号不是随便写的。00、10、20、30、90 的空间设计让文件夹在排序上天然呈现出工作流顺序Claude Code 和人工都一眼能看懂。素材库必须和草稿区分开否则 AI 检索时会把未完成的半成品当成参考素材产出质量会崩。这属于我踩过坑才定下来的布局。2.5 内容工厂用到的 Obsidian 插件清单插件是 Obsidian 的灵魂但内容工厂场景下我追求少而精不搞五花八门的装饰。插件作用配置建议Dataview按 frontmatter 自动汇总内容写入 status/tag 后自动生成看板Templater统一模板与 Claude Code 共享同一套 frontmatter 规范Homepage打开库时直达工作台把“今日待写”“素材统计”放首页Chartsview把数据可视化适合做月度产出统计Paste image rename图片自动重命名配合 90_attachments 使用Obsidian Git本地自动版本快照大批量 AI 修改前先打 commit主题上我建议别折腾太花哨的优先选信息密度高的主题比如 Source 或 Minimal。内容工厂主打效率不是为了把界面弄得像赛博花园。3. 跑通内容流水线从选题、材料检索到成稿归档的完整链路3.1 CLAUDE.md 是这套工作流的“总指挥”Claude Code 进到工作区后第一件事就是读 CLAUDE.md。这个文件相当于给 AI 的入职手册你希望它怎么配合你全部写在这里。我见过不少人的 CLAUDE.md 写得像项目说明读起来没有任何约束力AI 当然不会按你的套路出牌。以下是我目前用的顶层规范你可以直接参考改造。# 内容工厂工作区规范 ## 目录规则 - 新想法写入 00_inbox - 素材检索只读 10_sources - 初稿一律写入 20_drafts文件名为 slug 格式 - 定稿由人工确认后移动到 30_published ## 格式规范 - frontmatter 必须包含 title、date、tags、status、source - status 取值idea / drafting / reviewing / published - 正文用简体中文口语化但信息密度要高 - 代码块和引用块遵守 Markdown 标准 ## 安全边界 - 不要修改 00_inbox 里的原始记录 - 不要删除任何文件需要删除时先列出清单让我确认 - 只允许在 content-factory 目录内操作看到没文件名规范、字段枚举、安全边界全部写清楚。Claude Code 有了这份手册生成的稿件不会乱跑乱命名也不会误删素材。这套规范同时也能被 Obsidian 的 Templater 和 Dataview 复用两头统一。平时很多人用 Claude Code 中文对话它完全理解不用刻意切英文。3.2 流水线实操拆解选题、检索、生成初稿、格式整理、归档第一步是选题。我的做法是在 Obsidian 里新建一条笔记塞进 00_inbox标题就是选题名正文写两行背景和想要覆盖的角度。这时候不需要整理想到什么写什么收件箱的意义就是快速捕获。第二步是让 Claude Code 检索素材。命令大概长这样cd content-factory claude 在 10_sources 里检索与「知识管理」「内容生产」相关的笔记按相关度排序输出摘要和文件路径它会先把素材列给我我再挑选哪些作为参考。这一步替代的是过去最痛苦的“找素材”动作实测能省掉非常多时间。第三步是生成初稿。我会给 Claude Code 一个完整的指令块包含标题、目标读者、字数、语气、参考文件列表。比如claude 生成一篇 2000 字左右的文章标题《Obsidian × Claude Code 内容工厂搭建实录》目标读者是有内容生产需求但不懂编程的写作者语气口语化重点讲工作流设计和避坑经验。参考素材10_sources/obsidian-workflow.md、10_sources/claude-code-notes.md。写完后保存到 20_drafts/obsidian-claude-code-content-factory.md并按 CLAUDE.md 规范补全 frontmatter实测下来一次生成的质量通常能到六七十分骨架和素材引用基本能用。随后我在 Obsidian 里打开这篇稿子做人工深改。这个阶段的核心已经不是从零写而是在判断大方向、校准语气、补充个人案例速度快很多。第四步是格式整理和归档。改完后让 Claude Code 对照规范检查一遍 frontmatter、标签、标题层级然后我手动把文件移入 30_published。这里我不建议让 AI 自己移动 publish 目录保留人工确认的节点原因后面踩坑部分会讲。3.3 让 Claude Code 读取 Obsidian 库的几种方式其实 Claude Code 不强调“搜索”这种独立功能它的逻辑更接近“直接对话加文件系统访问”。我常用的读取方式有三种。方式一也是最简单的cd 到 Obsidian 库目录下运行 claude然后用自然语言描述要检索的内容。它内部会扫描工作区文件我前面举的例子就是这种。方式二把素材合并成一个大上下文用脚本把 10_sources 里选中的几篇笔记拼接成一个带分隔符的文本或者直接在对话里粘贴。适合文稿数量少但每篇都很长的场景。方式三结合 Obsidian 的 Dataview 查询先在 Obsidian 里用 Dataview 查出一个主题下的所有笔记路径再把这些路径喂给 Claude Code。这是比较高阶的玩法素材筛选更精确。关于最近很热的另一个问题——codex如何读取obsidian——思路是同一个逻辑。Codex 也可以直接在 Obsidian 库目录里运行同时在这个目录放一个 codex.md 或 AGENTS.md把目录规则和写作规范写进去。只不过 Codex 在长文本生成和 Skills 生态上目前还没有 Claude Code 这么顺手。3.4 用同一套 frontmatter 把 AI 和 Obsidian 插件绑在一起内容工厂能真正“流动”起来靠的是 AI 和 Obsidian 插件共享同一套元数据。Claude Code 生成稿件时写好 frontmatterDataview 就能实时生成看板。比如TABLE status, date, tags FROM 20_drafts WHERE status drafting SORT date DESCTemplater 里定义好同一个模板人工新建笔记和 AI 生成笔记的格式完全一致。Chartsview 再把月度产出做成图表月底复盘的时候一眼就能看到过去一个月写了多少篇、哪些主题最顺手。这套联动就是内容工厂的仪表盘也是很容易被忽略的一环。很多人只关注 AI 能不能写其实真正的生产力来自数据结构化之后的可视化反馈。4. 图片与格式管理内容工厂最容易翻车的环节4.1 图片乱堆是 Obsidian 的老问题在 AI 工作流里会被放大Obsidian 默认设置下你截图粘贴到笔记里图片会直接落在库的根目录时间一长整个库全是散落的 png。这个问题在内容工厂里会被放大——AI 生成的稿件里如果给你引用了图片图片路径一旦错乱Markdown 渲染出来全是裂图。obsidian图片、obsidian图片放到文件夹这些热搜词的后台藏着大量被图片管理逼疯的人。解决方案不是等乱象发生后再收拾而是提前设好规则。下面三招是我实测有效的。4.2 三招解决图片管理设置、插件、AI 批量归位第一招改 Obsidian 全局设置。设置里的文件和链接部分把新附件默认位置改成 90_attachments并开启自动更新链接。这样你手动粘贴的每一张图都会自动进附件库链接不会断。第二招装图片处理插件。Paste image rename 可以给图片自动重命名避免一堆默认文件名Image auto upload 适合有图床需求的人。如果你只是本地生产第一招加第二招已经能覆盖日常。第三招让 Claude Code 批量整理历史图片。早期导入库的时候我把大量根目录散落的图片交给 Claude Code 处理claude 扫描所有笔记找出指向根目录图片的链接把图片文件移动到 90_attachments并同步修正所有引用路径实测跑完一遍之后整个库的图片引用没有一处是断的。这一步靠手工做可能要半天AI 几分钟搞定。obsidian图片管理终于不再是噩梦了。4.3 Markdown 格式块能不能折叠以及 callout 的正确用法有朋友问 obsidian 的markdown格式块可以折叠么答案是肯定的。Obsidian 在 Markdown 标准之外实现了两个很实用的折叠特性一个是列表和标题的折叠在左侧小箭头点一下就能收起另一个是 callout 块也就是以 [!note]开头的特殊引用块。 [!note] 重点结论 这里是折叠后的核心内容 [!warning] 注意事项 AI 生成的草稿在发布前必须人工核查事实Claude Code 生成稿件时我是要求它遵守这套语法的。因为 callout 块在 Obsidian 里既有视觉强调效果又支持嵌套和折叠非常适合在长文里做信息分层。你如果不想要这个效果普通的 Markdown 引用块也能用但既然主战场是 Obsidian兼容原生语法收益更大。4.4 与 Zotero 联动文献素材也能进流水线写深度内容的人多半会用到 Zoterozotero和obsidian联动这个热搜一直没断过。我的做法很简单Zotero 装 Better BibTeX 插件把文献库导出成一个 references.bib 文件放到 10_sources 目录。然后在 Obsidian 里用 Citations 插件读取这个 bib 文件需要引用时一键插入文献笔记模板。Claude Code 在这里的价值是批量生产文献笔记。以前我攒了上百条文献一条都懒得写笔记后来让 Claude Code 读取 references.bib按模板为每篇文献生成一条结构化笔记写入 10_sources/literature-notes/。每篇笔记都带标题、作者、年份、期刊、摘要和我的速评字段。虽然 AI 生成的速评质量一般但至少给了初稿框架我后续只要改几句。这比从一张白纸开始写容易太多文献库终于不再只是吃灰的收藏。5. 进阶玩法Skills、二开与多模型接入5.1 Claude Code Skills把内容规范封装成可复用技能Skills 是 Claude Code 里比较有想象力的功能。简单说一个 Skill 就是一个带 SKILL.md 说明文档的文件夹里面可以放脚本、模板、提示词。Claude Code 遇到对应任务时会读取这个 Skill 并按照里面的流程执行。最近的“claude code skills 安装”热搜说明很多人已经注意到这个功能了。我在 .claude/skills/ 下建了一个 content-style 的 SkillSKILL.md 里写了内容生产相关的风格规范分段习惯、加粗习惯、标题写法、结尾方式。之后我只要说一句“用 content-style 的模式来写”生成的稿子就会自动符合我的风格偏好。.claude/skills/content-style/SKILL.md .claude/skills/publish-helper/publish.sh .claude/skills/fact-check/SKILL.md你也可以去官方 Skills 仓库拉现成的包再改成自己需要的样子。技能这东西不一定要复杂能把一个重复动作封装起来就算成功。5.2 接入 DeepSeek用兼容 API 把成本打下来国内用户比较关心 claude code接入deepseek 这件事。Claude Code 本身是基于 Anthropic 的 API但它支持通过环境变量把请求转发到兼容的端点。DeepSeek 提供了 Anthropic 兼容接口配置非常简单export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN你的DeepSeek API Key配好之后启动 claude 就是走 DeepSeek 的模型了。我拿它跑过素材整理和批量格式整理成本确实低适合大规模机械化任务。但说实话复杂创作我还是会切回默认模型语言质量和长文逻辑明显不是一个级别。所以我的建议是把模型当工具矩阵贵的干精细活便宜的干体力活。5.3 Codex 与 Claude Code 的互补用法我有段时间同时装 Claude Code 和 Codex。两者定位相似但实测下来各有擅长。Claude Code 在长文本、复杂文档生成上更顺手Codex 在代码类任务和快速批量处理上响应更快。我目前的用法是Claude Code 负责稿件、素材整理、格式规范Codex 负责脚本编写和临时数据处理。如果你也想让 Codex 读取 Obsidian 库在库目录下运行 codex 后把目录结构和写作规范写进 codex.md 或 AGENTS.md 即可。两边用不同的规则文件反而能实现一定程度的“互相监督”——让一个 AI 检查另一个 AI 的输出实测能抓出不少问题。这个玩法大家有空可以试试。5.4 二次开发把内容工厂接到发布系统Claude Code 还有个很自然的扩展方向二次开发。我的做法是写了一个 publish-helper 的 Skill里面放一个发布脚本负责把 30_published 下的新文章通过 API 推到我的博客系统。这样稿子审完之后直接把输出路径交给 Claude Code它按 Skill 流程执行发布。最近 claude code 二开 的热度不低说明大家已经不只满足于让它写东西了。如果你没有自己的博客也可以接 WordPress、自建 API甚至只是把成稿压缩后导出。核心思路不变把重复的收尾动作从人工变成 AI 调脚本。二开门槛不低但收益极高尤其适合每周要发多篇文章的人。6. 实录踩坑清单权限、同步、良品率与效率边界6.1 权限不给到位文件读写各种失败第一个大坑就是权限。一开始我在 mac 上跑 Claude Code总出现 Permission denied明明文件就在那。排查半天才发现是终端的磁盘访问权限没开。macOS 的系统设置里必须允许你的终端应用访问桌面和文档文件夹否则 Claude Code 没有权限读 Obsidian 库。Windows 11 上则是路径问题路径里带中文或空格会让部分命令行工具发疯所以我把库放到纯英文路径下。这里特别提醒给了完全访问权限不代表没有边界。我会在 CLAUDE.md 里明确安全边界比如不允许删除文件、只允许操作 content-factory 目录。权限是工具能力规则是工作纪律两者缺一不可。6.2 同步和版本管理的坑用 Git 给 AI 上保险丝内容工厂最怕的是素材库同步出问题。图片和附件多了以后同步工具很容易冲突。我没用花哨的方案就是本地优先Obsidian Git 做自动版本快照。每次 Claude Code 要批量改文件之前先让它执行 git add -A git commit生成一个命名清晰的快照。改坏了随时回滚这是内容工厂的保险丝。obsidian同步的困惑很多都是因为想多端实时同步大附件我的建议是图片附件这种大文件走本地文件夹同步文本笔记走 Git各管各的。这样处理之后再也不用担心 AI 批量修改把整个库搞乱。就算真的改崩了git reset 回上一个快照就行。这套组合比任何第三方同步服务都稳。6.3 良品率AI 初稿的四个人工把关点任何 AI 生成的稿子都不能直接发。我的把关清单是四件事事实、数据、引用、观点。AI 在生成时偶尔会脑补来源或数据这一点在内容生产里非常危险。我的流程里专门加了一步事实核查让 Claude Code 对生成稿里的每个可验证信息点列出来源再由我逐条人工确认。这一步不省但比整篇重写轻松得多。另外语气和结构也需要人校准。AI 写久了会在段落之间露出熟悉的“AI腔”比如频繁使用“总而言之”“值得注意的是”这类词。我在 CLAUDE.md 里已经写了禁用词表但效果需要持续迭代。说到底 AI 是加速器方向盘还是在自己手里。6.4 效率边界什么内容不适合交给 Claude Code最后聊聊边界。我踩过的坑之一是试图让 Claude Code 写所有类型的文章结果在需要个人经历、情绪表达、独特观点的内容上产出非常平庸。这类内容读者一眼就能感受到没有灵魂。所以我的分工表很明确素材整理、初稿骨架、格式统一、批量改写全部交给 AI选题判断、核心价值观表达、个人故事、最终润色由人来完成建立这张人机分工表之后内容工厂的良品率才真正提上来。工具不是替代人而是把人从重复劳动里解放出来去做只有人才能做的事。根据我个人的实操体会Obsidian × Claude Code 这套组合最大的价值不在于省掉了多少打字时间而在于它让素材不再浪费。以前我收集的碎片很多都躺在收藏夹里吃灰现在每篇草稿都有清晰的素材引用链路写起来手上有粮心里不慌。最后再分享一个小技巧每周抽五分钟让 Claude Code 扫一遍 00_inbox 和 10_sources自动生成一份本周可用素材清单你会发现很多被遗忘的好料。这大概是整个内容工厂里性价比最高的一个动作了。