本文采用全图文分步讲解，操作简单清晰，只需约 10 分钟即可完成双模型配置。

本文配置流程概览

一、前置环境准备

在开始配置之前，请确保已完成以下准备工作：

以下 1.1 和 1.2 小节专为不熟悉 Node.js 和终端操作的用户准备，有经验的开发者可直接跳转到第二节。

1.1 Node.js 安装指南（新手专用 · 资深用户可跳过）

Node.js 是后续执行 npm install 命令的必要环境。若未安装，执行命令时会出现 "command not found: npm" 错误。

Mac 系统：在终端执行 brew install node（若未安装 Homebrew，请先访问 brew.sh 完成安装）

Windows 系统：访问 nodejs.org 下载 LTS 版本的 Windows Installer (.msi) 安装包，双击运行安装程序，安装完成后请重启计算机。

验证安装是否成功

打开终端，依次执行以下命令：

若两个命令均能正常显示版本号（例如 v20.11.0、10.2.4），则表示安装成功。

1.2 终端使用入门（新手专用 · 资深用户可跳过）

Mac 系统：按下 ⌘ + 空格键 打开 Spotlight 搜索 → 输入 Terminal → 按回车键。显示的黑底白字窗口即为终端。

Windows 系统：按下 Win 键 → 输入 PowerShell → 按回车键。建议使用 PowerShell 而非传统的 CMD，其稳定性更佳。

二、Claudian 插件安装

由于 Claudian 尚未上架 Obsidian 官方插件市场，需要通过 BRAT 插件管理工具进行安装。

本章节分为两种场景，请根据实际情况选择。

🔄 已安装 Claudian 的用户：请先更新至最新版本

更新操作可在 BRAT 中一键完成：

打开 Obsidian 设置 → 左侧菜单滚动到底部，找到 BRAT 并点击 → 右侧滚动至「Beta plugin list」区域 → 找到 YishenTu/claudian 条目 → 点击右侧的 🔄 刷新图标（圆形箭头按钮），BRAT 将自动拉取最新版本并覆盖安装。

更新完成后请重启 Obsidian，然后直接跳转到第三节配置 Claude Code，无需阅读以下全新安装流程。

🆕 首次安装用户：Claudian 完整安装流程

以下为五步安装流程，每步均配有截图说明，请按顺序操作。

1打开 Obsidian 设置界面

启动 Obsidian，查看窗口左下角，找到齿轮图标 ⚙️ 并点击。弹出的面板即为设置界面。

2关闭「安全模式」

在设置面板左侧菜单中向下滚动 → 找到「第三方插件」选项并点击进入。

页面顶部即为「安全模式」选项，默认处于开启状态。启用安全模式时，Obsidian 禁止安装任何第三方插件。请点击右侧开关将其关闭，在弹出的确认对话框中点击确认。

关闭安全模式后，下方的「社区插件市场」将变为可用状态，右侧的「浏览」按钮即为插件市场入口。

3安装 BRAT 插件

点击「浏览」按钮进入插件市场。

在搜索框中输入 brat，第一个搜索结果即为目标插件。插件名称为 BRAT，作者为 TfTHacker，下载量超过 68 万，请确认信息无误后再进行安装。

点击进入插件详情页 → 点击右侧的「安装」按钮 → 安装完成后按钮将变为「启用」，请再次点击启用插件。

4通过 BRAT 添加 Claudian 插件

返回设置主页面，左侧菜单滚动至底部，在「第三方插件」分类下将显示所有已安装的插件列表，找到 BRAT 并点击进入。

❶ 在左侧菜单底部找到 BRAT 并点击进入
❷ 在右侧页面滚动至「Beta plugin list」区域，点击紫色按钮「Add beta plugin」

此时将弹出 "Github repository for beta plugin" 对话框，请继续按以下步骤操作。

❸ 在 Repository 输入框中完整粘贴以下地址：

❹ 点击紫色按钮「Add plugin」→ 等待数秒。屏幕将显示绿色提示信息，表示 Claudian 已自动安装并启用。

