四种方法将任意AI模型接入Obsidian知识库

引言：突破Claude Code的限制

上一期我们介绍了如何使用Claude Code配合Obsidian和Claudian插件搭建AI知识库，但很多读者反馈：没有Claude Code订阅怎么办？ 手头只有其他模型的API，或者使用的是Codex、Cursor等工具，能否也接入Obsidian？

答案是完全可以。本文将系统梳理四种方法，覆盖几乎所有主流AI模型和工具，让你的Obsidian知识库真正实现"模型自由"。

为什么Obsidian是AI集成的理想载体

Obsidian之所以能成为AI集成的理想载体，根本原因在于其"本地优先"的设计哲学。与Notion、语雀等云端笔记工具不同，Obsidian的所有数据都以纯文本Markdown文件的形式存储在本地文件系统中，没有私有数据库、没有加密格式、没有云端锁定。这意味着任何能读写文件的程序——无论是命令行工具、IDE还是API脚本——都可以直接操作知识库内容。Obsidian的Vault（知识库）本质上就是一个文件夹，其中的.md文件通过双向链接（[[]]语法）构成知识网络，而插件系统则通过Node.js运行时提供了几乎无限的扩展能力。正是这种开放的底层架构，为下面介绍的四种AI接入方式提供了可能。

CC Switch：兼容API一键接入Claude Code

核心思路

目前很多大模型都兼容OpenAI/Claude的API格式，因此最直接的方式就是通过CC Switch这个工具，将其他模型的API配置到Claude Code中，再利用Claudian插件完成知识库搭建。

这里需要理解一个重要的行业背景：当前AI领域存在一个事实标准——OpenAI的Chat Completions API格式。由于OpenAI最早定义了包含system/user/assistant角色的消息结构和流式响应协议，后来的大多数模型提供商（包括DeepSeek、智谱GLM、MiniMax、Kimi等）都选择兼容这一格式。这意味着只要一个工具支持配置自定义的API endpoint和密钥，理论上就能接入任何兼容OpenAI格式的模型。CC Switch正是利用了这一点，通过修改Claude Code的API指向，将请求转发到其他兼容服务。

操作步骤

1. 安装CC Switch：在GitHub搜索"CC Switch"，找到对应项目的Release页面。macOS用户下载DMG文件，Windows用户下载MSI安装包。
2. 添加供应商：安装完成后打开CC Switch，点击"添加"按钮，可以看到DeepSeek、智谱、Kimi、火山引擎等多个供应商选项。
3. 配置API Key：以火山引擎的方舟Coding Plan为例，一个API就能配置GLM 5.1、MiniMax、Kimi、DeepSeek等多种模型。在火山方舟控制台创建API Key后，复制到CC Switch的"豆包/Seed"配置项中即可。
4. 切换模型：在CC Switch中可以自由切换不同模型，比如将默认的豆包模型改为GLM 5.1。
5. 安装Claudian插件：配置完成后，在Claude Code中指定Obsidian Vault路径，让它自动安装Claudian插件。这样就能在Obsidian中使用任意兼容模型来管理知识库了。

火山引擎方舟平台：一个API Key打天下

这里值得展开介绍火山引擎的方舟平台。火山引擎是字节跳动旗下的云服务平台，其"方舟"（Ark）大模型服务平台提供了一个独特的模型聚合能力：用户通过单一API入口即可调用多家厂商的模型，包括豆包（字节自研）、DeepSeek、智谱GLM、MiniMax、Moonshot（Kimi）等。方舟Coding Plan是其面向开发者推出的编程场景套餐，通常提供较高的免费额度和优惠价格。这种"一个API Key打天下"的模式大幅降低了多模型切换的管理成本，用户无需分别在各家平台注册和充值。

适用场景

这种方法最适合国内用户，尤其是通过火山引擎等平台聚合了多个模型API的情况。一次配置，多模型可用，性价比极高。

Copilot插件：官方订阅用户的最佳选择

操作步骤

1. 在Obsidian左侧点击"设置" → "插件市场"，搜索Copilot并安装。
2. 启用插件后进入选项设置，可以看到Gemini、OpenAI、DeepSeek等多个模型的配置入口。
3. 以DeepSeek为例：将API Key填入对应位置，点击"Add Model"，选中模型后将其改为"DeepSeek Chat"。
4. 点击左侧的"Copilot Chat"即可开始对话。

注意事项

这种方法的前提是你拥有对应模型的官方订阅或API。对于海外模型（Gemini、OpenAI、Grok等），需要有官方账号；国内模型中，目前直接支持的主要是DeepSeek。

如果你已经是Gemini或OpenAI的付费用户，这种方式最为简洁直观，无需额外工具。

Terminal集成：命令行工具直接嵌入Obsidian

适用工具

