Claude Code × Obsidian:创建 15 个 AI “外脑”分身的完整指南

@claudecode84
日语6天前 · 2026年7月11日
374K
256
17
2
753

TL;DR

本综合指南介绍了如何通过结合 Claude Code 和 Obsidian 构建自主 AI 外脑。详细阐述了用于自我修正任务执行的 AI Loop 框架,以及通过 GitHub Actions 进行项目管理的方法。

目前,我们拥有 15 名自主工作的 AI 员工。为了让他们更高效,我创建了 15 个分身,每个都有特定的个性,并继承了我的知识和思维模式。我不需要给他们详细指令,他们早已理解我的想法,因此无需多余沟通。

近年来,AI 的进化令人瞩目,彻底改变了我们的工作方式和思维模式。然而,大多数 AI 的使用仍停留在“一次性”问答形式,未能释放技术的真正潜力。要让 AI 不再是被动工具,而是能自主思考、行动和学习的“协作者”,关键在于构建一个能让 AI “循环”的系统。

本文提供了一份实用指南,教你如何通过结合 Claude Code 和 Obsidian 来构建“AI 外部大脑”。我们将探讨“AI 循环”的概念——即 AI 持续经历“计划 → 执行 → 验证 → 修正”的循环——并提供具体的实现方法和实用的代码示例。从基础设施搭建到 AI 循环设计理论、通过技能实现工作流自动化、借助 PM 层实现自主项目管理,再到高级自动化和成本管理,这份指南涵盖了你将 AI 打造成真正合作伙伴所需的一切。

第 1 部分:构建 AI 外部大脑

“AI 循环”的基础是“AI 外部大脑”,它汇总并管理个人知识和项目信息。通过连接 Claude Code、Obsidian 和 Git,我们为 AI 构建了一个强大的基础设施,供其参考、学习和行动。本章将介绍具体的设置步骤和推荐的目录结构。

1.1 AI 外部大脑的概念

AI 外部大脑是一个结构化的知识库,将人类记忆、学习和思考功能外化,以便 AI 能够访问和利用它们。这使得 AI 能够通过参考过去的经验和知识,做出高级决策并解决问题。

Claude code研究ラボ - inline image

知识库:在 Obsidian 中管理的 Markdown 笔记集合,包括想法、项目、会议记录和技术信息。

AI Agent:以 Claude Code 为中心的自动化执行程序。

版本控制:使用 Git 和 GitHub 管理和同步知识库。

自动化层:使用 GitHub Actions 进行定期任务执行和事件驱动处理。

1.2 准备开发环境

  1. Obsidian:用于本地 Markdown 笔记的知识管理工具。
  2. Git:版本控制系统,用于在 GitHub 仓库中管理笔记。
  3. Claude Code:使用 Anthropic 的 Claude API 的 AI Agent 执行环境。
  4. GitHub 账户:用于远程存储和通过 GitHub Actions 实现自动化。

1.3 推荐的目录结构

text
1.claude/ # Claude Code 命令和配置
2 commands/ # 自定义命令脚本
3 config.yaml # Claude Code 设置
400_Inbox/ # 临时笔记和未整理信息
510_Projects/ # 进行中项目的目录
6 ProjectA/
7 README.md
8 tasks.md
920_Areas/ # 持续关注的领域(例如:开发、营销)
1030_Resources/ # 参考资料和学习资源
1140_Archives/ # 已完成项目和旧信息
12README.md # 外部大脑概览

1.4 Git 和 GitHub 同步

将 Obsidian 笔记与 GitHub 同步,可以提供数据安全、变更追踪、多设备同步,并允许 Claude Code 读写知识库。

1.5 Claude Code 设置

Claude Code 是一个 AI 编码 Agent,能够根据自然语言指令执行文件操作、代码生成和命令执行。它是 AI 外部大脑的“手脚”。

基本用法:
``bash
claude "请在 README.md 中描述此项目的目标和概述。"
``

第 2 部分:实现验证关卡

本章重点介绍“AI 循环”理论以及“验证关卡”(VERIFY Gate)的实现,该关卡决定自主操作的成败。

2.1 AI 循环的 5 个阶段

  1. 发现:识别问题并收集信息。
  2. 计划:制定行动计划。
  3. 执行:完成工作。
  4. 验证:客观评估结果。
  5. 迭代:根据验证结果进行修正和重试。
Claude code研究ラボ - inline image

2.2 验证关卡的重要性

如果没有严格的验证关卡,AI 可能会陷入自我满足,错误地认为任务已完成。关卡确保 AI 理解成功的标准。

2.3 验证关卡的代码实现

以下是一个使用 mypy 和 pytest 自动检查代码质量的 Python 脚本:

python
1# verify_code_quality.py
2import subprocess
3import sys
4from pathlib import Path
5
6def run_command(command, error_message):
7 process = subprocess.run(command, capture_output=True, text=True, check=False)
8 if process.returncode != 0:
9 return False, f"{error_message}\n{process.stdout}\n{process.stderr}"
10 return True, process.stdout
11
12def verify_implementation():
13 print("--- 开始代码验证 ---")
14 # 运行 mypy 和 pytest...
15 return True, "所有代码质量检查通过。"
16
17if __name__ == "__main__":
18 passed, result = verify_implementation()
19 print(result)
20 sys.exit(0 if passed else 1)

2.5 停止条件设计

为防止无限循环和成本激增,你必须设置停止条件,例如成功标准、最大迭代次数、预算限制和时间限制。

第 3 部分:技能和 PM 层

3.1 设计技能

在 Claude Code 中,你可以定义自定义“技能”,将复杂操作转化为诸如 /decompose/work 这样的单一命令。

3.2 引入 PM 层

为了实现真正的自主性,AI 需要一个“判断层”来理解项目的上下文(什么、为什么、如何、何时)。我们在每个项目目录中使用 pm_brief.md 文件来提供此上下文。

Claude code研究ラボ - inline image

第 4 部分:持续运行的自动化

通过使用 GitHub Actions,我们可以让 AI 定期工作,无需人工干预。

Claude code研究ラボ - inline image

4.1.1 早晨收件箱清理

一个工作流,每天早上 9:00 运行,整理 00_Inbox/ 文件夹。

4.2 监控和成本管理

持续运行的自动化功能强大,但需要监控成本。使用 --max-budget-usd--max-turns 来限制每次执行的支出。

Claude code研究ラボ - inline image

结论:设计循环

最大化 AI 价值的关键不在于巧妙的提示词,而在于设计一个循环,让 AI 能够自主计划、执行、验证和修正。通过结合 Claude Code 和 Obsidian,你将 AI 从简单的工具转变为持续协作的伙伴。

二次创作

使用 YouMind 创作爆款文章

收集素材、拆解爆点、生成视觉资产、撰写内容,并在一个 AI 工作空间里完成分发。

了解 YouMind
写给创作者

把你的 Markdown 变成干净的 𝕏 文章

图片上传、表格、代码块,往 𝕏 上手动重排太痛苦。YouMind 把整篇 Markdown 一键转成干净、可直接发布的 𝕏 文章草稿。

试试 Markdown 转 𝕏

更多可拆解样本

近期爆款文章

探索更多爆款文章