概述
Claude Code 是 Anthropic 官方的 CLI 工具，可以通过多种方式与 Obsidian 笔记库集成，实现 AI 辅助知识管理。本文档整理了相关的集成方案、实用工具和最佳实践。
集成方式
方式一：直接在 Vault 目录运行 Claude Code
最简单的方式是直接在 Obsidian Vault 目录下运行 Claude Code：
cd /path/to/obsidian-vault
claudeClaude Code 可以直接读写 Markdown 文件，天然适合 Obsidian 笔记操作。
方式二：MCP 服务器集成
通过 MCP (Model Context Protocol) 实现更深度的集成，让 Claude 能够访问 Obsidian 的特定功能。
推荐的 MCP 插件
| 插件 | 特点 | 适用场景 |
|---|---|---|
| obsidian-claude-code-mcp | 双传输支持 (WebSocket + HTTP/SSE)，自动发现 | Claude Code CLI + Claude Desktop 同时使用 |
| obsidian-mcp-tools | 语义搜索、模板集成、安全架构 | 需要智能搜索和模板执行 |
| Nexus/Claudesidian | 内置聊天界面、本地记忆系统、多模型支持 | 完全在 Obsidian 内使用 AI |
| mcp-obsidian | 通过 REST API 交互 | 已有 Local REST API 插件 |
MCP 的价值与取舍
不用 MCP 时，Claude Code 已有的能力：
- 读写任意
.md文件 - 搜索文件内容（Grep/Glob）
- 批量处理文件
MCP 额外提供的能力：
| 能力 | 说明 | 实际价值 |
|---|---|---|
| 语义搜索 | 基于含义而非关键词搜索 | 高（笔记量大且命名不规范时） |
| Obsidian 元数据访问 | 读取内部链接图谱、标签索引 | 中（用于分析笔记关系） |
| 模板执行 | 调用 Templater 模板 | 低（Claude 可直接生成内容） |
| 活动文件感知 | 知道当前打开的笔记 | 低（可直接告诉路径） |
Token 消耗： MCP 本身不会显著增加消耗，工具描述约占几百 token，相比笔记内容可忽略。
不需要 MCP 的情况：
- 笔记量 < 500 篇
- 文件命名规范，可通过路径快速定位
- 主要在 Claude Code CLI 中工作
- 关键词搜索够用
可能需要 MCP 的情况：
- 笔记量 > 1000 篇且组织混乱
- 想在 Claude Desktop 中访问笔记
- 重度依赖 Obsidian 的链接图谱分析
- 希望在 Obsidian 内直接对话（Nexus/Claudesidian）
建议
如果目录结构清晰（如使用编号分类），直接在 vault 目录运行 Claude Code 即可。等笔记量大幅增长或需要语义搜索时再考虑 MCP。
obsidian-claude-code-mcp 配置
- 在 Obsidian 中安装并启用插件
- 对于 Claude Code CLI：运行
claude，使用/ide命令选择 “Obsidian” - 对于 Claude Desktop，配置
claude_desktop_config.json：
{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": ["mcp-remote", "http://localhost:22360/sse"],
"env": {}
}
}
}Claude Code 扩展能力
自定义命令 (Slash Commands)
在 .claude/commands/ 目录下创建 .md 文件即可定义命令。
实用命令示例
创建笔记命令 .claude/commands/note.md：
---
allowed-tools: Write, Read, Glob
argument-hint: [标题] [目录路径]
description: 创建新笔记
---
在指定目录创建新的 Obsidian 笔记。
标题: $1
目录: $2
要求：
1. 使用通用模板格式（包含 frontmatter: tags, cssclasses, created, updated）
2. 文件名使用标题
3. created 和 updated 使用当前时间，格式 YYYY-MM-DD HH:mm搜索笔记命令 .claude/commands/search.md：
---
allowed-tools: Grep, Glob, Read
argument-hint: [关键词]
description: 在笔记库中搜索内容
---
在 Obsidian 笔记库中搜索包含以下关键词的笔记：$ARGUMENTS
请列出匹配的文件和相关上下文。整理笔记命令 .claude/commands/organize.md：
---
allowed-tools: Read, Edit, Glob
argument-hint: [笔记路径]
description: 整理和优化笔记结构
---
请帮我整理以下笔记：$ARGUMENTS
要求：
1. 优化标题层级结构
2. 检查并修复 Markdown 格式问题
3. 补充缺失的 frontmatter 字段
4. 建议可能的内部链接总结笔记命令 .claude/commands/summarize.md：
---
allowed-tools: Read, Glob
argument-hint: [笔记路径或目录]
description: 生成笔记摘要
---
阅读并总结以下内容：$ARGUMENTS
输出格式：
- 主要观点（3-5 条）
- 关键概念
- 待办/行动项（如果有）Skills (技能)
Skills 是更复杂的能力模块，Claude 会自动识别并调用。
创建笔记管理 Skill
目录结构 .claude/skills/note-manager/：
SKILL.md：
---
name: obsidian-note-manager
description: 管理 Obsidian 笔记库。当用户需要创建笔记、整理笔记、搜索内容、建立链接关系时使用此技能。
allowed-tools: Read, Write, Edit, Glob, Grep
---
# Obsidian 笔记管理技能
## 笔记库结构
- `0A-0F`: 临时性内容（收集、灵感、项目、时记、会议、任务）
- `1A-1Z`: 知识库
- `2A-2J`: 个人管理
- `9Z 系统区`: 模板和示例
## 笔记格式规范
### Frontmatter 模板
所有笔记必须包含：
```yaml
---
tags: []
cssclasses: []
created: YYYY-MM-DD HH:mm
updated: YYYY-MM-DD HH:mm
---操作指南
创建笔记
- 确定目标目录
- 使用正确的 frontmatter
- 遵循目录的命名约定
整理笔记
- 检查 frontmatter 完整性
- 优化标题层级
- 添加内部链接 [[]]
- 更新 updated 时间戳
搜索内容
- 使用 Grep 搜索关键词
- 使用 Glob 匹配文件模式
- 汇总相关笔记
### Hooks (钩子)
Hooks 可在特定事件时自动执行脚本。
#### 实用 Hook 配置
在 `~/.claude/settings.json` 或 `.claude/settings.json` 中配置：
```json
{
"hooks": {
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [
{
"type": "command",
"command": "jq -r '.tool_input.file_path' | { read fp; if echo \"$fp\" | grep -q '\\.md$'; then sed -i 's/^updated: .*/updated: '$(date +\"%Y-%m-%d %H:%M\")'/g' \"$fp\" 2>/dev/null || true; fi; }"
}
]
}
]
}
}
这个 Hook 会在每次编辑 Markdown 文件后自动更新 updated 时间戳。
最佳实践
工作流设计
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 信息收集 │────▶│ AI 处理 │────▶│ 知识整理 │
│ (0A 收集) │ │ (Claude Code) │ │ (1x 知识库) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
│ ▼ │
│ ┌─────────────────┐ │
└──────────────▶│ 定期回顾 │◀────────────┘
│ (AI 辅助总结) │
└─────────────────┘
推荐的使用场景
- 快速创建笔记：使用
/note命令快速创建格式规范的笔记 - 内容搜索：使用
/search在大量笔记中快速定位信息 - 笔记整理：使用
/organize优化笔记结构和链接 - 知识总结：使用
/summarize生成学习内容的摘要 - 代码片段管理：Claude Code 可以帮助整理和注释代码笔记
- 批量处理：利用 Claude Code 的脚本能力批量更新笔记格式
注意事项
- 备份：在批量操作前备份重要笔记
- Git 版本控制：利用 Git 跟踪笔记变更，便于回滚
- 渐进式采用：从简单命令开始，逐步增加复杂功能
- 保持简单：避免过度自动化，保留人工思考的空间
相关资源
- Claude Code 官方文档
- Model Context Protocol
- obsidian-claude-code-mcp
- obsidian-mcp-tools
- Nexus/Claudesidian MCP