Claudian 插件无法连接 Claude Code 的修复记录

问题现象

Obsidian 中的 Claudian 插件对话异常，但终端里的 Claude Code 可以正常使用。

报错信息：

❌ Error: Claude Code native binary not found at C:\Users\Administrator\AppData\Roaming\npm\claude. Please ensure Claude Code is installed via native installer or specify a valid path with options.pathToClaudeCodeExecutable.

根因

终端中的 claude 命令能正常运行，是因为它走的是 npm 生成的命令包装脚本：

C:\Users\Administrator\AppData\Roaming\npm\claude

但这个文件不是 Windows 原生可执行文件，而是一个 shell shim。Claudian 插件需要直接调用 Claude Code 的原生 .exe 文件，因此不能只配置到 npm shim。

实际可用的 Claude Code 原生可执行文件路径是：

C:\Users\Administrator\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code\bin\claude.exe

验证命令：

"/c/Users/Administrator/AppData/Roaming/npm/node_modules/@anthropic-ai/claude-code/bin/claude.exe" --version

验证结果：

2.1.158 (Claude Code)

修复方法

编辑项目下的 Claudian 配置文件：

D:\project2026\obsidian-vault-template\.claudian\claudian-settings.json

将 providerConfigs.claude.cliPath 从空值：

"cliPath": ""

修改为：

"cliPath": "C:\\Users\\Administrator\\AppData\\Roaming\\npm\\node_modules\\@anthropic-ai\\claude-code\\bin\\claude.exe"

同时可在 cliPathsByHost 中为当前主机写入同样路径，例如：

"cliPathsByHost": {
  "DESKTOP-980GPDV": "C:\\Users\\Administrator\\AppData\\Roaming\\npm\\node_modules\\@anthropic-ai\\claude-code\\bin\\claude.exe"
}

修复后的关键片段如下：

"providerConfigs": {
  "claude": {
    "safeMode": "acceptEdits",
    "cliPath": "C:\\Users\\Administrator\\AppData\\Roaming\\npm\\node_modules\\@anthropic-ai\\claude-code\\bin\\claude.exe",
    "cliPathsByHost": {
      "DESKTOP-980GPDV": "C:\\Users\\Administrator\\AppData\\Roaming\\npm\\node_modules\\@anthropic-ai\\claude-code\\bin\\claude.exe"
    },
    "loadUserSettings": true
  }
}

注意区分两个配置文件

Claudian 的 Claude Code 路径配置不在 Obsidian 插件目录的 data.json 里。

这个文件：

D:\project2026\obsidian-vault-template\.obsidian\plugins\claudian\data.json

目前主要保存插件的标签页状态，例如 tabManagerState，不是 Claude Code 可执行文件路径配置。

真正需要修改的是：

D:\project2026\obsidian-vault-template\.claudian\claudian-settings.json

修复后操作

1. 保存 .claudian/claudian-settings.json。
2. 关闭 Obsidian。
3. 重新打开 Obsidian。
4. 再打开 Claudian 插件对话测试。

排查命令

如果之后再次出现类似问题，可以先在终端检查 Claude Code 命令来源：

command -v claude
type -a claude
claude --version

如果 command -v claude 返回的是：

/c/Users/Administrator/AppData/Roaming/npm/claude

说明终端调用的是 npm shim。给 Claudian 配置时，应继续使用真实 exe：

C:\Users\Administrator\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code\bin\claude.exe

远程技术支持，➕dqtx33