Claudian 本地 Codex 与 Ollama 配置
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c9dc716e/obsidian-claudian-codex-ollama。
技能介绍
要解决什么问题
你在 Obsidian 里用 BRAT 装的 realclaudian(Claudian),希望对话框走 Codex CLI,再由 Codex 调用本机 Ollama 做推理,而不是云端默认 provider。常见卡点有三类:对话框根本打不开;能开但没有本地模型可选;或一发送就被 Codex 以「非受信目录」拦下。更隐蔽的是——很多人改 plugins/realclaudian/data.json,而 provider 实际读的是 vault 根目录的 .claudian/claudian-settings.json,data.json 只管标签页布局,改错文件等于白改。
技能如何帮你理清链路
技能把目标链路写死为:Obsidian Claudian → Codex → Ollama(http://127.0.0.1:11434/v1)。核心动作包括:
- 在
~/.codex/config.toml里确认model_provider指向 Ollama,并给 vault 路径配置trust_level = "trusted"(Claudian 调 Codex 不会带--skip-git-repo-check,vault 须是受信 git 仓库)。 - 从 Ollama 列出对话模型(排除纯嵌入模型),写入
providerConfigs.codex.customModels(换行分隔字符串,模型名含冒号如gemma4:12b原样保留)。 - 启用
providerConfigs.codex,设置cliPath、settingsProvider: "codex"(未装 Claude CLI 时必切,否则默认 claude 起不来)、以及默认模型与 permission 等字段;改前备份,改后用json.load校验。 - 文档还提供
scripts/configure.py可自动化步骤 2–4,并给出「对话框打不开 / 无模型 / trusted directory / model provider 错 / 配置不生效」的排查清单。
适用边界与注意点
- 必须完全退出 Obsidian(如 macOS Cmd+Q)再开,光关窗口不重新读配置。
- 界面里 Discover 对 Ollama 本地模型无效,只能靠
customModels手填。 - 若只想用 Codex、不装
claudeCLI,一定要把默认 provider 设为 codex,这是对话框打不开的头号原因之一。
本技能是配置与排错手册,不包含 Obsidian/Codex/Ollama 的安装教程本身。
使用场景
- 已在 vault 里装好 Claudian,要在聊天里选本机 Ollama 模型而不是默认云端 provider
- Claudian 点开会话就报错或空白,Console 显示默认 claude provider 起不来,需要切到已安装的 Codex
- 在笔记库里 @ 或对话调用 Codex 时出现 not a trusted directory,需要给 vault 配 git 与 Codex 信任项
- 改过 realclaudian 插件目录 data.json 仍无模型列表,需要改对 `.claudian/claudian-settings.json` 里的 customModels
适合人员
- 用 Obsidian 写技术笔记、希望在侧栏 Claudian 里走本机推理、不愿把 vault 内容发到云 API 的研究者
- 已通过 Homebrew 等装好 Codex CLI 和 Ollama,要把二者接到 BRAT 版 realclaudian 的工程师
- 维护多人共享 vault 或自动化脚本,需要一次性 git init、信任目录与 Claudian provider 字段的运营/管理员
- 排查 Claudian「对话框打不开」与 Codex model provider 报错,需要按真实配置文件与重启流程对照的现场支持人员