Claude Code 与 Obsidian：你和智能体共用一个仓库

Claude Code 和 Obsidian 为什么相配

Obsidian 仓库（vault）是一个普通的文本文件夹，中间没有数据库。因此，智能体可以像你一样在其中工作。

Claude Code 是一个 AI 智能体，运行在终端、编辑器或桌面 App 中，并在你启动它的文件夹中工作。它读取文件、创建新文件、修改已有文件，并运行命令。在仓库中启动它，你的整个第二大脑就摆在它面前：它可以总结会议记录、补上缺失的链接、整理一批资料，或把你的大纲写成初稿，作为新笔记放进合适的文件夹。

这并不限于 Claude Code。Codex、Cursor、Gemini CLI 和其他能访问文件的智能体也是这样工作的。而浏览器中的聊天看不到你的仓库，除非你把文件拷贝进去。

在仓库中设置 Claude Code

把仓库作为工作目录

Claude Code 在你启动它的文件夹中工作。如果你的仓库位于 iCloud 云盘中，在终端中大致如下：

cd ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/Vault
claude

请有意识地决定智能体能看到多少内容。初次尝试时，一个子文件夹就够了，例如某个项目的文件夹。在允许较大的更改之前，先备份仓库：Claude Code 可以撤回它自己对文件的编辑，但无法撤回通过终端命令所做的更改。仓库中的 Git 或时间机器可以弥补这一点。

允许访问链接文件夹中的任务

如果你通过符号链接把 TandemLoop 的数据文件夹引入仓库，它的实际位置就在工作目录之外，Claude Code 每次写入时都会请求许可。因此，也要允许它访问这个文件夹：启动时使用 --add-dir，在运行中的会话里使用 /add-dir，或在设置的 additionalDirectories 中永久添加：

claude --add-dir "<TandemLoop 文件夹>"

如何创建链接、为什么只能在 Mac 上使用，请参阅指南连接第二大脑和待办事项清单。

CLAUDE.md：仓库的规则

每次会话开始时，Claude Code 都会读取工作目录及其上级文件夹中的 CLAUDE.md 文件。其中写着智能体需要了解的仓库情况，以及它可以做什么。运行 /init 生成初稿，再加以完善。Anthropic 建议文件保持简短，最好不超过 200 行，只写下智能体自己无法弄清的内容。

# 仓库

存放 Markdown 笔记的 Obsidian 仓库。链接使用 Wiki 链接 [[笔记]]。

## 文件夹
- 笔记/：我的笔记，只在我要求时修改
- 在线课程/：课程的资料和成果
- TandemLoop/：我的待办事项 App 的数据文件夹（链接）

## 规则
- 未经询问，绝不删除或重新命名笔记。
- 成果存储为相应文件夹中的新笔记。
- 不要改动文件开头属性的结构。

## 任务
处理任务时，先阅读 TandemLoop/AGENTS.md 并遵守其中的规则。

其他智能体通常读取 AGENTS.md，而不是 CLAUDE.md。只要找不到 CLAUDE.md，Claude Code 也会自行读取 AGENTS.md。如果两者都要用，就在一个文件中用 @AGENTS.md 引入另一个。这类给智能体的手册如何组织，请参阅指南智能体工程。

Obsidian 任务：复选框和 Tasks 插件

Obsidian 用复选框表示任务。像 - [ ] 撰写第 2 课的脚本 这样的一行就是一个未完成的任务；写成 [x] 就表示已完成。如果只是在单篇笔记中列一张 Obsidian 待办清单，这就够了。

社区插件 Tasks 把它扩展成覆盖整个仓库的任务管理。截止日期、优先级和重复以符号形式写在这一行中，例如用 📅 2026-10-23 表示截止日期。完成任务时，插件会补上日期；对于重复任务，它会创建下一行。代码块中的查询会从所有笔记中汇集任务：

```tasks
not done
due next week
```

这种方式的长处在于：任务就在产生它的地方，直接写在项目笔记和会议记录中。对许多在 Obsidian 中维护第二大脑的人来说，这已经够用了。

Tasks 插件的局限

