企业官网建设流程全解析

claude-obsidian快速上手指南：从克隆仓库到第一篇笔记的5个步骤

【免费下载链接】claude-obsidianSelf-organizing AI second brain for Obsidian + Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathy's LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian

claude-obsidian 是一款开源的AI 第二大脑，基于 Obsidian + Claude Code 构建：把你丢进仓库的任意资料，交给 Claude 阅读、打链接、归档，自动沉淀成一张由纯 Markdown 组成的知识图谱，所有文件都存放在你自己的电脑上，不上传云端。

无论你是 PKM 新手还是 Obsidian 老用户，跟着下面5 个步骤，就能从克隆仓库一路走到你的第一篇互联笔记，全程基本只需几条命令。✨

第一步：克隆 claude-obsidian 仓库（准备环境）

先确认本地已安装：

• Python 3.11+（核心脚本依赖）
• Claude Code（或其他支持 Agent Skills 的宿主，如 Codex、Gemini）
• Obsidian（可选，用于可视化浏览笔记）

然后在终端执行：

git clone https://gitcode.com/GitHub_Trending/cl/claude-obsidian cd claude-obsidian

⚠️ 重要概念：克隆下来的目录是"产品"（技能、脚本、模板），而不是你的知识库。项目刻意把「代码」和「数据」分离，你的笔记永远住在独立的 vault 目录里。

第二步：初始化你的个人知识 vault（两阶段确认）

进入仓库目录后运行 init 命令，首次执行只会预览一份 JSON 计划，不会写入任何文件：

export GENERATED_AT="$(date -u +%Y-%m-%dT%H:%M:%SZ)" export OPERATION_ID="init-reviewed" python3 scripts/claude-obsidian.py init "$HOME/Documents/MyKnowledgeVault" \ --generated-at "$GENERATED_AT" --operation-id "$OPERATION_ID"

检查计划中的目标路径和变更清单没问题后，补上--approved-plan-sha256 <计划中的哈希> --apply再执行一次，vault 就真正创建完成了。✅

新建的 vault 长这样：

如果已经有一个 Obsidian vault，不要重建——用非破坏性的adopt命令接入即可，详见docs/install-guide.md。

第三步：用 Obsidian 打开 vault，并接入 Claude Code

1. 在 Obsidian 中选择「Open folder as vault」，打开上一步生成的目录；
2. 在终端进入vault 目录（注意：不是产品仓库目录），加载本地插件启动 Claude Code：

cd "$HOME/Documents/MyKnowledgeVault" claude --plugin-dir /absolute/path/to/claude-obsidian

3. 输入/claude-obsidian:wiki，它会检查 vault 的就绪状态并引导后续操作。

💡 vault 的选中优先级是：--vault参数 >CLAUDE_OBSIDIAN_VAULT环境变量 > 就近的.claude-obsidian.json。选不明确时命令会直接退出而不写入，避免误操作。

第四步：把第一份资料丢进 inbox，运行 wiki-ingest

现在到了最有趣的部分 📥 把一份资料（Markdown、文本等）放进 vault 的inbox/目录，然后在 Claude Code 中调用：

/claude-obsidian:wiki-ingest

claude-obsidian 会读取资料、与 vault 中已有笔记做比对，然后生成带来源引用的互联笔记，并写入来源账本（记录权威度、置信度、是否矛盾等元数据）——而不是简单复制粘贴一段摘要。

跑几份资料后，在 Obsidian 的图谱视图里就能看到你正在生长的大脑：

第五步：向知识库提问，并保存第一篇笔记

• 提问：输入/claude-obsidian:wiki-query，Claude 只基于 vault 里已有的证据作答，答案有出处、可追溯；
• 保存：当某次回答或洞察值得留下时，用/claude-obsidian:save显式保存为笔记（它只保存你选定的范围，绝不会自动归档整段对话）；
• 整理：之后可随时运行/claude-obsidian:wiki-lint检查死链、孤儿页和过期索引。

用 canvas 技能还可以把 wiki 结构画成视觉知识地图，一眼看清概念、实体与来源的关系：

常见问题与下一步

Q：提示"no vault selected"？从 vault 目录内运行命令，或显式传--vault/ 设置CLAUDE_OBSIDIAN_VAULT。

Q：怎么验证 vault 健康？运行doctor和contracts --verify两个只读检查命令。

Q：装完能干什么？15 个技能覆盖完整工作流：构建（wiki、wiki-ingest、save）、检索（wiki-query、wiki-retrieve）、维护（wiki-lint、wiki-fold）、扩展（wiki-mode 的 PARA/Zettelkasten 分类、autoresearch 网络调研），每个技能的行为契约都写在对应的skills/<名称>/SKILL.md里。

想走得更深，可以看看这些资料：

• 完整安装/升级/卸载指南：docs/install-guide.md
• 官方示例 vault（可以直接打开学习结构）：examples/sample-vault/
• 核心脚本入口：scripts/claude-obsidian.py
• 默认模板：templates/vault/

恭喜你，AI 第二大脑已经上线 🎉 之后每摄入一份新资料，图谱都会变得更稠密一点——知识开始复利了。

【免费下载链接】claude-obsidianSelf-organizing AI second brain for Obsidian + Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathy's LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian