本指南旨在帮助高级知识工作者与开发者，从零开始搭建一套完全本地优先、数据自主可控、具备自进化能力的个人知识管理系统（PKM）。通过将 Obsidian（展示与网状双链前端） 与 Claude Code + Codex CLI（本地智能体命令行引擎） 深度融合，实现信息的自动采集、自动编译、智能织网和多模态输出。

一、 核心设计哲学：从“信息垃圾场”到“自生长循环”

1.1 传统 AI 知识库（RAG 模式）的局限性

• 问答黑盒：你将 PDF 或 Markdown 丢入云端产品中，AI 切片并向量化后存在远程数据库。虽然能问，但 AI 产生的摘要、关联、反链和标签，你无法掌握和自主修改。
• 数据主权缺失：知识一旦锁死在封闭云端，迁移成本极高。一旦平台关服，你多年沉淀的知识网络瞬间失效。
• 临时工效应：每次对话都需要手动复制背景资料，AI 回复后仍需手动搬运回笔记。人机协作断层。

1.2 卡帕西（Karpathy）的“LLM Wiki”理念

• 裸文件优先：知识库的底层就是你电脑磁盘上的一个普通文件夹，里面全是普通的 .md (Markdown) 格式文本与本地图片。没有任何私有格式，任何编辑器或编程语言都能直接处理。
• AI 充当“编译官”：AI 拥有终端控制权限，可以直接在本地对笔记进行读取、检索、归档、修改并自动生成反向链接（[[概念名]]）。双链文本是 AI 最容易读懂的网状结构。
• GAP 知识管理闭环（Grasp-Arrange-Publish）： 在你的 Obsidian Vault 根目录下，必须建立以下 4 个核心文件夹：
  1. 📁 Grasp（采集原料库）：存放未处理的原始网页剪藏、截图、微信消息沉淀、会议记录和视频字幕。
  2. 📁 Arrange（概念百科库）：存放长期沉淀的结构化双链概念卡片、案例与核心数据。
  3. 📁 Skill（方法论模板库）：存放你训练 AI 的工作指南。例如：文风模板（文风_Skill.md）、选题标准（选题_Skill.md）。
  4. 📁 Publish（输出成果库）：存放由 AI 生成的最终方案、周报、文章、PPT 大纲或视频脚本。这些成果复盘后，会再次流向概念卡片，实现知识螺旋上升。

二、 环境前置准备：Node.js 安装与仓库初始化

2.1 安装 Node.js（小白专用，老手可跳过）

Node.js 是运行后续所有 npm 命令行智能体工具的基石。未安装时在终端运行命令会报 command not found: npm。

• Windows 平台：
  1. 访问 nodejs.org 下载最新 LTS（长期支持）版 的 Windows Installer (.msi) 安装包。
  2. 双击安装，一路点击“Next”保持默认设置即可。
  3. 【关键注意】安装完成后，必须重启电脑！ 否则系统环境变量不会立即生效。
• Mac 平台：
  1. 推荐使用 Homebrew 安装。打开终端，运行： brew install node
  2. 若未安装 Homebrew，可前往 Node.js 官网下载 Mac 安装包 (.pkg) 一键安装。
• 验证安装： 打开你的终端（Windows 使用 PowerShell，Mac 使用 Terminal），依次跑： node -v npm -v 如果各自输出了一行版本号（例如 v20.11.0 和 10.2.4），则代表安装成功。

2.2 初始化 Obsidian 仓库

1. 打开 Obsidian（建议版本 v1.4.5+）。
2. 点击 “新建仓库” (Create new vault)，在本地硬盘上选择或创建一个空的文件夹（例如命名为 MySecondBrain）。
3. 在此仓库内，手动创建上述的 4 个核心文件夹：
   • 01_Grasp
   • 02_Arrange
   • 03_Skill
   • 04_Publish

三、 在 Obsidian 中安装 Claudian 插件本体

