[[0.index|回到目录]]
#Claudian #Obsidian #火山引擎 #教程 #报错
# 在 Obsidian 里免费"养"一个 AI 助手：Claudian 安装配置全教程（附火山套餐设置）
## Claudian 是什么
Claudian 是一款 Obsidian 插件，它把 **Claude Code、Codex 等编程 Agent 直接嵌入到了你的 Obsidian 笔记库里**。
装上它之后，你的整个笔记库（Vault）就变成了 AI 的工作目录。这意味着 AI 不再只是一个聊天框，而是一个能直接操作你笔记的"协作者"：
- **读写笔记**：直接在你的库里创建、修改 Markdown 文件
- **全局搜索**：在整个库里查找内容、建立笔记间的关联
- **执行命令**：支持 Bash 命令，可以完成多步骤的复杂工作流
- **侧边栏对话**：在 Obsidian 里以标签页的形式和 AI 多轮对话
一句话总结：**Claudian 让 Claude Code 这类 Agent 变成了你笔记库里的"住客"**，笔记即工作区。
## 为何要用 Claudian
**1. AI 直接操作笔记，省去复制粘贴**
普通 AI 聊天工具里，你要把笔记内容贴给 AI，再把结果贴回来。Claudian 里 AI 直接读写你的库，写周报、整理知识、批量改格式都是一句话的事。
**2. 笔记库就是上下文**
因为整个 Vault 是 Agent 的工作目录，AI 可以自己翻你的历史笔记作为背景资料，回答和写作都更"懂你"。
**3. 支持自定义 API 端点，国内可用低成本方案**
Claude 官方订阅门槛高（海外支付、价格贵）。Claudian 支持配置第三方兼容端点，比如**火山引擎方舟（Ark）的 Coding Plan / Agent Plan**——国内直接购买、按套餐计费，就能驱动 Claude Code 的完整 Agent 能力。
**适合谁：** 以 Obsidian 为知识管理主力工具，想让 AI 深度参与笔记整理与写作，同时希望用国内模型服务控制成本的用户。
## 如何安装 Claudian（以火山 Coding Plan 和 Agent Plan 为例）
### 前置准备
1. Obsidian（桌面端，该插件仅支持桌面版）
2. 火山引擎方舟平台开通 **Coding Plan** 或 **Agent Plan** 套餐
3. 在火山控制台获取 API Key（形如 `ark-xxxxxxxx-...`）
网址： https://console.volcengine.com/ark/region:cn-beijing/subscription/agent-plan
### 安装插件
### **重点：**
**环境变量：**
**agent plan:**
ANTHROPIC_AUTH_TOKEN=你的秘钥
ANTHROPIC_BASE_URL=https://ark.cn-beijing.volces.com/api/plan
ANTHROPIC_MODEL=glm-5.2
**coding plan**
ANTHROPIC_AUTH_TOKEN=你的秘钥
ANTHROPIC_BASE_URL=https://ark.cn-beijing.volces.com/api/coding
ANTHROPIC_MODEL=glm-5.2
以后想更换别的模型，只要把最后一行，换成别的模型，就可以了。
例如：ANTHROPIC_MODEL=kimi-k3
在obsidian里，模型就会变成：kimi-k3
安装后在设置中启用 Claudian，侧边栏会出现对话面板。
**技巧：** 用@文件名， 就可以切换别的文件。
## 小结
- Claudian = 把 Claude Code 等 Agent 嵌入 Obsidian 的插件，笔记库即 AI 工作区
- 配合火山方舟的 Coding Plan / Agent Plan，国内低成本使用完整 Agent 能力
- 配置只需三项：Token、Base URL、模型名；两个 Plan 仅 URL 结尾不同（`coding` vs `plan`）
## 常见报错
### 1.Obsidian Claudian 报错：invalid_request
#### 报错现象
Claudian 先出现：
`No conversation found with session ID: xxx`
更新插件后又出现：
`Error: invalid_request`
同时 Claude Code 测试时报：
`There's an issue with the selected model...`
#### 原因
Dell 电脑之前为了**测试安装过 Claude Code**。
虽然 Claude Code 后来卸载了，但遗留了配置目录：
`C:\Users\seven2024\.claude`
其中的 `settings.json` 保存了旧的模型和 API 配置，例如：
`ark-code-latest[1M]`
以及错误或不同的 Base URL。
这些 Claude Code 遗留配置与 Claudian 自己的配置发生冲突，导致 Claudian 请求异常。
#### 解决方法
1. 卸载不再使用的 Claude Code。
2. 删除遗留目录：
`C:\Users\seven2024\.claude`
3. 完全退出并重新打开 Obsidian。
4. Claudian 中只保留正确的火山 Agent Plan 配置：
`ANTHROPIC_AUTH_TOKEN=你的Key`
`ANTHROPIC_BASE_URL=https://ark.cn-beijing.volces.com/api/plan`
`ANTHROPIC_MODEL=kimi-k3`
5. 新建 Claudian 对话，不继续使用已经失效的旧 session。
#### 结论
遇到 Claudian 的 `invalid_request` 时，如果本机曾安装过 Claude Code，优先检查：
`C:\Users\用户名\.claude`
即使 Claude Code 已经卸载，旧配置仍可能影响 Claudian。
**本次问题最终通过删除 Claude Code 遗留的** `**.claude**` **配置目录解决。**
[[0.index|回到目录]]