Claude Code + Obsidian
用Claude Code和Obsidian给Claude一个永久的记忆
Obsidian是一款独立的笔记应用,与Anthropic无关。本指南是独立撰写的,与Anthropic和Obsidian均无合作或认可关系。
每次和Claude开始新的对话,都是从零开始。除非你重新把一切都打出来,Claude不会记得你的工作、你正在推进的项目,或者昨天和它一起定下的决定。对于想把Claude当作一个长期陪伴的助手使用,而不只是用来问零散问题的人来说,这是一个真实的限制。本指南会搭建一套能长期用下去的方案:一个纯文本的vault,Claude每次和你一起工作时都会读取并写入它,这样它就能从你上次停下的地方继续,而不是每次都从头开始。要用到的两样东西分别是Claude Code,这是Anthropic用于编程的命令行工具,以及Obsidian,一款免费的笔记应用,它把一切都以普通文本文件的形式保存在你自己管理的文件夹里。这两款产品都不是为了配合对方而设计的,这里的一切也都不需要你写一行代码。你将安装Claude Code,创建一个小小的Obsidian vault,给它一套文件夹结构和几个Claude会自动读取的规则文件,然后设置两到三个重复执行的任务,让它们按照时间表自动把这份记忆保持最新,而不必每天自己打开聊天窗口手动去做。
要给Claude一个永久的记忆,先安装Claude Code,这是Anthropic用于编程的命令行工具,然后创建一个带有文件夹结构的小型Obsidian vault,外加Claude在每次会话开始时都会读取的CLAUDE.md和STATE.md文件。这些文件保存着值得记住的事实:你的角色、正在进行的项目、与你一起工作的人,以及当前的情况。在此基础上,Claude桌面应用中的本地定时任务会按照时间表,在你自己的电脑上,在这个vault里运行一份晨间简报和一次每周回顾,让记忆始终保持最新,而不需要你每天手动更新。
发布于
免费课时 · 无需注册账号认识 Claude为什么是 Claude？6分钟开始免费课时要点总结
- Claude Code,Anthropic用于编程的命令行工具,自身在不同对话之间并没有记忆。一个Claude每次会话都会读取并写入的纯文本Obsidian vault,才是真正让永久记忆成立的东西。
- 一个CLAUDE.md规则文件和一个STATE.md状态文件,两者都在每次会话开始时被读取,比每次在聊天中重新解释你的情况,对保持连续性的作用大得多。
- Claude桌面应用中的本地定时任务只会在你自己的电脑上运行,只有在应用打开且电脑没有休眠时才会执行,并且只会补跑最近7天内错过的恰好一次运行。
- Claude Pro的价格是每月US$20,已经包含Claude Code。Obsidian是免费的。搭建这整套系统不需要任何额外付费。
- 三个习惯让这套系统保持诚实:把东西直接丢进Inbox而不在当下整理,让Claude帮你查找而不是自己翻找,以及把一个错误的记忆在规则文件里改一次,而不是每次会话都重新解释。
复制即用
今天就能用的提示词
一次性搭建vault的文件夹结构和文件
我已经在Obsidian里的Documents文件夹中创建了一个名为Brain的vault。请打开它,在里面建立这样的文件夹结构:Inbox、Projects、People、Decisions、Daily、Reviews、Archive,以及一个memory文件夹。然后创建一个CLAUDE.md文件,写上你应该如何与我合作的初始规则,一个不超过80行、说明当前情况的STATE.md文件,以及一个索引文件memory/MEMORY.md。在写任何内容之前,先一个一个地问我十个问题,内容包括我的角色、我的主要项目、和我合作最多的人、我做决定的方式、我希望每日笔记怎样记录,以及任何其他能帮你理解我工作方式的问题。用我的回答来写CLAUDE.md和STATE.md,让它们真正反映我本人,而不是一个通用模板。
在安装好Claude Code并在Obsidian中创建好Brain vault之后,在vault的文件夹里把这段内容作为你的第一条消息贴上去。
晨间简报定时任务(工作日)
阅读这个vault里今天和昨天的Daily笔记、Inbox里现在的所有内容,以及STATE.md。在今天的Daily笔记顶部写一份简短的晨间简报:昨天还没处理完的事情、Inbox里需要做决定的新内容,以及根据Projects和Decisions今天要做的事。控制在15行以内。如果这个任务运行时已经过了下午5点,就完全跳过简报格式,只发一行说明今天的时间窗口已经错过,这样我就不会在晚上还看到一份过时的晨间简报。
把这段内容作为一个本地定时任务的指令,设定在工作日的早上运行,指向你的vault文件夹。
每周回顾定时任务(周五)
阅读这个vault里本周的每一篇Daily笔记。更新STATE.md,让它真实反映当前情况,用重写而不是不断追加的方式,把它控制在80行以内。把本周在Projects或Decisions中已经完全解决的事项,带上日期移动到Archive。在总结末尾用一个简短的列表,标出Decisions或Projects中三周或更长时间没有被处理过的内容,这样我就能知道哪些已经过时、需要一个真正的决定,而不是继续放在那里不管。
把这段内容作为一个本地定时任务的指令,设定在周五下午运行,指向你的vault文件夹。
问题所在
为什么Claude需要一套记忆系统
与Claude的对话,默认情况下是一张白纸。关掉窗口再打开一个新的,你之前解释过的工作内容、你的团队,或者你正在进行中的项目,全都会消失。如果只是一个快速的问题,这没什么问题。但对于想把Claude当作一个长期陪伴的、有能力的助手来使用的人来说,这意味着每次都要重新解释一遍整个情况,这很快就会让人厌烦,而且会在不知不觉中让你不太愿意把Claude用在更大、更持续的事情上。
解决办法不是Claude自带的某个功能,而是一种建立在文件之上的习惯。Claude Code,Anthropic用于编程的命令行工具,可以在你电脑上的一个文件夹里读取和写入纯文本文件,并会在会话开始时自动读取某些文件。如果这些文件里用平实的语言记录着值得记住的事实,那么实际上Claude每次也都会记住它们,而你不需要重新打一个字。
Obsidian是另一半。这是一款免费的笔记应用,它围绕一个在这里非常重要的理念而构建:你在其中写的一切都以普通文本文件的形式保存在一个文件夹里,而不是被锁在某个专有数据库中。这正是Claude Code能够直接打开、读取和编辑的那种东西,这也是为什么这两者尽管谁都不是为了配合对方而设计,却能如此自然地搭配在一起。
接下来要介绍的是整套搭建过程:安装Claude Code,创建一个Obsidian vault,建立一个Claude每次会话都会读取的小型文件夹和文件结构,然后把日常维护交给几个定时执行的例行任务,让这套系统保持更新,而不会在你的待办列表里变成一项新的负担。
第一步
安装Claude Code
最快的方式是原生安装程序。打开Anthropic的Claude Code设置页面code.claude.com/docs/en/setup,运行页面上为你的系统列出的那一行命令;这个页面分别讲解了Mac、Linux和Windows,你只需要复制你所用平台对应的那一行就行。如果你更喜欢在Mac或Linux上用Homebrew,`brew install --cask claude-code`也能完成同样的工作。不管用哪种方式,你都不需要明白这条命令具体在做什么;你只是在运行一个脚本,把claude这个命令安装到你的电脑上。
安装完成后,在同一个终端窗口里运行`claude --version`,检查是否成功。如果想对整套安装做更全面的检查,`claude doctor`会运行一次简短的诊断,并告诉你哪些地方需要注意。
接下来,单独运行claude,并按照浏览器中的提示登录。你需要一个Claude Pro、Max、Team、Enterprise或Console账户;免费的claude.ai方案不包含Claude Code。Claude Pro每月US$20,已经包含Claude Code,所以读这篇指南的大多数人可能已经订阅了这个方案,或者正打算订阅。
最后,从`claude.com/download`安装Claude桌面应用。安装过程或vault本身并不需要用到它,但本指南第4步会用到桌面应用自带的本地任务调度器来运行那些让记忆保持更新的定时例行任务,所以现在就把它装到你的电脑上,并在那里也登录一下。
第二步
创建一个名为Brain的Obsidian vault
Obsidian下载和使用都是免费的,创建一个vault,这在Obsidian里只是它用来管理的一个文件夹的代称,用不到一分钟。如果还没有的话,先从官网下载,然后打开vault切换器。它是应用左下角的一个小图标,你也可以通过命令面板搜索"Open another vault"进入同一个菜单。
选择"Create new vault"。系统会要求你输入名称:输入Brain。然后用Browse按钮选择它在你电脑上的存放位置;选择你的Documents文件夹,这样vault就会放在一个你不用多想就能找到的地方。点击Create,Obsidian就会打开这个全新的、空的vault。
这就是Obsidian那一侧的全部设置。在应用界面之下,这个vault其实只是Documents里一个名为Brain的文件夹,一旦你开始往里添加内容,它就会充满普通的.md文本文件。正是这种简单性才是关键所在:Claude Code可以直接打开同一个文件夹,把它当作你电脑上任何其他项目文件夹来处理,像在一个软件项目里处理代码一样,读取和编辑里面的文件。
在你完成本指南剩下的部分时,把vault一直保持在Obsidian中打开的状态,这样你就能看到Claude Code在下一步创建这些文件夹和文件的过程。
第三步
记忆系统:文件夹和文件
四个组成部分,全部是纯文本,全部放在你的Brain vault里。Claude Code会根据下面的搭建提示词为你创建它们;这里说明每一项的作用。
文件夹结构
Inbox、Projects、People、Decisions、Daily、Reviews、Archive,以及一个memory文件夹。每一个都只是一种特定类型笔记的存放位置,这样你记下的任何东西都不需要当场整理。
CLAUDE.md
一个规则文件,Claude Code会在这个文件夹里每次会话开始时读取它,这和软件项目自己的CLAUDE.md所承担的永久项目指令的理念相同,只是这里指向的是你的生活,而不是代码库。
STATE.md
一份简短的"当前情况"文件,刻意控制在80行以内。每当有变化时它都会被重写,而不是无限制地追加内容,所以它永远不会变成一长串已经过时的状态更新。
memory/MEMORY.md
memory文件夹里的一个索引文件,指出具体事实保存在哪里,这样每次你提问时,Claude就能快速找到正确的笔记,而不必重新读一遍整个vault。
进行搭建
用一条提示词搭建整套结构
你不需要手动搭建这些内容。在Obsidian中打开Brain vault,并在同一个文件夹中打开一个终端,运行claude开始一次会话,然后把下面的搭建提示词作为你的第一条消息贴上去。它会准确告诉Claude Code该创建哪些文件夹和文件,并指示它先采访你,而不是去猜测细节。
这次采访比文件夹结构本身更重要。从模板套出来的CLAUDE.md是通用的;而根据十个关于你的角色、主要项目、与你合作的人、你做决定的方式,以及你希望每日笔记如何记录的坦诚回答写出来的文件,从第一天起就真正有用。
回答时要清晰具体。"我负责管理一个五人的支持团队,向运营副总裁汇报"给Claude的信息,远比"我做管理工作"要多得多。你的回答越具体,Claude后面需要猜测的就越少,而这正是整套搭建存在的原因。
第四步
用Claude桌面应用搭建例行任务
只有在你记得去更新时才会更新的文件,很快就会过时。解决方法是Claude桌面应用中的定时任务,它们会按照计时器,针对你的vault运行Claude Code,完全不需要打开任何聊天窗口。在应用Code标签的侧边栏里,找到"Scheduled"。如果你的版本还显示旧的标签"Routines",就点击Routines,再点击"New routine",会打开同一个对话框。
点击"New task"打开它。如果系统让你在"Create with Claude"和"Set up manually"之间选择,请选择"Set up manually",这样你就能自己写指令,而不是用一句话描述任务,然后期望它被按照你的意思理解。
给任务命名并写下它的指令,可以用本指南下方的两个提示词示例之一作为起点。然后展开"Advanced settings",进入General标签,打开"Only on this computer"。正是这个设置让它成为一个本地任务:它会获得对你vault文件的直接访问权限,并且只在这台电脑上运行,只有在桌面应用打开且电脑没有休眠时才会执行。选择你的Brain vault作为本地文件夹,在Trigger卡片中用Daily、Weekdays或Weekly预设来设定时间表,选择权限模式和模型,然后点击Create。
创建之后立刻点击一次"Run now",之后每当Claude请求读取或写入文件的权限时,选择"always allow"而不是"allow once"。如果你跳过这一步,以后每一次按计划运行都可能卡在同样的权限请求上,却没有人去响应它,这就会破坏整个定时安排的意义。
有一个行为值得提前留意:这些任务只有在桌面应用保持打开且电脑没有休眠时才会触发,如果错过了一次运行,应用只会为最近一次错过的时间补跑恰好一次,前提是这个时间在最近7天之内,更早的则会被忽略。如果某个任务对时间很敏感,就把这个保护机制直接写进提示词,就像下面的晨间简报示例那样,在决定发布什么内容之前先检查时间,而不是假设计划总会准时触发。
每日习惯
让系统保持诚实的三条规则
文件和时间表完成了大部分工作。这三个习惯能防止整套系统在不知不觉中悄悄偏离。
直接丢进去,不要整理
当有什么想法冒出来时,直接把它放进Inbox,然后继续手头的事。决定它该归到哪里可以等到每周回顾的时候;当场整理是让记录这件事最终彻底停下来的最快方式。
问,不要自己挖
需要知道上个月关于某个项目你决定了什么吗?让Claude帮你去找,而不是自己翻旧的Daily笔记。这正是vault和索引文件存在的全部意义。
只改一次
如果Claude对某件事的记忆是错的,就在CLAUDE.md或STATE.md里改一次,而不是在每次会话的对话中纠正它。只留在聊天里的错误事实,只会在那一次聊天中被纠正。
为什么这套方案经得住时间
纯文本记忆能带给你什么
这一切都不依赖某个可能改变或消失的功能。它是一个完全属于你自己的文本文件文件夹。
纯文本,永久可用
只要电脑还能打开文本文件,Markdown文件就能在任何编辑器、任何电脑上打开。这里没有任何东西会把你的记忆锁在某一个应用的数据库里。
本地且私密
vault存放在你自己的电脑上。一个本地定时任务直接读取和写入它,系统运作不需要你笔记中的任何内容经过服务器。
随你一起成长
从少量笔记开始;无论你跟进的是一个项目还是十几个项目,同样的Inbox、Projects和Daily结构都能撑住,不需要重新设计。
没有额外费用
每月US$20的Claude Pro已经包含Claude Code,Obsidian也是免费的。本指南描述的整套系统,除了大多数读者已经拥有的那个方案之外,不需要花任何额外的钱。
继续和Claude一起学习
搭建Claude的记忆只是众多技能中的一个,用来真正、持续地把Claude Code用起来。免费注册Nightschool AI能让你进入课程体系,而一旦你的vault运转起来,Build Your First Claude Code Project套件就是自然而然的下一步。
常见问题
"给Claude一个记忆"具体是什么意思?
这意味着设置一些Claude会在每次会话开始时自动读取的文件,这样关于你的角色、项目和决定的事实就能跨越不同对话持续存在,而不是每次都被重置。Claude本身并没有获得任何新能力;你只是给了它一个地方,让它每次都去查看笔记,就像一个人会做的那样。
搭建这个系统需要我懂编程吗?
不需要。安装Claude Code只是运行一条复制好的命令,创建Obsidian vault只需要几次点击,文件夹结构和规则文件会在你贴上本指南的搭建提示词后自动为你搭建好。你在CLAUDE.md或STATE.md中写的一切,都是关于你自己工作的平实语言,不是代码。
这一整套下来要花多少钱?
Claude Pro每月US$20,已经包含Claude Code,所以如果你已经有Claude Pro、Max、Team、Enterprise或Console账户,就没有任何额外需要购买的东西。Obsidian下载和使用都是免费的。免费的claude.ai方案本身不包含Claude Code,所以要搭建这套特定方案,你需要升级账户。
为什么要用Obsidian,而不是一个普通的文本文件文件夹?
你完全可以用一个普通的文件夹,底层的思路依然适用,因为Obsidian的vault本身就只是装着markdown文件的文件夹。Obsidian额外提供了一个方便阅读的界面,用来浏览和链接你自己的笔记,这让直接使用vault更舒适,而Claude Code依然会以同样的方式读取和写入其中的文件。
CLAUDE.md和STATE.md有什么区别?
CLAUDE.md保存固定的规则:你是谁,你希望Claude如何表现,以及很少变化的背景信息。STATE.md保存当前的状态:现在正在进行的事情,刻意控制在80行以内,并通过重写而不是追加的方式维护,所以它始终是今天这一刻的快照,而不是一份不断膨胀的记录。
"本地"定时任务是什么,为什么在这里很重要?
在Advanced settings中打开"Only on this computer"会让一个定时任务变成本地任务:它会获得对你电脑上一个文件夹,也就是你的Brain vault的直接访问权限,并且只在那台电脑上运行,只有在Claude桌面应用打开且电脑没有休眠时才会执行。非本地的任务完全没有访问这类文件夹的文件权限,这就是本指南中的例行任务需要本地设置的原因。
如果在定时任务应该运行的时候我的电脑在休眠,会发生什么?
Claude桌面应用会为最近一次错过的时间补跑恰好一次,前提是这个时间在最近7天之内,更早的则会被忽略。如果时间点很重要,就把检查逻辑直接写进提示词里,比如当运行时间比计划晚很多时,跳过正常格式,只发一条简短的说明。
本指南与Anthropic或Obsidian有合作关系吗?
没有。这是一份独立撰写的教育性指南,并非由Anthropic或Obsidian发布或认可。这里提到Claude、Claude Code和Obsidian,只是为了准确描述它们;它们分别是Anthropic和Obsidian各自的产品和商标。
我可以把这个用在个人生活上,而不只是工作上吗?
可以。这套文件夹结构(People、Decisions、Daily笔记等)同样适用于个人项目、家庭事务安排,或者任何你希望跨会话被记住的事情。这套搭建方案并没有特别假定一定是工作场景;它是一个通用的记忆系统,你可以把它指向任何你想让Claude持续跟进的内容。
如果Claude对某件事的记忆是错的,该怎么办?
在CLAUDE.md或STATE.md里改一次,而不是在聊天里去纠正它。只在一次对话中打出来的更正,只会修正那一次对话;下一次会话会重新从头读取文件,在文件本身被更新之前,会一直重复同一个错误的事实。