最近发现 OpenCode 一直在加免费模型，而且是真的免费。刚好我平时又一直用 Obsidian 做知识库，写项目文档、整理资料、记录一些开发过程，基本都离不开它。

但 Claude Code 和 Codex 有时额度又不够用。

所以就在想，能不能把 OpenCode 的免费模型接到 Obsidian 里？这样就能不花一分钱，享受白嫖服务。

折腾完之后，确实能用。下面把过程整理一下。

第一步：安装 Claudian 插件

打开 Obsidian，点左下角齿轮进入「设置」，在左侧找到「第三方插件」，里面有一个「浏览」按钮。

点进去搜索 Claudian，安装就行。

安装好之后，先配置 OpenCode 的 cli path。

你可以把它理解成 OpenCode 的启动命令路径。

本地可以用这个命令找：

which opencode
/opt/homebrew/bin/opencode

然后打开「启用」按钮，把上面的路径填进去保存。

第二步：本地装好 OpenCode

OpenCode 本身也要先装好。

这部分我之前写过一篇更细的安装教程，基本是保姆级的，就不在这里重复展开了。

从 0 到 1 带你跑通 OpenCode，我整理的终极保姆教程来了

我把Claude+Codex装进了Obsidian，写文档这件事真香了

第三步：让 Claudian 显示免费模型

点 Obsidian 左侧边栏的「机器人」按钮，右侧会出现 Claudian 聊天框。

问题来了。

刚开始选择模型时，我这里只有一个默认模型：

opencode/big-pickle

一开始我还以为是 OpenCode 没把模型列表暴露出来。后来查了一下，原因不是这个。

Claudian 的模型下拉框并不是实时读取 OpenCode 的全部模型，而是读取它自己配置里的 visibleModels。

也就是说，如果这个数组里只有 Big Pickle，界面上当然也只能看到 Big Pickle。

配置文件在知识库根目录下面：

/Users/leeanrew/Documents/工作文档/.claudian/claudian-settings.json

找到 OpenCode 配置里的 visibleModels，可以手动加上这些免费模型：

"visibleModels": [
  "opencode/deepseek-v4-flash-free",
  "opencode/mimo-v2.5-free",
  "opencode/nemotron-3-ultra-free",
  "opencode/north-mini-code-free"
]

这里有个小提醒：

如果 Obsidian 正在运行，直接改 JSON 可能会被插件覆盖。稳一点的做法是先退出 Obsidian，再改 .claudian/claudian-settings.json。

手动改可以，但不太适合长期用

手动加模型能解决问题，但不够省心。

OpenCode 的模型列表会变。今天加几个，明天又新增几个。你每次都手动改 JSON，迟早会烦。

所以我后来写了一个同步脚本：

.claudian/sync-opencode-models.mjs

它做的事情很简单：

1. 读取 Claudian 的配置文件

2. 调用 opencode models opencode

3. 拿到所有 opencode/* 模型

4. 写回 claudian-settings.json 的 visibleModels

一开始我直接把所有模型都同步进去了。

结果下拉框里一下子出现一大堆模型，页面展示很乱，有些地方还不好上下滑动。能用是能用，但体验不太好。

后来我又加了一个配置文件：

.claudian/sync-opencode-models.config.json

内容大概是这样：

{
  "freeOnly": true,
  "preserveManualModels": false,
  "alwaysInclude": []
}

这里最关键的是 freeOnly。

它开启之后，脚本只会保留名字里带 free 的模型。这样 Claudian 的模型下拉框就不会被几十个模型塞满。

如果配置被重置，或者 OpenCode 后面新增了模型，可以手动重新跑一次：

node .claudian/sync-opencode-models.mjs

如果有些模型虽然不带 free，但你想一直保留，也可以放进 alwaysInclude：

{
  "freeOnly": true,
  "preserveManualModels": false,
  "alwaysInclude": ["opencode/glm-5.1"]
}

这样它会自动补进 visibleModels。

最后看一下效果

重新打开 Claudian 的聊天框，免费模型已经能正常显示了。

再随便发一条消息测试，模型也能正常跑通。

到这里，OpenCode 的免费模型就算接进 Obsidian 了。

我的使用场景也比较明确：写知识库、整理笔记、总结文档、改一些轻量内容，就优先用这些免费模型。真要做复杂代码任务，再切回更强的模型。

大家没有购买Codex、Claude Code或其他付费套餐，那这个免费白嫖就可以实操下用起来。

好了，就讲这么多。关注不迷路，我是「赛博李同学」。觉得有用就点个赞 + ⭐️ + 转发给需要的 TA，我们下期见！