你有没有这种感受：在Obsidian里写着写着，想让AI帮你改一段，于是你复制文字，切到浏览器，打开ChatGPT，粘贴进去，等回复，再复制结果，切回Obsidian，粘贴进来。

来回折腾四五步，思路全断了。

如果AI能直接住在Obsidian里，就在你的知识库旁边，选中哪段文字就改哪段，这个问题就解决了。

今天这篇文章，就来说怎么做到这件事——安装Claudian插件，以及如果你想用Codex，该走哪条路。

先说清楚：三个概念别搞混

在动手之前，有三个名词需要厘清，很多人在这里绕晕了：

Claudian：一个专为Claude Code设计的Obsidian插件。装上之后，Claude直接住在你的侧边栏里，能读取你当前的笔记内容，支持内联编辑和Skills功能。如果你主要用Claude，选这个。

Agent Client：另一款更通用的Obsidian插件，可以同时接入Claude Code、Codex、Gemini CLI等多种AI Agent。如果你想用多种AI，或者想用Codex，选这个。

Codex：OpenAI的AI编程Agent。注意——Codex没有专属的Obsidian插件，它需要通过Agent Client这个桥接插件才能在Obsidian里用。

总结成一句话：想用Claude就装Claudian，想用Codex就装Agent Client。如果两个都想用，装Agent Client就够了——它支持同时接入多种AI。

我有一个AI社群，里面有很多AI相关的亚马逊操作和AI 工具的使用实操，欢迎加入：

装Claudian：四步搞定

Claudian目前还没上架Obsidian社区插件商店，需要手动安装。步骤不复杂，跟着来就行。

前提检查：

• Obsidian版本 v1.8.9 或以上（桌面端，不支持手机）
• 已安装Claude Code CLI

第一步：下载插件文件

去Claudian的GitHub Releases页面，下载最新版本，你需要这三个文件：

• main.js
• manifest.json
• styles.css

第二步：创建插件目录

在你的Obsidian Vault文件夹里，找到隐藏文件夹.obsidian，在里面创建目录：

.obsidian/plugins/claudian/

注意：.obsidian是隐藏文件夹。macOS用Cmd+Shift+.显示隐藏文件，Windows在文件资源管理器里勾选“显示隐藏项目”。

第三步：把三个文件拷贝进去

把刚才下载的main.js、manifest.json、styles.css放到claudian文件夹里。

第四步：在Obsidian里启用

打开 Obsidian → 设置 → 社区插件，找到 Claudian，打开开关。如果列表里没看到，点一下右上角的刷新按钮，再试一次。

配置API Key

装好之后，去设置 → Claudian → Environment，填入你的API Key。

用官方Claude：

ANTHROPIC_API_KEY=你的Key

用国产模型省钱（Claudian只要求兼容Anthropic API格式，不限定必须用官方Claude）：

ANTHROPIC_API_KEY=你的Key ANTHROPIC_BASE_URL=https：//open.bigmodel.cn/api/anthropic ANTHROPIC_MODEL=glm-4.7

替换成智谱GLM或DeepSeek，Token成本能便宜到原来的十分之一左右。

Skills：真正的杀手锏

装好Claudian之后，最值得花时间研究的功能是Skills，这才是它和普通AI聊天工具的本质区别。

普通的AI工具是：你问，它答，你再复制结果去用。

Skills是：你在笔记里选中一段内容，用/调出命令，AI直接在原地把它改好——不是给你建议，是直接帮你改文档。

在Claudian的输入框里输入/，会弹出可用命令和已注册的Skills列表。你可以用它做的事包括：

重构一篇技术文章：让AI把你乱写的草稿整理成结构清晰的正式内容

拆解复杂概念：把一段难懂的内容拆成更小的知识点

零散笔记变系统知识：把你随手记的碎片整理成有逻辑的知识结构

说一个具体场景：你在Obsidian里记了一堆读书笔记，东一句西一句，没有结构。选中所有内容，用/调出“整理成知识卡片”的Skill，AI会直接把它们重写成一张张有标题、有重点的卡片，原地替换。以前这件事你要花二三十分钟，现在大概三十秒。

想用Codex？走这条路

如果你想在Obsidian里用OpenAI的Codex，需要走Agent Client这条路。

第一步：安装Codex CLI

在终端里执行：

npm install -g @openai/codex

第二步：安装Agent Client插件

Agent Client目前通过BRAT安装（已提交社区商店，等待审核）。BRAT是一个专门用来安装尚未上架社区商店的插件的工具，先装BRAT，再用它安装Agent Client。

第三步：在插件设置里选Codex

安装好Agent Client之后，进入插件设置，在Agent选项里选择Codex。之后在Obsidian侧边栏就能直接和Codex对话。

装好之后可以这样用：在对话框里输入@我的读书笔记，让Codex直接读取你Vault里的笔记内容，然后问它“根据这些笔记，帮我写一个代码实现这个想法”。Codex会直接读取笔记内容，写出对应的代码。

这对程序员来说尤其有用——你的设计文档和代码实现终于可以在同一个地方了。

最后说一件事

有个社区用户说了一句我觉得很准的话：“Obsidian正在从笔记工具变成自然语言IDE。”

以前Obsidian是你记下思考的地方。装上AI之后，它变成了AI可以参与进来、帮你打磨思考、直接改写内容的地方。

这不只是“方便了一点”，而是整个工作方式变了。你不再是一个人在知识库里写写画画，而是有个AI随时在旁边，你指哪它改哪。

Skills功能用熟了之后，你会发现那种感觉——就像有个助手坐在你旁边，你说一句话它就帮你做完了一件事——确实和以前完全不一样。

装起来试试吧，安装四步，用一次你就明白了。