🖥️ Claude Code 安装和配置指南（Windows 电脑版）

这份指南会手把手教你在 Windows 电脑上安装 Claude Code。
按照步骤一步一步来，每一步都有"验证是否成功"的方法，确保你不会走弯路。

📋 安装总览（先看一眼，心里有数）

你一共需要完成以下几件事：

⚠️ 关于"科学上网"（翻墙）

💡 好消息：我们使用国内中转服务器连接 AI，所以整个安装和日常使用过程都不需要翻墙。

⚠️ 安装前的准备（重要！）

Windows 系统的杀毒软件和防火墙可能会拦截安装过程，导致安装失败。为了顺利完成安装，建议先临时关闭它们。

需要临时关闭的软件

1. Windows Defender（Windows 自带的杀毒软件）

• 打开 Windows 设置（按 Windows + I）

• 选择 "更新和安全" → "Windows 安全中心" → "病毒和威胁防护"

• 点击 "管理设置"

• 关闭 "实时保护"

2. 第三方杀毒软件（如果你装了的话）

如果你电脑上装了 360、腾讯电脑管家、火绒等杀毒软件，也建议临时关闭：

• 右键点击任务栏右下角的杀毒软件图标

• 选择 "退出" 或 "暂停保护"

3. Windows 防火墙（可选）

如果安装过程中仍然遇到网络问题，可以临时关闭防火墙：

• 打开 Windows 设置 → "更新和安全" → "Windows 安全中心" → "防火墙和网络保护"

• 点击当前活动的网络（通常是"专用网络"或"公用网络"）

• 关闭 "Microsoft Defender 防火墙"

💡 安装完成后记得重新打开这些保护软件！ 为了电脑安全，完成所有安装步骤后，按照上面的路径重新打开它们。

🔑 先认识一下"PowerShell"

在这份指南中，很多操作需要在 PowerShell 里输入命令。PowerShell 就是 Windows 电脑的"命令行工具"，你可以把它理解为：一个用打字来操作电脑的窗口。

怎么打开 PowerShell

1. 按键盘上的 Windows 键（键盘左下角，有 Windows 标志的那个键）

2. 直接输入 PowerShell

3. 在搜索结果中，你会看到 "Windows PowerShell"

4. 右键点击它，选择 "以管理员身份运行"（Run as Administrator）

5. 如果弹出提示"是否允许此应用对你的设备进行更改"，点 "是"

💡 后面每次说"打开 PowerShell"，都是指这个操作。建议你现在就打开，后面一直用。

第1步：安装 Node.js

Node.js 是一个软件运行环境。你不需要理解它是什么，只需要知道：Claude Code 需要它才能运行，就像手机 App 需要手机操作系统一样。

操作步骤

💡 这一步不需要打开 PowerShell，全程在浏览器和图形界面里完成。

1. 点击下面的按钮，下载 Node.js 安装包：

📦 下载 Windows 版 Node.js 安装包

💡 这个安装包来自国内镜像（npmmirror），下载速度快，不需要科学上网。绝大多数 Windows 电脑都是 64 位的，直接用这个安装包即可。

2. 下载完成后，在浏览器右上角的下载列表或"下载"文件夹里找到 node-v22.22.3-x64.msi，双击打开。

3. 在弹出的安装向导里，一路点 "Next"，最后点 "Install"。

4. 过程中如果弹出"是否允许此应用对你的设备进行更改？"的提示，点 "是"。

5. 看到 "Completed" 后，点 "Finish" 完成安装。

✅ 验证是否成功

1. 关闭之前打开的 PowerShell，然后重新打开一个新的 PowerShell（以管理员身份运行）。 这一步很重要，不然电脑可能找不到刚装好的 Node.js。

2. 在 PowerShell 中分别输入 node -v 和 npm -v，看到版本号（比如 v22.x.x 和 10.x.x）就说明装好了 ✅