• 提醒：Tasks 插件本身不会提醒你。通知要靠 Reminder 等其他插件，而其文档写明，在 iPhone 和 Android 上无法发送系统通知。
• 在外录入：从 iOS 26 起，Obsidian 支持从锁定屏幕、控制中心和小组件快速记录。这样录入的内容会作为文本进入一篇笔记。日期、项目和负责人，之后要你手动补上。
• 分配：一行文字没有记录负责人的字段。你可以和智能体约定一个标签，例如 #agent，但没有“待验收”状态，也没有地方存放它的成果或你们之间的问题。
• 你的笔记，而不是智能体的：要勾选或补充任务，智能体必须修改你笔记中的那一行。包含任务的笔记越多，它为此动到的文件就越多。

用 Claude Code 处理 Obsidian 任务：分配给你的智能体

除了一行文字，另一种选择是带状态、截止日期和负责人的独立任务。它附有对目标和验收标准的描述，以及一份记录，智能体会在其中写下它做了什么。

与智能体协作时，这有实实在在的好处：

• 智能体修改任务时，不会动到你的笔记。
• 负责人和状态一目了然：你把任务分配给智能体，完成后，任务以“待验收”的状态回到你手中。
• 成果和问题都留在任务上，而不是留在明天就找不到的聊天记录里。

没有人想手动维护这样的结构。这需要一份给智能体的手册，以及一个把文件变成列表、视图和提醒的 App。

TandemLoop 能帮上什么：录入、视图、提醒

TandemLoop 是一款适用于 Mac、iPad 和 iPhone 的待办事项 App，正是这样工作的。它的数据文件夹可以位于本地或 iCloud 云盘中，可以是仓库的一个子文件夹，也可以通过链接出现在仓库中。这样，智能体就能在整个仓库中工作，笔记和任务都包括在内。

• 录入：快速录入、共享菜单、控制中心、快捷指令和 Siri 都会创建真正的任务，愿意的话可以直接分配给智能体。
• 视图：列表、表格、看板、日程、日历、多栏视图和仪表板，可以过滤，例如按负责人或截止日期。
• 提醒：带时间的截止日期，带“完成”“稍后”和“明天”的通知，以及主屏幕和锁定屏幕上的小组件。
• 智能体：数据文件夹中有 AGENTS.md，这是给智能体的手册。智能体可以访问数据文件夹中的一切：它创建任务、项目、领域和视图，更改和移动它们，并处理分配给它的任务。开启提案后，它只会直接在收件箱中添加新条目，其他一切都作为提案提交。
• 交回：完成后，或需要你提供什么时，它会把任务交回。任务会出现在“智能体交回”中，在 iPhone 上则位于“交回”标签页。

关于与智能体分工的一切，从提案到交回，请参阅页面与 AI 智能体协作的待办事项 App。不使用智能体时的全部功能，请参阅待办事项 App 概览。

工作流示例：收件箱 → 智能体 → 成果

一个来自项目“在线课程”的工作流：大纲是 Obsidian 中的一篇笔记，智能体要起草第 2 课的脚本。

1. 录入。上班路上，你在快速录入中输入“撰写第 2 课的脚本”，并把任务分配给智能体，委派方式为“起草”。任务进入收件箱。
2. 指令。在 Mac 上，你在仓库中启动 Claude Code 并输入：“处理你在 TandemLoop 中的任务。”它阅读手册，找到这个任务，也找到你的课程大纲。
3. 成果在任务上。它把脚本作为笔记存储在“在线课程”文件夹中，并在任务的记录中写下它做了什么，附上指向这篇笔记的链接。
4. 智能体交回。由于委派方式是“起草”，它不会自己完成任务，而是把任务交回给你验收。你在 Obsidian 中阅读脚本，然后在 TandemLoop 中选择“验收”，或附上说明选择“退回修改”。
5. 只有你能做的事。如果上传需要课程平台上经过验证的账户，它会把“确认课程平台的访问权限”放进你的收件箱，而不是在一大段回复中顺带一提。

如果智能体在你的 Mac 上循环运行，例如在 Claude Code 中使用 TandemLoop 的 Worker 技能和 /loop 10m /tandem-worker，即使你不在，它也会处理这样的任务。同一时间应该只有一个智能体写入。

哪种方式适合你

两者可以混用：小事的清单留在笔记中，智能体要处理的一切都成为独立的任务。如果你用 Getting Things Done 组织任务，GTD 方法指南会告诉你智能体可以承担哪些步骤。