1 VScode配置Claude code
1.1 安装Node.js
- 打开 https://nodejs.org
- 下载LTS 版本的 Windows 安装包(.msi)
- 运行安装包,一路
Next,勾选【Automatically install the necessary tools】
- 运行安装包,一路
- 安装完成后重启终端
- 验证Node.js安装情况
node --version # 应输出 v20.x 或 v22.x npm --version # 应输出 10.x1.2 安装git
- 打开 Git
- 下载安装包(.exe)
- 双击运行安装程序,一路点 Next 使用默认选项即可
- 安装完成后重启终端
- 验证git安装情况
git --version # git version 2.55.0.windows.21.3 安装CC-Switch
- 打开 CC-Switch GitHub 仓库 CC-Switch
- 下载安装包CC-Switch-vX.XX.X-Windows(.msi)
- 双击运行安装程序,一路点 Next 使用默认选项即可
- 启动 CC-Switch
- 点击“+”,新建API接口
- 获取API key(需要自行保存,不然易丢失),以deepseek为例
- 配置API接口,如下:
路径:C:\Users\用户名\.claude\settings.json { "env": { "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", "ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek-v4-pro[1M]", "ANTHROPIC_DEFAULT_FABLE_MODEL_NAME": "deepseek-v4-pro", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash", "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1M]", "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "deepseek-v4-pro", "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1M]", "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "deepseek-v4-pro", "ANTHROPIC_MODEL": "deepseek-v4-pro" }, "includeCoAuthoredBy": false, "theme": "dark" }1.4 VScode下载Claude Code for VS Code
- 修改setting.json
路径:Settings –> Extensions –> Claude Code { "workbench.colorTheme": "Light 2026", "verilog.linting.linter": "xvlog", "claudeCode.preferredLocation": "panel", "claudeCode.environmentVariables": [ { "name": "ANTHROPIC_BASE_URL", "value": "https://xxxx" }, { "name": "ANTHROPIC_AUTH_TOKEN", "value": "xxxx" } ] }2 Obsidian配置Claude code
2.1 环境配置参照1.1-1.3。
2.2 命令行安装Claude code
安装:npm install -g @anthropic-ai/claude-code 验证:claude --version 启动:claude 测试:你当前使用的模型2.3 安装第三方插件
- Obsidian → 设置 → 第三方插件 → 社区插件
- 搜索并安装以下插件:
- Claudian— 在侧边栏嵌入 Claude Code 聊天面板,支持 Skills、MCP、@提及、内联编辑
- Terminal— 在 Obsidian 内运行终端的插件(可选,Claudian 不依赖它)
- 安装完成后启用插件
2.4 配置Claude CLI路径
- 打开终端(PowerShell/cmd),输入以下命令找到
claude的安装路径:where claude - 复制返回的完整路径(例如
C:\Users\用户名\AppData\Roaming\npm\claude或C:\Users\用户名\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code\cli-wrapper.cjs) - Obsidian → 设置 →Claudian插件设置页
- 找到Claude CLI Path字段,粘贴路径
- 保存设置
2.5 API凭证配置(二选一)
方式一:全局settings.json(推荐)
Claudian 会自动读取C:\Users\用户名\.claude\settings.json中的配置,需确保已按1.3节配置好环境变量(ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL等)。
方式二:插件内单独设置
在 Claudian 设置页中直接填写:
- API Key:你的 API 令牌
- Base URL:API 端点地址(如使用 CC-Switch 转发的地址)
2.6 启动与使用
- 左侧工具栏点击Claudian 图标(对话气泡形状)
- 侧边栏会打开 Claude Code 聊天面板
- 你可以:
- 直接提问:让 Claude 帮你整理笔记、搜索 vault、总结内容
- @提及文件:输入
@引用 vault 中的笔记(支持模糊搜索) - 内联编辑:选中笔记中的文字,使用快捷键或右键菜单让 Claude 改写
- Skills:在输入框输入
/调用预设的技能模板
- 首次启动会验证 Claude CLI 连接,成功后会显示当前模型信息
2.7 其他可选插件方案
除了 Claudian,还有以下插件可用于 Obsidian + Claude Code:
| 插件 | 特点 | 安装方式 |
|---|---|---|
| Glass(原名 Blackglass) | 侧边栏内置真实终端直接运行 Claude CLI,自带 vault MCP 服务器 | 社区插件搜索 Glass |
| Claude Code Terminal | 嵌入式终端,支持浮动窗口、主题适配 | 社区插件搜索 Claude Code Terminal |
| Obsidian Claude(N1et) | 轻量聊天面板 + 文本选中转换 + 内联 /ai 命令 | 社区插件搜索 Claude |
| Agent Client | 支持多 AI(Claude、Codex、Gemini),MCP 集成 | 社区插件搜索 Agent Client |
💡推荐:新手首选Claudian,功能最全面;需要真实终端体验选Glass。
2.8 注意与排错
- claude 命令找不到:确认
npm install -g @anthropic-ai/claude-code安装成功,且 npm 全局 bin 目录已在系统 PATH 中(重开终端) - API 连接失败:检查
settings.json中的ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL是否正确 - 插件无法启动:确认 Obsidian 版本 ≥ v1.7.2,且使用桌面版(不支持移动端)
- 代理问题:如使用 CC-Switch 等本地代理,确保代理服务正在运行