⚠️ 如果输入 npm -v 时出现红色报错"禁止运行脚本"，其实并不意味着没有安装，先执行这条命令解锁：
```
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```
输入 Y 确认，然后再试 npm -v 就正常了。

❌ 如果失败了

• 如果 node -v 提示 command not found 或者"无法识别"，请确认 .msi 安装时显示了"Completed"，然后关闭 PowerShell，重新打开一个新的 PowerShell再试一次。

• 如果下载按钮点击后没反应，可以右键点击按钮选择"链接另存为..."手动下载。

第2步：安装 Git for Windows

Claude Code 在 Windows 上需要 Git Bash 才能运行。Git for Windows 是一个工具包，里面包含了 Git Bash。

👇 下面两种装法，挑一种就行。没有科学上网（翻墙）就用「主选」。

winget install Git.Git

✅ 验证是否成功（两种方法都用这一步检验）

不管你用上面哪种方法装的，都在 PowerShell 中输入：

git --version

如果你看到类似 git version 2.x.x 的版本号，说明 Git for Windows 安装成功 ✅

第3步：安装 Claude Code 命令行工具

Claude Code 命令行工具是 Claude AI 的核心程序。装好它之后，你就可以在电脑上直接跟 Claude 对话了。

⚠️ 重要提示：国内镜像源没有完整的二进制文件，需要分三步安装，全程不需要科学上网。

操作步骤

步骤1：用国内镜像安装主包

在 PowerShell 中输入以下命令，然后按回车：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

💡 这条命令使用国内镜像源（npmmirror）下载主程序，速度快，不需要科学上网。

等待安装完成（大约10-30秒）。

步骤2：安装平台特定的二进制包

在 PowerShell 中输入以下命令，然后按回车：

npm install -g @anthropic-ai/claude-code-win32-x64 --registry=https://registry.npmmirror.com

💡 这个包虽然用官方源下载，但文件很小（几MB），国内直连也能下完，不需要科学上网。

等待安装完成（大约5-20秒）。

步骤3：手动运行安装脚本

在 PowerShell 中输入以下命令：

node "$(npm root -g)/@anthropic-ai/claude-code/install.cjs"

这条命令会把二进制文件关联到主程序。执行后应该没有任何输出，这是正常的。

✅ 验证是否成功

在 PowerShell 中输入：

claude --version

如果你看到一个版本号（比如 2.x.x），说明 Claude Code 安装成功 ✅

❌ 如果失败了

• 如果提示 not recognized，尝试关闭 PowerShell，重新打开，再输入 claude --version

• 如果提示 native binary not installed，说明步骤2或步骤3没有成功，请重新执行步骤2和步骤3

• 如果还是不行，重新执行全部三个步骤

第4步：配置 API 连接

这一步要配置两样东西：
- API Key（密钥）：就像一把"钥匙"，需要你自己到 TikBit 注册账号后，在控制台创建（下面 4.0 教你怎么拿）
- 中转服务器地址：让 Claude Code 通过国内服务器连接 AI，不需要翻墙

4.0 注册 TikBit，创建你自己的密钥

你需要自己去 TikBit 注册、在控制台创建一个密钥。整个过程几分钟，无需翻墙：

1. 打开浏览器，访问 tikbit.ai，点右上角 注册，用邮箱注册一个账号并登录。

2. 登录后，点顶部导航的 控制台（或直接访问 tikbit.ai/console）。

3. 在控制台左侧菜单找到 令牌，点 添加令牌。

4. 填写令牌名称（随便起，比如 claude-code），额度建议勾选 设为无限额度，其他保持默认，点 提交。

5. 创建成功后回到令牌列表，点这条令牌右侧的 复制，复制出来的就是一串以 sk- 开头的密钥。

✅ 这串 sk- 开头的字符串，就是下面所有步骤里要用到的 你的API密钥。先把它复制好放到记事本里备用。
📌 另外，下面会用到 你的API网址。如果你的密钥是在 TikBit.ai 上创建的，那 API 网址就填：https://tikbit.ai