Claudian 是 2026 年最强悍的本地 AI 智能体集成插件，可以将命令行终端工具直接内嵌在 Obsidian 侧边栏中。因为目前尚未上架官方插件市场，我们需要通过 BRAT 插件进行 GitHub 源码覆盖安装。

Step 1: 开启第三方插件安全总闸

1. 点击 Obsidian 左下角齿轮 设置图标 (⚙)。
2. 侧边栏滑到「第三方插件」 (Community plugins)。
3. 将「安全模式」 (Restricted mode) 状态从开启调整为 关闭。

Step 2: 安装 BRAT 插件

1. 关闭安全模式后，点击下方「社区插件市场」旁边的「浏览」 (Browse) 按钮。
2. 搜索框内输入 brat，认准作者为 TfTHacker 的插件（下载量 68 万+）。
3. 点击「安装」 (Install)，等待几秒，安装完成后点击「启用」 (Enable)。

Step 3: 通过 BRAT 挂载 Claudian

1. 回到设置页面，左侧滑到最底部，在已安装插件分类中找到 BRAT 点进去。
2. 在右侧 BRAT 设置页，滑到「Beta plugin list」区域，点击紫色按钮「Add beta plugin」。
3. 在弹出的 Repository 输入框中，完整粘贴 Claudian 的 GitHub 源码仓库地址： https://github.com/YishenTu/claudian
4. 点击「Add plugin」，等待 5~10 秒。当屏幕顶部弹出绿色成功提示时，说明 Claudian 插件已被成功下载并启用。
5. 重启 Obsidian（关闭软件重新打开），此时左侧垂直功能列中会出现一个 🤖 机器人图标，这就是 Claudian 面板的入口。

四、 通道一：配置 Claude Code 核心引擎与零成本白嫖 Ling 模型

Claude Code 是 Anthropic 官方推出的革命性终端协作代理，它能以你的 Obsidian 文件夹作为工作目录，执行高密度的跨文件读写。

Step 1: 全局安装 Claude Code CLI

打开你的终端（Windows 使用 PowerShell，Mac 使用 Terminal），运行以下命令：

npm install -g @anthropic-ai/claude-code

提示：安装可能需要 1~2 分钟，请耐心等待光标回到正常的 $ 或 > 提示符。

Step 2: 零成本白嫖 Ling-2.6-1T 模型配置（选做番外）

如果你有官方的 Claude Pro 订阅，在终端直接输入 claude 并根据提示授权登录即可。 如果你不想订阅、不想绑信用卡，可以使用 OpenRouter 上的免费模型 Ling-2.6-1T 来“蹬满”算力，完全不花一分钱跑通 Claude Code：

1. 获取 OpenRouter API Key：
   • 访问 openrouter.ai 用 Google 或邮箱注册账号。
   • 进入 openrouter.ai/keys 页面，点击「Create Key」，输入自定义名称（如 ObsidianAI），创建并完整复制生成的 sk-or-... 密钥（它只显示一次）。
2. 下载并安装 CC Switch： CC Switch 是管理本地 AI 命令行工具 API 提供商的跨平台可视化工具。
   • Mac 用户： brew tap farion1231/ccswitch brew install --cask cc-switch
   • Windows 用户：前往 GitHub cc-switch/releases 页面，下载 .msi 包并双击安装。
