Obsidian 打造 Cursor 级笔记智能体

AI智能摘要

文章类型为工具教程，核心目标是用本地化第三方模型在 Obsidian 中构建类似 Cursor 的笔记智能体。关键要点有三：一是底层由 Claude Code 提供文件读取与编辑能力，CC-Switch 用于把官方计费接口劫持到第三方模型（示例为 DeepSeek），Claudian 插件将功能带入 Obsidian 的图形界面；二是部署流程明确：安装 Node.js 与全局 Claude Code、通过浏览器授权、配置 CC-Switch 的 Provider/Base URL/API Key 并重启终端验证换源是否成功；三是将 Claudian 通过 BRAT 插件安装到 Obsidian 并启用后，可在侧边栏或命令面板唤醒智能体，使用时必须彻底重启 Obsidian 以读取最新环境变量，且配置 Base URL 时不可添加路径后缀。

— 此摘要由AI分析文章内容生成，仅供参考。

核心架构说明：

Claude Code：Anthropic 官方出的终端 AI 工具，负责底层的文件读取、代码/文本修改能力。
CC-Switch：换源神器，负责把官方的计费接口“劫持”到你自己的第三方 API（如 DeepSeek、千问等）。
Claudian：Obsidian 插件，负责把终端里的功能搬进笔记软件，提供友好的图形界面。

🛠️ 第一阶段：准备底层 AI 环境

1. 安装 Node.js

如果你电脑上还没有 Node.js，请前往 Node.js 官网下载并安装 LTS（长期支持版）。

2. 全局安装 Claude Code

打开终端（Mac 的 Terminal 或 Windows 的 CMD/PowerShell），执行以下命令：

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

等待进度条跑完，出现 added x packages 即为安装成功。

3. 首次运行与授权

在终端输入并回车：

claude

此时会自动弹出浏览器，引导你登录 Anthropic 账号并授权。（完成授权后终端会出现交互界面，输入 /exit 退出即可）。

🔀 第二阶段：配置第三方模型 (打破官方计费限制)

为了不消耗官方昂贵的额度，我们使用 CC-Switch 接入第三方模型（以 DeepSeek 为例）。

1. 配置 CC-Switch

打开你安装好的 CC-Switch 客户端（或命令行工具），进行如下配置：

Provider (提供商)：选择 DeepSeek（或你要用的其他中转 Claude）。
Base URL (接口地址)：填入第三方提供的基础地址。
- 例如 DeepSeek 填：https://api.deepseek.com
API Key (密钥)：填入你申请的 sk-xxxxxx。

2. 应用并重启终端

点击“应用/切换”后，彻底关闭当前终端窗口。重新打开一个终端，输入 claude，随便问它一个问题（如“你是谁”）。如果它回答“我是 DeepSeek”或者正常回答，说明换源成功！

📦 第三阶段：在 Obsidian 中安装 Claudian

因为 Claudian 是最新插件，还未上架官方市场，我们需要用 BRAT 插件来安装它。

1. 安装 BRAT 神器

打开 Obsidian 设置 (Cmd/Ctrl + ,)。
左侧点击 第三方插件 (Community plugins)，关闭安全模式。
点击“浏览”，搜索并安装 Obsidian42 - BRAT。
点击 启用 (Enable)。

2. 一键安装 Claudian

在 Obsidian 设置的左侧列表最下方，找到并点击 BRAT。
点击 Add Beta plugin（添加测试版插件）按钮。
在弹出的输入框中填入：
```
YishenTu/claudian
```
点击 Add Plugin。（右上角会提示下载成功）。

3. 启用即可

回到 第三方插件 列表。
找到刚装好的 Claudian，将右侧开关打开。

💡 第四阶段：如何使用与注意事项

🎉 恭喜！你的配置已全部完成。

如何唤醒你的专属 AI？

侧边栏：在 Obsidian 界面右侧的边栏，你会看到一个新的机器人/对话框图标，点击展开。
快捷键：按下 Cmd/Ctrl + P 呼出命令面板，输入 Claudian: Open chat 即可打开对话框。

⚠️ 核心避坑指南（必看）

重启生效法则：如果你在 CC-Switch 里修改了模型或 API，必须彻底退出并重新打开 Obsidian。因为 Obsidian 只有在启动时才会读取系统最新的环境变量，否则它还会用旧的配置。
Base URL 不要画蛇添足：配置第三方 API 时，链接千万不要带 /chat/completions 等后缀，只保留基础域名（如 https://api.xxx.com 或 https://api.xxx.com/v1）即可。
如何让它干活：你可以直接在 Claudian 里说：“帮我把今天新建的日记总结一下”，或者“帮我把文件夹 A 里所有的 MD 文件批量加上 YAML 格式的标签”。它会自动去读取并修改你的文件，体验非常惊艳！