Obsidian + Claudian + 本地代理完整安装配置教程 (Windows 11)-环球搭子

最近看了叁斤老师的分享，然后亦仁老大的直播也在说，我就尝试安装使用，我是基于英伟达免费模型测试，能跑通。

🚀 零基础教程：在 Obsidian 中免费使用 Claude Code（基于 NVIDIA NIM）

适用系统：Windows 11 / Windows 10 21H2 及以上

预计耗时：30～45 分钟

核心目标：在 Obsidian 笔记软件中，通过免费 API 调用强大的 AI 模型，实现笔记与 AI 的无缝结合。

本教程将手把手带你完成以下所有环节：

1. 安装 Obsidian 并创建结构化的知识库。
2. 安装 Claude Code CLI（命令行工具）。
3. 获取 NVIDIA NIM 免费 API 密钥。
4. 配置本地代理（free-claude-code），让 Claude Code 能够使用免费模型。
5. 安装并配置 Claudian 插件，将 Claude Code 接入 Obsidian。

📦 准备工作清单

在开始之前，请确认你的电脑满足以下条件：

项目

要求

如何检查/获取

操作系统

Windows 11（Win10 21H2 以上也可）

右键“此电脑” → “属性” 查看

Node.js

版本 18.0.0 或更高

教程第一步会教安装

网络

稳定的互联网连接

能正常打开网页即可

硬盘空间

至少 5GB 可用空间

打开“此电脑”查看各盘符剩余空间

耐心

跟着步骤一步步来，不要跳步

😊

第一步：安装 Node.js 运行环境

Claude Code 是基于 Node.js 开发的，所以必须先安装 Node.js。

1. 下载安装包

打开浏览器，访问 Node.js 官方网站。

2. 运行安装程序

双击下载好的 .msi 文件。

◦ 一路点击 Next。
◦ 在 Custom Setup 界面，确保 Add to PATH 选项是勾选状态（通常默认勾选）。

4. 验证安装

安装完成后，按下 Win + R，输入 powershell 并回车，打开 PowerShell 终端。

代码块
PowerShell
复制
node --version

如果屏幕上出现类似 v20.18.0 的版本号，说明 Node.js 安装成功。

第二步：安装 Claude Code CLI

接下来安装 Claude Code 的命令行工具。我们使用最简单的一键脚本方式。

1. 打开 PowerShell
2. 执行安装命令

代码块
PowerShell
复制
irm https://claude.ai/install.ps1 | iex

小白提示：

• irm 是“从网络下载脚本”的命令。
• | iex 是“执行下载的脚本”的命令。
• 整个过程会自动完成，你只需要等待。

3. 遇到报错怎么办？

◦ 在开始菜单搜索 PowerShell，右键点击 Windows PowerShell，选择以管理员身份运行。

代码块
PowerShell
复制
Set-ExecutionPolicy RemoteSigned -Force

安装完成后，关闭当前的 PowerShell 窗口，重新打开一个新的 PowerShell 窗口。

代码块
PowerShell
复制
claude --version

如果能看到版本号（例如 1.0.0），说明 Claude Code 安装成功。

以上方法错误的试试下边的方法

🔧 推荐方案：使用 npm 替代安装（已成功验证）

既然一键脚本受到网络限制，最稳妥的替代方案就是使用 npm 命令进行安装。这也是官方推荐并经过验证的成功方法。

1. 确认 Node.js 环境：确保你的电脑已经安装 Node.js（v18.0 或更高版本）。如果还没有，请先访问 Node.js 官网下载并安装 LTS 版本-。安装完成后，可以重启一下终端。
2. 执行安装命令：打开一个新的 PowerShell 窗口，粘贴以下命令并回车：

powershell
Plain Text
复制
npm install -g @anthropic-ai/claude-code

请注意：正确的包名是 @anthropic-ai/claude-code，不要漏掉前缀。

3. 等待安装完成：这个过程会下载并安装必要的组件，请耐心等待几分钟。

🔄 备用方案：手动下载脚本并执行

如果 npm 方式也因为网络问题无法安装，可以尝试手动下载脚本。

1. 下载脚本：在浏览器中直接打开这个链接：https://claude.ai/install.ps1。
2. 保存脚本：如果页面正常显示了脚本代码，全选复制。然后在你电脑的某个位置（比如桌面）新建一个文本文档，把代码粘贴进去，并重命名为 install.ps1。
3. 执行脚本：以管理员身份打开 PowerShell，先运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 来允许脚本执行，然后用 cd 命令进入脚本所在目录，执行 ./install.ps1 来运行安装。

第三步：获取 NVIDIA NIM 免费 API 密钥

我们要使用 NVIDIA 提供的免费大模型接口，所以需要去官网申请一个 API 密钥。

1. 访问 NVIDIA Build 网站

◦ 点击页面右上角的 Login。
◦ 登录成功后，点击右上角你的头像/用户名，在下拉菜单中选择 Setup -> API Key。
◦ 点击 Generate API Key 按钮。
◦ Key Name：随便填一个名字，比如 ObsidianKey。
◦ Expiration：建议选择 Never Expire（永不过期）。
◦ Services Included：务必勾选 NGC Catalog 和 Public API Endpoints。