3. CC Switch 中配置 OpenRouter：
   • 打开 CC Switch 软件，顶部 tab 选「Claude 供应商」，点击「添加新供应商」。
   • 在预设列表中直接点击 OpenRouter（第二行靠右），名称和实际地址会自动填好。
   • 在 API Key 栏中，粘贴上面第 1 步在 OpenRouter 复制的 Key。
   • 【高能注意：最容易踩坑的 5 处模型映射】： 在底部的模型配置选项中，将以下 5 个字段全部填入相同的模型 ID：inclusionai/ling-2.6-1t:free。
     • 主模型
     • 推理模型 (Thinking)
     • Haiku 默认模型
     • Sonnet 默认模型
     • Opus 默认模型
     • 原因：CC Switch 需要将 Claude Code 的所有层级角色全部强制指向底层提供商的同一个免费 Ling 模型。漏填其中任意一个都会导致对应的功能调用崩溃。
   • 点击右下角「添加」。并在 CC Switch 主界面上，找到刚添加的 OpenRouter 提供商卡片，点击蓝色「▶ 启用」按钮。

Step 3: 获取 Claude 运行路径并填入 Obsidian

1. 在电脑终端运行：
   • Mac：where claude
   • Windows (PowerShell)：where.exe claude
   • （如果是 Linux 系统可使用 which claude）
2. 终端会返回一条路径，例如： /usr/local/bin/claude 或 C:\Users\YourName\AppData\Roaming\npm\claude
3. 复制这条完整路径。回到 Obsidian -> 打开设置 -> 选择 Claudian 插件 -> 顶部 Tab 切换到「Claude」。
4. 在「Claude CLI 路径」 (Claude CLI path) 输入框中，粘贴你刚复制的完整路径。
5. 回到 Obsidian 主界面，点击左侧侧边栏的 🤖 机器人图标，发一句“你好”。如果 AI 做出正常回复，则代表 Claude Code 通道完全打通！

五、 通道二：配置 Codex CLI 核心引擎与 ChatGPT 官方授权登录

Codex CLI 具有一个颠覆性的优势：它可以直接借助你现有的普通 ChatGPT 账号登录授权，完全不需要你申请和充值昂贵的 OpenAI API Key，彻底告别额度焦虑！

Step 1: 全局安装 Codex CLI

打开终端，运行命令：

npm install -g @openai/codex

（如果你安装了 OpenAI 的 Codex 桌面 App，也可以直接在 App 里对它说“帮我安装 codex cli”，系统会自动在后台静默跑完这条安装指令）

Step 2: 登录 ChatGPT 账号鉴权

在终端中运行：

codex login

终端会进入交互模式，使用上下方向键移动光标，选择 「Sign in with ChatGPT」 并回车。

• 系统会自动唤起你的默认浏览器并打开 ChatGPT 官方登录授权页面。
• 用你的 ChatGPT 账号完成常规登录。
• 登录成功后，浏览器会提示授权通过，终端将同步显示 Sign in successful。
• 此时按 Ctrl + C 即可退出 CLI 交互状态。

Step 3: 获取 Codex 路径并配置 Claudian

1. 在终端中运行获取路径命令：
   • Mac：where codex
   • Windows (PowerShell)：where.exe codex
2. 完整复制输出的路径（例如 /usr/local/bin/codex）。
3. 打开 Obsidian -> 设置 -> 选择 Claudian 插件 -> 顶部 Tab 切换到「Codex」。
4. 【核心避坑雷区：开启总闸】：
   • 首先，必须手动开启「Enable Codex provider」开关！ 这一步是所有全网简版教程中 99% 忽略的致命细节。如果该开关不开启，Codex 选项将永远不会出现在你的 Obsidian UI 切换菜单中。
   • 其次，在下方「Codex CLI path」字段中，粘贴刚才复制的 codex 路径。

六、 双模型丝滑切换：秒级神级协同

当以上两条通道全部配妥，并且重启了 Obsidian 之后，你的第二大脑正式进入了“双智能体”时代！

1. 打开 Obsidian 左侧的 🤖 Claudian 聊天窗口。
2. 留意聊天对话框的左下角，这里有一个原本单一模型的下拉菜单，现在已经变为了多维选择器。点开它会呈现以下分组：
   • CLAUDE 组：Opus / Sonnet / Haiku（实际底层全部由 CC Switch 调配，白嫖状态下全部走的是免费的 Ling 模型，不消耗任何付费额度）。
   • CODEX 组：GPT-5.4 / GPT-5.4 Mini 等。
