尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

Claudian 完整指南:把 Obsidian 知识库变成 AI 编码工作目录

Claudian 完整指南:把 Obsidian 知识库变成 AI 编码工作目录 Claudian 完整指南把 Obsidian 知识库变成 AI 编码工作目录【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudianClaudian 是一款 Obsidian 插件把 Claude Code、Codex 等 AI 编码助手直接嵌进你的知识库。装好之后知识库就是 AI 的工作目录文件读写、搜索、bash 命令和多步工作流开箱即用。本文按接入、环境自检、日常操作、数据边界四个阶段带你跑通全流程。 接入三种安装方式任选其一跑通动手前先做需求核对三种方式通用已装好以下任意一个 CLIClaude Code、Codex、Grok Build、OpenCode 或 Pi有对应的订阅或 API 密钥官方订阅或 OpenRouter 等第三方提供商均可Obsidian 版本 v1.13.0仅支持桌面端macOS / Linux / Windows方式一社区插件商店推荐打开设置 → 社区插件 → 浏览搜索 Claudian点击安装回到插件列表启用方式二手动放置发布文件商店不可用或想锁定某个版本时走这条路从最新发布中取回main.js、manifest.json、styles.css三个文件在知识库内新建目录.obsidian/plugins/claudian/把三个文件丢进去重启 Obsidian设置 → 社区插件中启用 Claudian方式三源码构建面向开发cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian npm install npm run build构建产物就绪后照常启用插件即可开发期间用npm run dev可开启监听模式改动即时生效。 环境自检两类常见故障的排查路径现象CLI 检测失败spawn claude ENOENT现象聊天里一发消息就报spawn claude ENOENT或Claude CLI not found。原因Obsidian 是 GUI 应用看不到你终端里的 shell 环境用 nvm、fnm、volta 这类 Node 版本管理器装的 CLI 经常落在默认 PATH 之外。按这三步排查先把设置 → 高级 → Claude CLI 路径留空让 Claudian 自己尝试检测检测不到时用下表定位可执行文件平台定位命令典型产出macOS / Linuxwhich claude/Users/you/.volta/bin/claudeWindows原生安装where.exe claudeC:\Users\you\AppData\Local\Claude\claude.exeWindowsnpm 安装npm root -g{root}\anthropic-ai\claude-code\cli-wrapper.cjs把查到的路径填进 CLI 路径配置项保存后重试Windows 特别提醒别指向.cmd或.ps1包装器——原生安装填claude.exe包管理器安装填cli-wrapper.cjscli.js只是旧版 npm 包的遗留回退。替代方案在设置 → 环境 → 自定义变量里把你的 Node.js bin 目录写进 PATH。现象npm CLI 与 Node.js 分处两目录现象终端里 CLI 能跑Claudian 却报环境错误。原因npm 装的可执行文件和 node 运行时不在同一目录Obsidian 找不到 Node 运行时。两条命令确认路径归属dirname $(which claude) dirname $(which node)目录不一致时二选一处理改用原生二进制安装推荐在设置 → 环境中补一条PATH/path/to/node/bin让 Claudian 找得到 Node.js⚡ 操作五个核心动作从简单到进阶内联编辑一个热键词级差异选中一段文本或停在光标处按下快捷键AI 就地在笔记里改稿。确认前你会看到词级 diff改了什么一目了然满意再落盘。这是上手 Claudian 的第一动作。提及把对象拉进对话输入知识库文件、文件夹、子代理、MCP 服务器甚至外部目录里的文件都能被点名。AI 会先读取你提及的内容再动手回答直接对准目标省掉大段背景交代。斜杠命令与技能提示词模板不再重写输入/或$弹出列表里面是用户级和知识库级两个作用域的可复用提示模板与技能。想让某条自定义指令在当前会话持续生效用#指令模式添加即可。计划模式先出方案再动手ShiftTab切换开关。计划模式下AI 先探索现状、完成设计把完整方案交给你审批你点头之后才开始改文件——多文件、高风险的操作值得先过这一关。MCP 与多提供商工具箱向外延伸MCP 服务器通过 stdio、SSE、HTTP 三种方式接外部工具Claude 在应用内直接管理知识库 MCPCodex 走自家 CLI 配置。提供商侧目前已覆盖 Claude Code、Codex、Grok、OpenCode 和 Pi各平台与安装方式的适配仍在补齐冷门组合遇到 bug 直接提 issue。实现代码集中在 src/providers/想读源码可以从这里切入。 数据内容去向一张清单进入 API 的内容你的输入、附加文件、图片和工具调用输出。去向取决于所选提供商——默认 Claude 走 Anthropic、Codex 走 OpenAI其余由提供商设置与环境变量决定本地存储位置Claudian 的设置与会话元数据在vault/.claudian/Claude 提供商文件在vault/.claude/成绩单分别落在~/.claude/projects/Claude与~/.codex/sessions/Codex环境变量提供商子进程继承 Obsidian 进程环境加上你在 Claudian 里配置的变量CLI 认证、代理、证书与 PATH 解析全靠这一层设备标识每台设备的 CLI 路径绑定一个存在浏览器本地存储里的不透明本地密钥不使用系统主机名后台活动边界没有遥测信标UI 轮询只读本地编辑器选择状态网络请求只发生在明确发起的提供商工作、你配置的 MCP 端点、以及回答你所需的 SDK/CLI 调用三处收尾接入三步与环境自检两步走完剩下的就是快捷键的熟练度问题。功能细节以仓库内 README.md 为准参与改进前读一遍 CONTRIBUTING.md踩到 bug 或想提功能需求直接提交 issue 即可。【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表