4. 保存密钥（非常重要！）

页面上会显示一串以 nvapi- 开头的长字符串。

请立刻把它复制下来，粘贴到一个记事本里保存好！

英伟达NIM平台最近一个很普遍的坑，尤其是在国内使用 +86 手机号注册时，很容易遇到收不到验证码或提示“号码超限”的问题

第四步：配置并启动本地代理（free-claude-code）

为了让 Claude Code 能够使用 NVIDIA 的免费模型，我们需要一个“翻译官”——本地代理服务。

说明：本教程假设你已经获得了 free-claude-code 项目文件夹。如果还没有，请先从可靠渠道获取该项目的代码压缩包并解压，例如解压到 C:\Users\你的用户名\free-claude-code。

1. 打开代理项目文件夹

使用文件资源管理器，进入 free-claude-code 文件夹。

2. 配置环境变量文件（.env）

在 free-claude-code 文件夹中，找到名为 .env 的文件（如果没有，就新建一个文本文件，重命名为 .env）。

代码块
TOML
复制
NVIDIA_NIM_API_KEY=粘贴你第三步获取的nvapi-密钥
MODEL_OPUS=nvidia_nim/z-ai/glm5
MODEL_SONNET=nvidia_nim/minimaxai/minimax-m2.5
MODEL_HAIKU=nvidia_nim/qwen/qwen3.5-397b-a17b
MODEL=nvidia_nim/moonshotai/kimi-k2.5
NIM_ENABLE_THINKING=true

注意：第一行的 NVIDIA_NIM_API_KEY= 后面，一定要替换成你自己的真实密钥（nvapi-…）。

保存并关闭文件。

◦ 在 free-claude-code 文件夹的地址栏中，直接输入 powershell 并回车，这样可以在当前目录下打开 PowerShell。

代码块
PowerShell
复制

小白提示：uv 是一个 Python 包管理工具，如果你的电脑没有安装 uv，请先参考项目说明安装它，或使用项目推荐的其他启动方式。

◦ 启动成功后，你会看到类似 Uvicorn running on http://127.0.0.1:8000 的输出。

第五步：安装 Obsidian 并创建知识库

1. 下载 Obsidian
2. 安装 Obsidian
3. 创建知识库文件夹结构

我们将在 E 盘创建一个专门的知识库文件夹（你也可以选择其他盘，但后续路径要对应修改）。

代码块
PowerShell
复制
New-Item -Path "E:\NongFu\输入箱", "E:\NongFu\知识库", "E:\NongFu\内容生产", "E:\NongFu\产品库", "E:\NongFu\素材库", "E:\NongFu\.claude\skills" -ItemType Directory -Force

执行成功后，你会在 E:\NongFu 下看到完整的目录结构。

◦ 启动 Obsidian。
◦ 在欢迎界面，点击打开文件夹作为库。

第六步：安装 Claudian 插件（手动安装）

Claudian 插件可以把 Claude Code 嵌入到 Obsidian 侧边栏中。

1. 下载插件文件

打开浏览器，访问 Claudian Releases 页面。

◦ main.js
◦ manifest.json
◦ 打开文件资源管理器，进入你的知识库目录：E:\NongFu。
◦ 在地址栏输入 .obsidian 并回车（如果提示找不到文件夹，请先点击资源管理器顶部“查看”菜单，勾选隐藏的项目）。
◦ 进入 .obsidian 文件夹，找到 plugins 文件夹（若没有，则右键新建一个名为 plugins 的文件夹）。
◦ 在 plugins 文件夹内，新建一个名为 claudian 的文件夹。
◦ 完全关闭 Obsidian，再重新打开。
◦ 点击 Obsidian 左下角的齿轮图标（设置）。
◦ 在左侧菜单选择第三方插件。

第七步：配置 Claudian 连接本地代理

这是整个流程中最关键的一步，一定要仔细操作。

1. 进入 Claudian 设置
2. 添加自定义环境变量

变量名

变量值

ANTHROPIC_API_KEY

你的NVIDIA API密钥（就是第三步获取的那个 nvapi-…）

ANTHROPIC_BASE_URL

http://127.0.0.1:8000

ANTHROPIC_MODEL

minimaxai/minimax-m2.5

CLAUDE_CODE_USE_BEDROCK

> ⚠️ 重要说明：

> – ANTHROPIC_BASE_URL 不要在末尾加 /v1。

> – 添加完毕后，请检查变量名和值不要有多余的空格。

3. 保存并彻底重启 Obsidian

第八步：启动代理并测试完整流程

1. 确保代理服务正在运行

回到第四步中打开的 PowerShell 窗口，确认它还在运行（有 Uvicorn running on… 字样）。

◦ 在 Obsidian 中，按下快捷键 Ctrl + P 打开命令面板。
◦ 在聊天窗口的输入框中，输入 /model 并回车。
◦ 从弹出的列表中，选择一个你喜欢的模型，例如 nvidia_nim/z-ai/glm5（智谱）或 nvidia_nim/moonshotai/kimi-k2.5（Kimi）。