5验证 Claudian 已成功启用

返回「第三方插件」主页面（注意：是上方的总开关页面，而非下方分类中的 BRAT 设置），滚动至「已安装插件」区域，确认已安装的 Claudian 右侧开关处于点亮状态，即表示安装并启用成功。

Claudian 官方功能说明："将 Claude Code 作为 AI 协作工具嵌入您的知识库。您的知识库将成为 Claude 的工作目录，赋予其完整的智能体能力：文件读写、搜索、终端命令执行以及多步骤工作流。"

启用成功后，请查看 Obsidian最左侧的侧边栏（图标列），应会新增一个 🤖 机器人图标，这就是 Claudian 对话面板的入口。

至此，Claudian 插件框架已安装完成。但此时尚无法进行对话，因为还未配置 AI 模型引擎。

以下两节将分别讲解如何配置 Claude Code 和 Codex 通道。

三、通道配置一：Claude Code 设置

Claude Code 是 Anthropic 官方推出的命令行工具，作为 Claudian 运行 Claude（Sonnet / Opus）模型的底层引擎。

Step 1：安装 Claude Code 命令行工具

打开终端（若不清楚如何打开，请参考 1.2 小节），执行以下命令：

安装过程将持续一段时间，当光标重新回到 $ 提示符时即表示安装完成。

Step 2：Claude Code 登录与使用配置

根据您拥有的资源，Claude Code 的 AI 模型接入分为三种方式。请选择适合您的方案，Step 3、4、5 对所有方案均通用。

Step 3：获取 CLI 可执行文件路径

在终端执行：

命令将输出一行路径：

您的输出路径可能与示例不同，这是正常现象，请完整复制这一行路径，稍后需要粘贴到 Claudian 设置中。

Step 4：配置 Claudian 设置

返回 Obsidian → 点击左下角齿轮 ⚙️ 图标 → 左侧菜单滚动到底部找到 Claudian 并点击进入。

进入 Claudian 设置界面后，建议先将语言切换为中文，然后注意顶部有三个标签页：「通用」「Claude」「Codex」。请先切换到「Claude」标签页。

在「设置」区域的第一栏「Claude CLI 路径」中，将 Step 3 中复制的路径完整粘贴进去。

页面下方还有「安全」「模型」「命令与技能」等区域，全部保持默认设置即可。以下选项仅针对特定用户需要调整：

• 「加载用户 Claude 设置」：已在终端配置过 ~/.claude/settings.json 的用户可开启
• 「模型」区域：Max / Team / Enterprise 套餐用户可根据需要调整 1M 上下文或自定义模型，普通用户请全部忽略

Step 5：★ 功能验证

返回 Obsidian 主界面 → 点击左侧 🤖 图标打开 Claudian 主面板 → 发送测试消息如「你好」。

若收到 AI 回复，则表示 Claude Code 通道配置成功。

番外：零成本方案 — 使用免费 Ling 模型运行 Claude Code

完成主流程配置后，Claude Code 默认将根据您的 Claude / Anthropic 订阅进行计费。若您希望先零成本试用，或预算有限、暂时未订阅服务，可选择此方案：通过 OpenRouter 平台的免费模型 Ling-2.6-1T，配合 CC Switch 工具一键切换 API 提供商。Claude Code 本身保持不变，底层使用的是免费的 Token 额度。

Step 1：在 OpenRouter 获取 API Key

访问 openrouter.ai → 使用 Google 账号或邮箱注册 → 进入 openrouter.ai/keys 页面 → 点击「Create Key」。

在弹出的对话框中，仅需填写 Name 字段（可任意命名，例如 Obsidian Use Key，便于后续识别），下方的 Credit limit、Reset limit every、Expiration 等选项全部保持默认即可。点击「Create」→ 完整复制生成的 API Key。

Step 2：查找免费模型 Ling-2.6-1T 并复制模型 ID

