Obsidian Codex Setup

功能介绍

帮助你在 Obsidian 中配置和使用 Codex，让 Codex 能够安全地读取、搜索、总结和修改本地 Vault。Skill 会优先采用最小可用方案，并根据实际错误信息定位连接、路径、模型和权限问题。

主要能力

• 配置 Local REST API with MCP，连接 Codex 与 Obsidian Vault
• 配置和排查 Codex Panel 侧边栏聊天
• 解决 Windows 下 codex、codex.cmd 与原生 codex.exe 路径问题
• 排查 ENOENT、app-server 启动失败和连接失败
• 处理模型名称、模型权限和 reasoning effort 不兼容问题
• 验证 Codex 是否能够读取当前 Vault
• 以只读测试作为第一步，降低误修改和数据丢失风险
• 保护 API Key、Bearer Token 和插件敏感配置
• 区分核心 MCP 连接与可选的 Obsidian 聊天界面

适用场景

• 第一次在 Obsidian 中配置 Codex
• Codex Panel 显示 connect failed
• Windows 下提示找不到 codex
• Codex 提示模型不支持或参数无效
• 想确认 Codex 是否能读取当前 Vault
• 想让 Codex 在 Obsidian 中总结、整理或修改笔记

工作方式

Skill 会先检查当前环境和配置，再判断问题属于：

1. Codex CLI 本身
2. Codex Panel 可执行文件路径
3. 模型和推理强度配置
4. Obsidian MCP 连接
5. 权限或敏感配置问题

完成连接后，会优先使用只读请求验证，例如：

请列出当前 Vault 根目录，不要修改任何内容。

只有只读测试成功后，才建议进行笔记编辑或批量操作。

安全说明

本 Skill 不会在聊天中展示 API Key、Bearer Token 或插件敏感配置；不会直接修改加密的插件 data.json；修改 Codex 配置前会保留原有设置，并建议先备份。

使用示例

• “帮我在 Obsidian 里配置 Codex。”
• “Codex Panel 显示 connect failed。”
• “Windows 找不到 codex executable。”
• “帮我测试 Codex 能不能读取这个 Vault。”
• “这个模型的 reasoning effort 报错，帮我修复。”