第3章：Claudian 与 AI 工作流

本章结构：先理解 Claudian 和普通 AI 聊天的本质区别 → 再一步步安装、配置 DeepSeek 后端 → 最后用自检和练习把它融入日常。
预计时间：概念 15 分钟 + 安装配置 30 分钟

1. Claudian 是什么

Claudian 是 Obsidian 社区插件，它将 Claude Code（Anthropic 的终端 AI 代理）嵌入到 Obsidian 侧边栏中运行。

要理解 Claudian 的价值，先看看你用普通 AI 聊天工具的典型流程：打开网页 → 打字提问 → 复制答案 → 切回 Obsidian → 粘贴到笔记。这个流程里，AI 和你本地文件之间始终隔着一层——它看不到你的笔记，得靠你手动搬运。

Claudian 把这一层去掉了。它把整个 vault 作为 AI 的工作目录，AI 可以直接读你的笔记、搜索你的文件、修改你的内容——不再需要复制粘贴这个中间步骤。

你可以把它理解成：AI 以你的 vault 为工作目录，而不是一个独立的聊天窗口。它操作的是 Books/、Notes/ 里真实的 .md 文件。

flowchart LR
  U[你] --> CL[Claudian 侧边栏]
  CL --> CLI[Claude Code CLI]
  CLI --> V[vault 文件]
  V -->|Remotely Save| M[手机只读]

2. 核心功能

3. 不能做什么（边界）

4. 在本系列中的角色

插件的安装顺序是经过考虑的：Remotely Save 先就绪，确保所有改动可以同步到其他设备；然后才是 Claudian，在桌面上读、写 vault。

典型的一天：

1. 地铁上（手机）：Sync → Dataview 看待读 → Navigator 打开在读的书
2. 回家（桌面）：Douban 加书 → Claudian 写笔记草稿 / 整理摘录
3. 睡前 Sync → 手机端继续阅读

flowchart LR
  subgraph desktop [桌面]
    A[Douban 导入] --> B[Templater 模板]
    B --> C[Claudian 写改]
  end
  subgraph mobile [手机]
    D[Navigator 浏览]
    E[Dataview 书单]
  end
  C -->|Remotely Save| D
  C -->|Remotely Save| E

5. 安装与配置（DeepSeek 后端）

Claudian 默认连接 Anthropic 的 Claude 服务，但那需要订阅。另一个选择是使用 DeepSeek 作为后端——它的 API 兼容 Anthropic 协议，但按量计费，成本低得多。本节完整走一遍从安装到验证的流程，全程约 20 分钟。

5.1 前置准备

开始之前，确认以下几点：

5.2 安装 Claudian 插件

1. Obsidian 左下角 设置 ⚙️ → 社区插件 → 关闭限制模式（如果还没关）
2. 点击 浏览，搜索 "Claudian"（作者：realclaudian）
3. 点击 安装 → 安装完成后点 启用
4. 启用后 Obsidian 右侧会出现 Claudian 面板

如果社区插件市场加载缓慢，可以手动从 Claudian GitHub Releases 下载插件包，解压到 vault 的 .obsidian/plugins/ 目录下。

5.3 获取 DeepSeek API Key

1. 访问 DeepSeek 开放平台，注册或登录账号
2. 进入 API Keys 页面
3. 点击 Create API Key，创建一个新密钥
4. 复制生成的密钥（以 sk- 开头），保存到安全的地方

⚠️ API Key 相当于密码。不要分享给他人，不要提交到公开的 Git 仓库。如果怀疑泄露，回到 DeepSeek 平台吊销并重新生成。

5.4 配置环境变量

Claudian 通过环境变量来指定自定义 API 端点。这是整个配置中最关键的一步。

1. 打开 Obsidian 设置 → Claudian，找到 Shared Environment Variables 字段
2. 填入以下内容（将 sk-你的Key 替换为你上一步获取的密钥）：

ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
ANTHROPIC_API_KEY=sk-你的Key
ANTHROPIC_AUTH_TOKEN=sk-你的Key
ANTHROPIC_MODEL=deepseek-v4-pro
ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash

