Claude Code 进场

最简连接：进入目录

Claude Code 不需要 Obsidian API。终端进入 vault 根目录再启动即可：

cd ~/Documents/my-vault
claude

此后它能看到的就是当前目录中的普通文件。开始前先用 Git 或备份保护原始内容，并让第一次任务保持只读。

CLAUDE.md：给 AI 的员工手册

一份有效的 CLAUDE.md 至少回答五个问题：

1. 这个知识库服务于谁、关注什么。
2. 主要目录分别存放什么。
3. 新笔记使用什么格式和命名。
4. 哪些内容允许修改，哪些必须先确认。
5. 每次任务结束应该留下什么报告或索引更新。

# 我的知识库

## 关于我
- 关注领域：AI、知识管理、写作
- 偏好：使用中文，表达直接，不要过度格式化

## 目录
- notes/：我的原始笔记，未经确认不要改写
- projects/：进行中的项目
- raw/：待整理的原始素材
- archive/：已完成或不再活跃的内容

## 工作规则
- 先搜索已有内容，再创建新文件
- 不删除原始记录
- 批量修改前先给出计划，完成后给出变更摘要
- 整理完成后更新相关目录的 index.md

index.md：让目录可以被快速理解

根目录的 CLAUDE.md 负责全局规则，每个主题目录的 index.md 负责局部导航。一个简单索引只需列出范围、重要文件和一句话说明。

# 心智模型索引

- [[第一性原理]] - 从基本事实重新推导
- [[反脆弱]] - 在不确定性中获益
- [[复利]] - 小优势经过时间累积

这类索引既方便人浏览，也让 AI 不必每次扫描全部文件。

Obsidian Skills 与第一次协作

原书推荐安装 kepano 的 obsidian-skills，帮助 Claude Code 正确处理 wikilinks、frontmatter、callout、Canvas 和 Bases。安装方式可能随工具版本变化，执行前应查看项目最新说明。

第一次协作不要直接要求“整理整个知识库”。先选择一个小目录，并要求 AI 只报告、后修改。

扫描 notes/ 中的 Markdown 文件，不要立即修改。
先输出：主题分组、重复内容、缺失摘要、可建立的双链，以及每项建议会修改哪些文件。
等我确认后再分批执行；不要删除原文，每批完成后给出 git diff 摘要。

本课练习：写出可执行边界

• 在 vault 根目录创建 CLAUDE.md
• 写清至少三个目录的职责
• 加入“未经确认不删除或改写原始记录”
• 为一个目录创建 index.md
• 让 AI 完成一次只读扫描并检查报告

下载《CLAUDE.md 起步模板》

边界越明确，AI 越像可靠同事；“随便整理一下”只会把判断成本推迟到结果出来之后。