4.1 设置环境变量

打开 PowerShell（如果上一步已经打开了，就继续用），依次输入以下两条命令。

1. 复制下面这条命令，粘贴到 PowerShell 里，按回车：

setx ANTHROPIC_BASE_URL "你的API网址"

这条命令告诉 Claude Code：通过国内中转服务器连接 AI，不走国外直连。

2. 再复制下面这条命令，把 你的密钥 替换成你在 TikBit 控制台创建的那串密钥，然后粘贴到 PowerShell 里，按回车：

setx ANTHROPIC_AUTH_TOKEN "你的密钥"

比如你创建的密钥是 sk-ant-abc123xyz，那你输入的就是：
setx ANTHROPIC_AUTH_TOKEN "sk-ant-abc123xyz"

3. 每条命令执行后，你会看到提示 "成功: 指定的值已经被保存。"（SUCCESS: Specified value was saved.）

4. 关闭所有已打开的 PowerShell 窗口，然后重新用管理员身份打开一个新的 PowerShell。 这一步很重要，新的配置需要重新打开 PowerShell 才能生效。

📸 截图示例：setx 命令执行成功后的提示

4.2 写入 Claude 配置文件（关键！）

⚠️ 这一步非常重要！Claude Code 首次启动时会尝试连接国外服务器验证，在国内会失败。我们需要提前写入一个配置文件，跳过这个验证步骤，并把 API Key 直接写进去。

在新打开的 PowerShell 中，复制下面这条命令，把 你的密钥 替换成你在 TikBit 控制台创建的密钥，然后粘贴到 PowerShell 里，按回车：

Set-Content -Path "$env:USERPROFILE\.claude.json" -Value '{"hasCompletedOnboarding":true,"primaryApiKey":"你的密钥"}'

比如你创建的密钥是 sk-ant-abc123xyz，那你输入的就是：
```
Set-Content -Path "$env:USERPROFILE\.claude.json" -Value '{"hasCompletedOnboarding":true,"primaryApiKey":"sk-ant-abc123xyz"}'
```

按回车后不会有任何提示，这是正常的。

✅ 验证是否成功

1. 打开一个新的 PowerShell 窗口

2. 输入以下命令，按回车：

echo $env:ANTHROPIC_BASE_URL

如果显示 你的API网址，说明中转服务器地址配置成功 ✅

3. 再输入：

echo $env:ANTHROPIC_AUTH_TOKEN

如果显示你的密钥，说明 API Key 配置成功 ✅

❌ 如果失败了

• 如果什么都没显示，说明配置没生效。一定要关掉旧的 PowerShell，开一个新的再验证。

• 检查变量名是否拼写正确：ANTHROPIC_BASE_URL（全部大写，用下划线连接）

• 检查中转地址是否正确：你的API网址（注意是 https 开头，结尾没有斜杠）

• 如果还是不行，截图发给大龙

第5步：验证 Claude Code 能正常使用

💡 这一步不需要科学上网，因为你已经配置了国内中转服务器。

操作步骤

1. 在 PowerShell 中输入：

claude

2. 按回车后，Claude Code 会启动。

5.1 信任文件夹

首次启动时，Claude Code 会显示一个安全提示，问你是否信任当前文件夹：

Quick safety check: Is this a project you created or one you trust?
> 1. Yes, I trust this folder
  2. No, exit

用方向键选择 1. Yes, I trust this folder，然后按回车。

📸 截图示例：首次启动时的信任文件夹提示

5.2 确认使用 API Key（重要！）

接下来 Claude Code 会检测到你配置的 API Key，显示以下提示：

ANTHROPIC_AUTH_TOKEN: sk-ant-...（你的密钥）
Do you want to use this API key?
> 1. Yes
  2. No (recommended)

⚠️ 注意：默认选中的是第2个 No，但我们要选第1个 Yes！ 用方向键 ↑ 切换到 1. Yes，然后按回车。