变量说明

5.5 选择 Provider 与模型

环境变量配置完成后，还需要设置 Claudian 的 Provider。这一步容易困惑，因为 DeepSeek 本身不在下拉列表里——它兼容的是 Anthropic 的 API 协议，所以要选 Claude。

1. 进入 Claudian 设置页面（设置 → Claudian → 点击齿轮图标 ⚙️）
2. Provider 下拉选择 → 选 Claude
   • 原因：DeepSeek 对外暴露的是兼容 Anthropic（Claude）协议的 API。选 Claude 后，Claudian 走 Anthropic 协议和 DeepSeek 服务器通信。
3. Model 输入框 → 手动填入 claude-code/deepseek-v4-flash 或 claude-code/deepseek-v4-pro
4. Permission Mode → 建议设为 yolo（自动放行，效率最高）
   • 如果对安全性要求更高，可以选 acceptEdits——每次文件修改时手动确认

模型选择建议

推荐的搭配方式：日常使用 Flash，遇到复杂任务时切换到 Pro。

5.6 验证连接

配置完成后，验证是否一切正常：

1. 回到 Obsidian，打开任意一篇 .md 文件
2. 点击右侧 Claudian 面板的聊天输入框
3. 发送一条简单指令，例如：用中文简单介绍一下你自己
4. 如果返回正常结果，说明配置成功

如果收到网络错误或认证失败的提示，直接跳到下方的 #常见问题与故障排查 部分。

6. 跟着做：5 分钟自检

完成配置后，逐项确认：

• Claudian 插件已启用（社区插件列表中开关为 ON）
• 终端执行 claude --version 有版本号输出
• 环境变量已正确填写（设置 → Claudian → Shared Environment Variables）
• Provider 已设为 Claude，Model 已填入 DeepSeek 模型名
• 侧边栏发送测试消息有正常回复

任一项失败，回到对应小节的步骤重新检查。

7. 适合交给 Claudian 的事

练习（建议完成第 4 章 Templater 后再做）

1. 在 Claudian 面板输入 @Tools/Templater/Books.md 然后问：multi_suggester 和 on_all_templates_executed 分别起什么作用
2. 让 Claudian 生成一个 Dataview 待读 LIST 查询块，贴到你的笔记里预览

8. 配置与安全

安全提示：DeepSeek API Key 写在环境变量中，不要提交到公开的 Git 仓库。在让 Claudian 执行批量修改前，先用 Remotely Save 进行一次同步作为备份。

常见问题与故障排查

认证失败（401 Unauthorized）

• 检查 ANTHROPIC_API_KEY 是否完整正确地复制（注意不要有多余空格）
• 确认 DeepSeek API Key 未过期
• 登录 DeepSeek 平台检查账户余额是否充足

网络错误或超时

• 确认你的网络能访问 api.deepseek.com——可以在浏览器中直接访问该地址测试连通性
• 部分企业网络或校园网可能需要配置代理
• 检查 ANTHROPIC_BASE_URL 末尾没有多余的空格或换行

模型返回乱码或英文

• 在聊天中补充指令「请用中文回复」
• 确认环境变量的格式无误，尤其是等号前后不要有空格

插件面板不显示或无法启动

• 尝试重启 Obsidian
• 在社区插件页面禁用 Claudian 后重新启用
• 如果仍然不行，在操作系统终端执行 claude --version 确认 Claude Code CLI 已正确安装

API 被限流（Rate Limit）

• DeepSeek 免费额度有速率限制，短时间内大量请求可能被限流
• 适当降低请求频率，或升级 DeepSeek 的付费套餐

本章练习

• 完成 DeepSeek 后端配置，侧边栏发送消息并得到回复
• 尝试修改 ANTHROPIC_MODEL 从 pro 切换到 flash，感受速度差异
• 完整走一遍练习：用 @ 引用一个模板文件，问一个关于该模板的问题
• 理解 yolo 和 acceptEdits 两种权限模式的区别，按自己的需求设置