如果你使用的是Codex、Gemini CLI、千问Code等命令行AI工具，且没有对应的API，可以通过在Obsidian中嵌入终端来实现集成。

命令行AI工具生态的崛起

2025年，命令行AI编程工具迎来了爆发期。除了Anthropic的Claude Code之外，OpenAI推出了Codex CLI（基于codex-mini模型的终端编程助手），Google发布了Gemini CLI（可直接在终端中调用Gemini 2.5 Pro），阿里巴巴则推出了千问Code（Qwen Code）。这些工具的共同特点是：直接在终端中运行，能够读取和修改本地文件，支持通过@符号引用上下文文件，并且通常提供比Web界面更高的操作效率。它们本质上是将大模型的能力下沉到了开发者最熟悉的命令行环境中。理解这一背景，就能明白为什么将终端嵌入Obsidian是一种自然而高效的集成方式。

操作步骤

1. 进入Obsidian设置 → 第三方插件市场，搜索Terminal并安装。
2. 安装后左侧会出现"Open Terminal"选项，选择"整合式"终端。
3. 如果偏好左右布局，可以将终端窗口拖拽到右侧，形成类似IDE的分屏效果。
4. 在终端中直接输入gemini、codex或其他命令行工具即可启动。

局限性

这种方式有一个小缺点：无法自动识别当前选中的文章。你需要手动使用@符号指定要操作的文件，例如输入@door_agent来引入某篇笔记作为上下文。

不过从本质上看，Obsidian中的所有文件都是独立的Markdown文件，这种方式相当于在知识库文件夹下直接运行AI命令行工具，功能上并无损失。你可以让AI总结文章、生成大纲、甚至直接创建新笔记。

直接在命令行中操作知识库文件夹

最朴素但最通用的方案

既然Obsidian的知识库本质上就是一个包含Markdown文件的文件夹，那么最简单的方式就是：

1. 打开终端，cd到Obsidian知识库所在的路径。
2. 启动Codex、Gemini CLI、Claude Code等任意命令行AI工具。
3. 使用@引用知识库中的文件进行读取、总结、编辑等操作。

这种方式同样适用于Cursor和VS Code——只需将知识库文件夹拖拽到编辑器中，就能利用其内置的AI功能来管理笔记。

Cursor和VS Code的AI集成逻辑

Cursor是一款基于VS Code深度定制的AI原生代码编辑器，内置了代码补全、对话式编辑、多文件重构等AI功能。由于Obsidian的知识库就是普通文件夹，将其作为项目在Cursor或VS Code中打开后，编辑器的AI功能可以直接作用于所有Markdown笔记。VS Code用户可以通过GitHub Copilot、Continue等扩展获得类似能力。这种方式的优势在于可以利用编辑器强大的文件管理、搜索和批量操作功能，配合AI实现知识库的大规模整理和重构——比如批量为数百篇笔记添加标签、生成摘要，或者重新组织文件夹结构。

实际演示效果

在命令行中使用Codex，可以让它总结某篇笔记的内容，也可以让它生成新文章。例如输入"帮我列一个大纲，标题是如何把Gemini CLI加入Obsidian"，Codex会直接输出Markdown格式的大纲，并在Obsidian左侧文件列表中生成对应的新文件。

四种方法对比总结

方法	核心工具	适用场景	难度
CC Switch	Claude Code + 兼容API	国内多模型用户	⭐⭐
Copilot插件	Obsidian原生插件	海外模型官方订阅用户	⭐
Terminal集成	命令行工具嵌入	Codex/Gemini CLI用户	⭐⭐
直接命令行	文件夹级操作	所有用户（含Cursor/VS Code）	⭐

理论上，这四种方式几乎可以覆盖所有AI大模型接入Obsidian的场景。无论你手头有什么模型资源，都能找到一条可行的路径，将AI能力注入到你的本地知识库管理流程中。

核心建议：如果你主要使用国内模型，优先考虑CC Switch + 火山引擎；如果你是Gemini/OpenAI订阅用户，Copilot插件最省事；如果你是命令行爱好者，Terminal集成和直接命令行操作提供了最大的灵活性。

核心要点

• 通过CC Switch工具可将DeepSeek、GLM、MiniMax等兼容API配置到Claude Code中，再结合Claudian插件管理Obsidian知识库
• Obsidian的Copilot插件原生支持Gemini、OpenAI、DeepSeek等模型的官方API接入，适合有海外订阅的用户
• 通过Terminal插件可将Codex、Gemini CLI等命令行AI工具直接嵌入Obsidian界面，但需手动指定操作文件
• Obsidian知识库本质是Markdown文件夹，可直接在命令行或Cursor/VS Code中用AI工具操作，是最通用的方案
• 四种方法互补，理论上可覆盖所有主流AI模型接入Obsidian的场景