如果不小心选了 No，不用慌，退出后重新执行第4步的 4.2（写入配置文件的那条命令），然后再输入 claude 启动即可。

📸 截图示例：确认使用 API Key 的提示（注意要选 Yes）

5.3 测试对话

如果你看到 Claude 的欢迎界面（显示版本号和 API Usage Billing），说明已经连接成功了。

试着输入一句话测试：

你好

如果 Claude 回复了你，恭喜！Claude Code 命令行工具安装配置全部完成 🎉

输入以下命令退出 Claude：

/exit

❌ 如果失败了

• 如果提示 Not logged in · Please run /login：说明你在上一步不小心选了 No。先输入 /exit 退出 Claude，然后在 PowerShell 中重新执行第4步的 4.2（Set-Content 那条命令），再输入 claude 重新启动即可

• 如果提示 Unable to connect to Anthropic services：说明第4步的 .claude.json 配置文件没有写入成功，回到第4步的 4.2 重新执行

• 如果提示 API Key 相关的错误，回到第4步检查 ANTHROPIC_AUTH_TOKEN 是否配置正确

• 如果提示网络错误或连接失败，回到第4步检查 ANTHROPIC_BASE_URL 是否配置正确（应该是 你的API网址）

• 如果提示 not recognized，回到第3步重新安装

第6步：在 Obsidian 中使用 Claude Code

Obsidian 是一款笔记软件，也是我们课程中使用的知识库工具。这一步教你怎么在 Obsidian 里面使用 Claude。

6.1 安装 Obsidian（如果你还没装的话）

👇 下载安装包有两种方式，挑一种就行。没有科学上网（翻墙）就用「主选」。

下载好安装包后，按下面三步装上：

1. 在浏览器右上角的下载列表或"下载"文件夹里找到 .exe 文件，双击打开。

2. 在安装向导中，一路点 "Next"，最后点 "Install" 完成安装。

3. 安装完成后，在开始菜单中搜索 "Obsidian"，点击打开。

6.2 创建或打开你的知识库

1. 打开 Obsidian

2. 如果是第一次使用，选择 "Create new vault"（创建新仓库），给它起个名字，比如 我的AI知识库

3. 如果你已经有知识库，选择 "Open folder as vault"（打开文件夹作为仓库）

6.3 开启社区插件

1. 点击 Obsidian 左下角的 设置图标（齿轮 ⚙️）

2. 在左侧菜单中选择 "Community plugins"（第三方插件/社区插件）

3. 如果看到 "Restricted mode"（安全模式/受限模式） 的提示，点击 "Turn on community plugins"（开启社区插件），然后在弹窗中点确认

💡 这一步只需要做一次，以后不用再开。

6.4 安装 Claudian 插件

Claudian 是一个开源的 Obsidian 插件，它把 Claude Code 嵌入到 Obsidian 里面，让你可以在笔记软件中直接跟 AI 对话、读写文件、管理知识库。

我们直接让 Claude 帮你安装这个插件。

操作步骤：

1. 打开 PowerShell，启动 Claude（如果第5步退出了，重新输入 claude 启动）

2. 复制下面这段话，粘贴给 Claude，按回车：

帮我安装 Obsidian 的 Claudian 插件。
步骤：
1. 找到我的 Obsidian 知识库
2. 下载 main.js、manifest.json、styles.css 这三个文件。我在国内、没有科学上网，GitHub 直连会失败，所以请直接用下面的 GitHub 国内加速代理链接下载（用 curl 下到对应文件夹即可）：
   main.js:      https://gh-proxy.com/https://github.com/YishenTu/claudian/releases/latest/download/main.js
   manifest.json: https://gh-proxy.com/https://github.com/YishenTu/claudian/releases/latest/download/manifest.json
   styles.css:   https://gh-proxy.com/https://github.com/YishenTu/claudian/releases/latest/download/styles.css
   如果 gh-proxy.com 也下不动，换成 https://ghfast.top/ 或 https://gh.llkk.cc/ 前缀再试（都是 GitHub 加速代理，把前缀换掉、后面的 github 地址不变）。
