项目文件夹

Claude 提供商：需安装 Claude Code CLI（推荐原生安装）。Claude 订阅/API 或兼容提供商（Openrouter, Kimi, GLM 等）。
可选提供商：Codex CLI, Opencode, Pi.
Obsidian v1.7.2+
仅桌面端（macOS、Linux、Windows）

安装

从 Obsidian 社区插件安装（推荐）

打开 Obsidian → Settings → Community plugins → Browse
搜索 "Claudian" 并点击 Install
启用该插件

或直接从社区插件页面.安装。

从 GitHub Release 安装

从最新版本下载 main.js、manifest.json 和 styles.css
在库的 plugins 文件夹中创建名为 claudian 的文件夹：
```
/path/to/vault/.obsidian/plugins/claudian/
```
将下载的文件复制到 claudian 文件夹
在 Obsidian 中启用插件：
- Settings → Community plugins → Enable "Claudian"

从源码安装（开发）

将此仓库克隆到库的 plugins 文件夹：

cd /path/to/vault/.obsidian/plugins
git clone https://github.com/YishenTu/claudian.git
cd claudian

安装依赖并构建：
```
npm install
npm run build
```
在 Obsidian 中启用插件：
- Settings → Community plugins → Enable "Claudian"

开发

# Watch mode
npm run dev

# Production build
npm run build

隐私与数据使用

发送至 API：你的输入、附加文件、图片及工具调用输出。默认：Anthropic（Claude）、OpenAI（Codex），或在 Opencode/Pi 中配置的提供商；可通过提供商设置和环境变量配置。
本地存储：Claudian 设置与会话元数据位于 vault/.claudian/；Claude 提供商文件位于 vault/.claude/；转录记录位于 ~/.claude/projects/（Claude）、~/.codex/sessions/（Codex），以及 .pi/agent/sessions/ 或 ~/.pi/agent/sessions/（Pi）。
环境变量：提供商子进程继承 Obsidian 进程环境，以及你在 Claudian 中配置的任何变量。这用于 CLI 认证、代理、证书和 PATH 解析。
设备特定路径：每台设备的 CLI 路径使用存储在浏览器本地存储中的不透明本地密钥，而非你的系统主机名。
后台活动：Claudian 不运行遥测信标。UI 轮询定时器仅读取本地 Obsidian/编辑器选中状态。网络活动仅限于明确的提供商运行时工作、已配置的 MCP 端点，以及响应你请求所需的提供商 SDK/CLI 调用。

故障排除

找不到 Claude CLI

如果遇到 spawn claude ENOENT 或 Claude CLI not found，插件无法自动检测你的 Claude 安装。这在 Node 版本管理器（nvm、fnm、volta）中很常见。

解决方案：先将该设置留空，让 Claudian 自动检测 Claude Code。若自动检测失败，找到你的 CLI 路径并在 Settings → Advanced → Claude CLI path 中设置。

平台	命令	示例路径
macOS/Linux	`which claude`	`/Users/you/.volta/bin/claude`
Windows (native)	`where.exe claude`	`C:\Users\you\AppData\Local\Claude\claude.exe`
Windows (npm)	`npm root -g`	`{root}\@anthropic-ai\claude-code\cli-wrapper.cjs`

注意：在 Windows 上，避免使用 .cmd 和 .ps1 包装器。原生安装请使用 claude.exe，包管理器安装请使用 cli-wrapper.cjs。cli.js 仅是旧版 Claude Code npm 包的遗留回退方案。

替代方案：在 Settings → Environment → Custom variables 中将 Node.js bin 目录添加到 PATH。

npm CLI 与 Node.js 不在同一目录

若使用 npm 安装的 CLI，检查 claude 和 node 是否在同一目录：

dirname $(which claude)
dirname $(which node)

若不在同一目录，Obsidian 等 GUI 应用可能找不到 Node.js。

解决方案：

安装原生二进制文件（推荐）
在 Settings → Environment 中添加 Node.js 路径：PATH=/path/to/node/bin

其他提供商

Codex、Opencode 和 Pi 支持已上线，但功能可能不完整，仍需要在各平台和安装方式下进行更多测试。如有功能请求或遇到任何 bug，请提交 GitHub issue.

架构

src/
├── main.ts                      # Plugin entry point
├── app/                         # Shared defaults and plugin-level storage
├── core/                        # Provider-neutral runtime, registry, and type contracts
│   ├── runtime/                 # ChatRuntime interface and approval types
│   ├── providers/               # Provider registry and workspace services
│   ├── auxiliary/               # Shared provider auxiliary services
│   ├── bootstrap/               # Plugin bootstrap wiring
│   ├── security/                # Approval utilities
│   └── ...                      # commands, mcp, prompt, storage, tools, types
├── providers/
│   ├── claude/                  # Claude SDK adaptor, prompt encoding, storage, MCP, plugins
│   ├── codex/                   # Codex app-server adaptor, JSON-RPC transport, JSONL history
│   ├── opencode/                # Opencode adaptor
│   ├── pi/                      # Pi RPC adaptor, model discovery, JSONL history
│   └── acp/                     # Agent Client Protocol shared transport
├── features/
│   ├── chat/                    # Sidebar chat: tabs, controllers, renderers
│   ├── inline-edit/             # Inline edit modal and provider-backed edit services
│   └── settings/                # Settings shell with provider tabs
├── shared/                      # Reusable UI components and modals
├── i18n/                        # Internationalization (10 locales)
├── types/                       # Shared ambient types
├── utils/                       # Cross-cutting utilities
└── style/                       # Modular CSS

许可证

根据 MIT License 授权。

赞助

Ke Holdings Inc. (BEIKE)

Claudian 由贝壳找房（Ke Holdings Inc. / BEIKE）及 MOMA 团队慷慨赞助。他们的支持使 Claudian 能够通过持续的开发与维护不断改进。

想支持 Claudian 或在此展示赞助？请联系我：tysk01213@gmail.com。

Star 历史

致谢

Obsidian for the plugin API
Anthropic for Claude and the Claude Agent SDK
OpenAI for Codex
Opencode
Pi

README.md Unescape Escape

Claudian

功能与用法

系统要求

安装