1. 为什么要在 Obsidian 里接 Claude Code 和 Skills如果你平时把笔记、项目文档、灵感碎片都放在 Obsidian 里大概率会遇到一个尴尬想根据一篇 Markdown 笔记自动生成结构图、流程图或者让 AI 帮你补全内容结果得先把笔记复制出来切到浏览器或终端处理完再粘回去。来回折腾几次思路就断了。Claude Code 本身是一个能在终端里读写文件、执行命令的编码助手而 Skills 是它的一套可扩展能力机制——你可以把它理解成给 Claude Code 装上的“插件包”每个 Skill 定义了一类任务的处理方式比如把 Markdown 转成 Canvas、生成 Bases 视图、按特定格式整理笔记。把这两样东西塞进 Obsidian意味着你可以在笔记库内部直接调用 AI不用离开当前工作区。这套配置适合谁三类人比较典型一是笔记库里已经积累了大量 Markdown想批量做结构化整理的人二是习惯用 Obsidian 做项目管理、需要频繁生成图表的人三是想在自己本地知识库里跑 AI 能力、又不想把数据到处搬的人。我试过把这套骨架搭起来之后最直观的感受是“少切窗口”这件事对专注度的帮助比想象中大。下面从环境准备开始一步步给出可复制的配置。核心思路是先用 TaoToken 拿到可用的 API 凭证再配好 Claude Code 的 settings.json最后装 Claudian 插件并让 Skills 能被正确加载。2. 前置准备TaoToken 凭证与 Claude Code 环境Claude Code 默认走 Anthropic 官方接口但实际使用时很多人会通过兼容 Anthropic 协议的服务来调用不同模型。TaoToken 提供的就是这样一个入口它的 API 地址是https://taotoken.net/api兼容 Anthropic 的消息格式所以 Claude Code 可以直接对接。你需要先拿到一个 API Key。登录 TaoToken 控制台后在 API Keys 页面创建一个新 Key复制保存好——这个 Key 只会完整显示一次。如果你还没注册可以从官网入口进https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注册后在控制台左侧找到 API Keys 菜单即可创建。拿到 Key 之后确认本地已经装了 Node.js建议 18 以上和 Claude Code CLI。Claude Code 的安装方式通常是全局 npm 包装完后可以用claude --version验证。如果你用的是 WindowsCLI 的入口文件路径一般长这样D:\nodejs\anthropic-ai\claude-code\cli.js这个路径后面配置 Claudian 插件时会用到先记下来。这里有个容易踩的坑Claude Code 读取的是环境变量而不是某个配置文件里的字段。所以你需要把ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL这三个变量设好。可以写在系统环境变量里也可以写在 Claude Code 的 settings.json 中。两种方式下面都会给。3. 可复制配置settings.json 与 Claudian 插件骨架3.1 Claude Code 的 settings.jsonClaude Code 的配置文件一般放在用户目录下的.claude/settings.json。如果你想让 Obsidian 仓库独立使用一套配置也可以放在仓库根目录的.claude/settings.json。内容骨架如下{ env: { ANTHROPIC_AUTH_TOKEN: 你的TaoToken API Key, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Read, Write, Bash(git:*) ] } }几个字段说明一下。ANTHROPIC_AUTH_TOKEN填你在 TaoToken 控制台创建的 KeyANTHROPIC_BASE_URL固定填https://taotoken.net/api注意不要多加斜杠或路径ANTHROPIC_MODEL填你想用的模型名具体可用模型可以在 TaoToken 的模型列表页查看也可以先用默认的 Claude 系列模型跑通流程。permissions.allow是 Claude Code 的工具权限白名单先放开 Read 和 Write方便它读写笔记文件。注意settings.json 里的 Key 是明文存储的。如果这个仓库会同步到公开平台建议改用系统环境变量注入或者把.claude目录加入.gitignore。3.2 安装 Claudian 插件Claudian 是 Obsidian 的一个社区插件作用是在 Obsidian 侧边栏提供一个对话框直接和 Claude Code 交互。安装方式有两种一种是从 Obsidian 社区插件市场搜索安装另一种是手动下载三个文件放进插件目录。手动安装的步骤是进入你的 Obsidian 仓库根目录找到.obsidian/plugins文件夹在里面新建一个claudian目录然后把下载到的main.js、manifest.json、styles.css三个文件拷贝进去。回到 Obsidian在“设置 → 第三方插件”里刷新已安装插件列表找到 Claudian 并启用。启用后进入 Claudian 的设置页需要填两个关键项。一个是 Claude CLI 路径Windows 下类似D:\nodejs\anthropic-ai\claude-code\cli.jsmacOS 或 Linux 下一般是全局 npm 的 bin 路径可以用which claude查。另一个是环境变量如果你没有在 settings.json 里写就在这里填ANTHROPIC_AUTH_TOKEN你的TaoToken API Key ANTHROPIC_BASE_URLhttps://taotoken.net/api ANTHROPIC_MODELclaude-sonnet-4-20250514填完后保存Claudian 会在下次打开对话框时读取这些配置。3.3 配置仓库级 Skills 目录Skills 的加载依赖一个约定目录仓库根目录下的.claude/skills。你需要手动创建这个目录然后把下载到的 skill 包整个拷贝进去。常见的几个 skill 包括json-canvas、obsidian-bases、obsidian-markdown分别对应 Canvas 结构图生成、Bases 视图生成和 Markdown 格式处理。目录结构大概是这样你的仓库/ ├── .claude/ │ ├── settings.json │ └── skills/ │ ├── json-canvas/ │ │ └── SKILL.md │ ├── obsidian-bases/ │ │ └── SKILL.md │ └── obsidian-markdown/ │ └── SKILL.md ├── .obsidian/ │ └── plugins/ │ └── claudian/ └── 你的笔记.md每个 skill 目录里必须有一个SKILL.md文件Claude Code 靠它识别这个 skill 的名称、触发条件和执行逻辑。你也可以自己写 skill只要遵循同样的目录约定和文件格式放进.claude/skills就能被识别。4. 验证请求确认 Skills 能被加载与触发配置写完不代表生效得实际跑一遍。验证分两步先确认 Claude Code 能通再确认 Skills 能被触发。第一步在终端里进入你的 Obsidian 仓库根目录执行claude -p 列出当前目录下 .claude/skills 里有哪些 skill如果配置正确Claude Code 会读取.claude/skills目录并返回 skill 列表。如果报认证错误检查ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL是否写对如果报模型不存在检查ANTHROPIC_MODEL的拼写。第二步在 Obsidian 里点击左侧 Claudian 图标打开对话框输入一个会触发 skill 的指令比如把当前打开的 Markdown 笔记转换成 Canvas 结构图如果json-canvasskill 被正确加载Claudian 会调用它并生成一个.canvas文件。你可以在文件列表里看到新生成的 Canvas 文件打开后应该能看到节点和连线。如果对话框返回的是普通文本而不是生成文件说明 skill 没有被触发大概率是.claude/skills目录位置不对或者SKILL.md文件缺失。实测下来最容易出问题的是路径。Claudian 插件读取的是仓库根目录而不是你当前打开的笔记所在目录。所以.claude必须放在仓库最外层不能放在某个子文件夹里。5. 本篇常见错排查报错一Claudian 对话框提示“Claude CLI not found”。这是 CLI 路径没配对。Windows 下确认路径指向cli.js文件而不是目录macOS 下用which claude拿到真实路径填进去。如果 CLI 是通过 nvm 安装的路径可能带版本号注意别填错。报错二请求返回 401 或 authentication failed。检查ANTHROPIC_AUTH_TOKEN是否复制完整有没有多余空格。TaoToken 的 Key 一般以固定前缀开头如果复制时漏了字符会直接认证失败。另外确认ANTHROPIC_BASE_URL填的是https://taotoken.net/api不要写成带/v1的地址。报错三skill 不触发AI 直接返回文本。先确认.claude/skills目录在仓库根目录再确认每个 skill 子目录里有SKILL.md。如果都对了还不触发可以在对话框里显式点名比如“使用 json-canvas skill 把这篇笔记转成 Canvas”看是否能强制触发。能强制触发说明 skill 加载正常只是自然语言匹配没命中。报错四生成的 Canvas 文件为空或格式错误。这通常是 skill 版本和 Obsidian 版本不匹配。检查你下载的 skill 是否是最新版必要时重新拷贝覆盖。另外确认笔记本身是标准 Markdown如果里面有大量自定义语法skill 解析时可能出错。报错五Obsidian 重启后 Claudian 配置丢失。这种情况一般是因为插件设置没有正确写入.obsidian/plugins/claudian/data.json。可以手动检查这个文件是否存在如果不存在重新在设置页保存一次。也有可能是仓库权限问题导致插件无法写入配置文件。6. 把 AI 能力真正嵌进笔记流配置跑通之后日常使用其实很简单打开一篇笔记点 Claudian 图标输入指令等结果。但有几个小技巧能让它更顺手。一是把常用指令存成模板比如“把这篇笔记转成 Canvas”“按 obsidian-markdown 规范整理当前笔记”需要时直接粘贴。二是给不同仓库配不同的 settings.json比如工作仓库用一套模型个人仓库用另一套互不干扰。三是定期检查.claude/skills目录把不再用的 skill 移出去避免加载时冲突。如果你还没拿到 API Key可以从控制台创建https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。需要查接入细节的话文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想先试试模型对话效果可以直接用 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你打算长期在 Obsidian 里跑编码类任务或 Agent 流程Coding Plan 会更合适https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。API Keys 管理页在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。