3. 把这三个文件放到知识库的 .obsidian/plugins/realclaudian/ 文件夹里（文件夹不存在就新建；文件夹名必须叫 realclaudian，要和插件 manifest 里的 id 一致，否则 Obsidian 里启用不了）
如果有多个知识库，每个都装上。

3. Claude 执行过程中会弹出确认提示，一路选 Yes 即可。完成后输入 /exit 退出。

启用插件：

1. 回到 Obsidian

2. 打开 设置 → Community plugins（第三方插件/社区插件）

3. 点击右上角的 刷新按钮（🔄），刷新插件列表

4. 在列表中找到 "Claudian"，打开右边的开关启用它

配置插件（重要！必须做完以下两项才能用）：

1. 在 Obsidian 设置中，找到左侧菜单的 "Claudian"（在 Community plugins 下面）

2. 在 "自定义变量" 或 "环境" 区域，输入以下两行：

ANTHROPIC_AUTH_TOKEN="你的API密钥"
ANTHROPIC_BASE_URL="你的API网址"

把 你的API密钥 替换成你在 TikBit 控制台创建的密钥（和第4步配置的是同一个密钥）

3. 指定 Claude Code 路径（必做！不做会报错）：

因为我们是通过 npm 安装的 Claude Code，Claudian 插件无法自动找到它，需要手动告诉插件 Claude Code 装在哪里。

先打开 PowerShell，复制下面这条命令，粘贴进去，按回车：

Write-Output "$(npm root -g)\@anthropic-ai\claude-code\bin\claude.exe"

它会输出一个完整路径，类似这样（每个人的用户名不同）：

C:\Users\你的用户名\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code\bin\claude.exe

选中并复制这个路径，然后回到 Obsidian：

• 在 Claudian 设置页面，找到 "Claude CLI路径" 区域

• 在 "Claude Code Cu的自定义路径" 输入框中，粘贴刚才复制的路径

• 关闭设置，重启 Obsidian

⚠️ 路径中不要有多余的空格，确保是一整条路径。

4. 点击保存或关闭设置

6.5 验证是否成功

启用插件后，你会在 Obsidian 左侧边栏看到一个 Claudian 的图标。点击它，会打开一个聊天侧边栏。

在对话框中输入：

你好

如果 Claude 正常回复了，说明 Obsidian + Claudian 插件配置成功 ✅

6.6 常见问题

Q：提示 "spawn EINVAL" 或路径错误？

• 检查 Advanced 里填的路径是否正确，必须是 .exe 结尾的完整路径

• 确认路径中没有多余的空格

• 重启 Obsidian（这一步很重要，让新配置生效）

Q：Claude 没有回复或报错？

• 检查配置插件那一步的 Claude Code 路径是否填对了（以 .exe 结尾的那个）

• 检查第4步的环境变量是否配置正确

• 检查 Claudian 设置中的 API Key 和中转地址是否填对

• 尝试重启 Obsidian

❌ 如果实在装不上

提前联系大龙，上课当天早点到，现场帮你装。

🎉 恭喜你！安装全部完成！

如果你走到了这里，说明你已经成功安装了 Claude Code。现在你可以：

• 在 PowerShell 里直接跟 Claude 对话（输入 claude 启动）

• 在 Obsidian 里用 Claude 帮你管理知识库、整理笔记、生成内容

💡 日常使用提醒：因为我们使用了国内中转服务器，日常使用 Claude 不需要翻墙，直接打开就能用。

⬇ Claude API 一键切换软件

这个小工具可以帮你一键切换 Claude Code 的 API 连接地址，无需手动修改配置文件。

💡 软件会自动识别你的操作系统，点击按钮即可下载对应版本。

⬇ 下载 Claude API 一键切换软件

💬 联系支持

如果你在安装过程中遇到任何问题，请联系我们获取帮助。

扫描下方二维码或微信号（jimzhaolong）添加微信。