❶ 在 OpenRouter 顶部菜单进入 Models 页面
❷ 在搜索框输入 ling
❸ 第一个搜索结果即为 inclusionAI: Ling-2.6-1T (free)（标记为 Free，输入输出均不计费）
❹ 点击模型名称右侧的复制图标，复制得到的模型 ID 为：

Step 3：安装 CC Switch

Mac 系统：在终端依次执行以下命令：

Windows 系统：访问 CC Switch Releases 下载 .msi 安装包，双击运行安装。

Step 4：在 CC Switch 中添加 OpenRouter 提供商

打开 CC Switch → 顶部标签页选择「Claude 供应商」→ 点击「添加新供应商」（CC Switch 内置 50+ 提供商预设）。

❶ 在预设列表中选择 OpenRouter（位于第二行靠右位置），选择后上方的「供应商名称」和「实际地址」（https://openrouter.ai）将自动填充，无需手动修改。

❷ 在 API Key 字段 → 粘贴上一步复制的 OpenRouter Key。

❸ 将模型名称 inclusionai/ling-2.6-1t:free 填入以下 5 个字段中（每个字段均填入相同的模型名称）：

• 主模型
• 推理模型 (Thinking)
• Haiku 默认模型
• Sonnet 默认模型
• Opus 默认模型

❹ 点击右下角的蓝色「添加」按钮。

Step 5：启用 OpenRouter 提供商

返回 CC Switch 主界面，在刚添加的 OpenRouter 提供商卡片右侧，有蓝色的「▶ 启用」按钮，请点击启用。

Step 6：★ 零成本方案验证

返回 Claudian 主面板 → 选择 Claude 组的任意模型（Opus / Sonnet / Haiku 均可，实际底层都将调用 Ling 模型）→ 发送测试消息如「你好」。

若收到 AI 回复，则表示零成本通道配置成功。此时您正在使用的是 Ling-2.6-1T 模型，完全不会产生任何费用。

四、通道配置二：Codex 设置（本文核心内容）

无论您选择的是官方订阅的主线路，还是零成本的番外方案，至此 Claude Code 应已可正常使用。若您仅需使用 Claude 模型，配置工作可到此结束。

但 Claudian 还支持另一种强大的配置方式：额外添加一条 Codex 通道，实现两个模型的随时切换。这部分功能在官方 README 中几乎没有说明，网上也难以找到完整的配置教程。以下为经过实际验证可成功运行的完整流程。

Step 1：安装 Codex 命令行工具

在终端执行：

Step 2：通过 ChatGPT 进行登录授权

与上一节流程相同，请先完成 CLI 登录再配置 Claudian。在终端执行：

进入交互界面后，选择「Sign in with ChatGPT」。

系统将自动打开浏览器 → 使用您的 ChatGPT 账号登录 → 完成授权 → 跳转回终端，看到 "Sign in successful" 提示即表示登录成功。

Step 3：获取 Codex CLI 可执行文件路径

在终端执行：

命令将输出一行路径：

示例路径为 /Users/rongshi/.local/bin/codex，与 Claude 类似，您看到的具体路径可能不同，这是正常现象，完整复制该路径即可。

Step 4：配置 Claudian Codex 设置（关键步骤）

返回 Obsidian → 进入 Claudian 设置界面 → 顶部标签页切换到「Codex」。

此步骤必须完成以下两个操作，缺少任意一个，Codex 都不会出现在模型切换菜单中：

❶ 打开「Enable Codex provider」开关

❷ 在「Codex CLI path」字段，将 Step 3 中复制的 codex 路径完整粘贴进去。

Step 5：★ Codex 通道验证

返回 Claudian 主面板 → 切换到 Codex 模型 → 发送测试消息如「你好」。

若收到 AI 回复，则表示Codex 通道配置成功。

五、双模型切换：左下角一键选择

两条通道均配置完成后，切换入口位于 Claudian 对话框左下角的模型选择器。点击将弹出下拉菜单，其中分为两组：

• CLAUDE 组：Opus / Sonnet / Haiku
• CODEX 组：GPT-5.5 / GPT-5.4 Mini