Agent Skills
返回列表
Claudian 本地 Codex 与 Ollama 配置

Claudian 本地 Codex 与 Ollama 配置

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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、不装 claude CLI,一定要把默认 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 报错,需要按真实配置文件与重启流程对照的现场支持人员