3. 日常写作与大纲构思：左下角切到 CLAUDE (Sonnet/Opus)，让其进行逻辑极其严密的学术探讨与复杂长文构思。
4. 文件清洗、多文件批量重命名和周报汇总自动化：切到 CODEX 组，直接在对话框指挥它： “帮我扫描 01Grasp 目录下所有今日新增的文件，将它们重命名为统一的‘时间标题’格式，并提取摘要生成一封周报到 04_Publish 中。”

七、 “自生长系统”万能提示词 Skill 库

为了将大模型的强大能力固化在你的个人知识流中，你可以将以下提示词，以 Markdown 文件形式单独保存在 03_Skill 文件夹下，让本地 AI 随时调用并执行自动化任务。

7.1 Skill 1：Grasp（原料库）自动“编译归类”为 Arrange（双链概念卡片）

文件名建议：03_Skill/Grasp_to_Arrange_Skill.md

# 角色
你是由 Andrej Karpathy 亲身设计的“LLM Wiki 首席知识编译官”。你的唯一任务是清洗 `01_Grasp/` 文件夹中由人类随意收集的碎片化原料，将其深度消化后，“编译”成结构工整、自带双向网状链接的 Arrange 概念百科卡片。

# 任务
1. 全局读取 `01_Grasp/` 文件夹。
2. 提取出其中的：核心概念（定义/解释）、支撑案例（谁在什么时间做了什么事）、权威数据指标。
3. 将抽离出的概念转化为单篇概念笔记，保存至 `02_Arrange/`。
4. 严格执行以下排版格式，如果概念词在库中可能已存在，使用 [[双链语法]] 强制织网。

# 输出格式
---
category: ConceptCard
tags: [知识自生长, AI_Agent]
created: {{date}} {{time}}
---

# [[概念名称]]

## 💡 一句话定义
[用最通俗易懂但又不失严谨的语言，解释该概念的核心是什么。]

## 🛠️ 关键技术架构与原理
- **技术要点**：[列出 2-3 个支撑该概念的底层技术或逻辑]
- **关联路径**：本技术与 [[大语言模型]] 和 [[智能体工作流]] 具有紧密关联。

## 📊 支撑数据与真实案例
- **经典案例**：[提取原料中的案例，例如：卡帕西开源的本地知识库管理方法 LLM wiki 获得了 5k+ GitHub Star]
- **相关指标**：[列出具体的数据指标]

## 🔗 推荐关联盲区
- [根据内容，推荐 2 个知识库中你应该探索并建立连接的其他概念，格式：[[关联盲区笔记名]]]

7.2 Skill 2：全库无双链“孤儿笔记”深度扫描与语义重织网

文件名建议：03_Skill/Orphan_Network_Skill.md

# 角色
你是一个具备全知视角的“知识图谱织网师”。

# 任务
1. 系统扫描 `02_Arrange/` 文件夹中所有未与其他任何笔记产生 `[[双向链接]]`（反链和出链均为 0）的“孤儿笔记”。
2. 系统分析这些孤儿笔记的文本语义，找出可能产生关联的、已存在于库中的其他 Arrange 卡片。
3. 在孤儿笔记底部追加一个「🔗 语义重织网」标题，自动加上：
   - 关联推荐：`[[相关笔记名]]`。
   - 关联逻辑：用 1 句话深刻剖析两篇笔记底层的知识纽带，消灭你思维的盲区。
4. 扫描完成后，在控制台中为我输出一份“知识库健康度简报”，标明目前包含的概念群落及孤儿笔记消灭率。

通过这套精心配置的保姆级流程，您的 Obsidian 知识库将摆脱传统的死水状态，借助 Claude Code 与 Codex，开启属于您自己的自主思考、自生长的“第二大脑”！