如何安装和使用 Claude Code 教程 - Windows 用户篇

前言

这两天手头上的事情正好忙完了，发现claude的势头越来越猛，所以我也去研究了一下，发现在vscode中就有这么一个插件------Claude-Code，然后又找到了一个注册即可领取调用Claude额度的网站，虽然它里面也有一个使用教程，如何将Claude部署到本地，但是我在部署的过程中还是遇到了不少问题。接下来就是这篇文章的主要讲的内容了，还有一个问题就是本人用的环境都是在 windos 下运行的，也就是说 mac 和 linux 下的可自行参考网站中所提供的对应的使用教程，本文只分享 windows 下出现的各种问题，谢谢大家。

第一步：创建API令牌

首先我们进入文中所分享的网址，进行正常的注册与登录，在左边的tab导航栏中选择API令牌，点击新增令牌。

新增令牌的选项，我这边建议直接选择永不过期加上额度无限，名称随意填写，选择填写完之后，点击提交，令牌就创建好了。

第二步：部署 Claude Code

接下来，让我们调出终端，也就是小黑窗口，按照教程中的步骤，输入以下命令：

bash 复制代码

npm install -g @anthropic-ai/claude-code

运行之后咱们可以看到，诶，报错了

Claude Code is not supported on Windows.

居然提示Claude Code 不支持Windows，那这可如何是好，不急，咱还有一个东西可以用，那就是 WSL。有可能有些人不知道 WSL是什么，我在这里浅浅的讲一下。官方的定义是------适用于 Linux 的 Windows 子系统（WSL）是 Windows 的一项功能，可用于在 Windows 计算机上运行 Linux 环境，而无需单独的虚拟机或双重启动。 WSL 旨在为想要同时使用 Windows 和 Linux 的开发人员提供无缝高效的体验。所以说，我们可以使用这个东西来将我们的环境改变成 Linux 的，说干咱就干！

第三步：使用 WSL 重新部署 Claude Code

1、按照以下步骤安装 WSL

安装之前需要打开虚拟化，否则过程中会出现未知的错误。

打开路径：控制面板 -> 程序与功能 -> 打开或关闭 Windows 功能 启动以下功能：

Virtual Machine Platform（虚拟机平台）
Windows Subsystem for Linux Support（WSL1）

接下来就是 安装对应版本的 WSL ，选择和系统相符的版本，复制到浏览器中进行下载 WSL 安装包：

64-Bit WSL-2.5.9.0 [推荐]

bash 复制代码

https://vip.123pan.cn/1831946356/links/wsl.2.5.9.0.x64.msi

ARM64 WSL-2.5.9.0

bash 复制代码

https://vip.123pan.cn/1831946356/links/wsl.2.5.9.0.arm64.msi

ARM64_MicrosoftStore WSL-2.5.9.0

bash 复制代码

https://vip.123pan.cn/1831946356/links/Microsoft.WSL_2.5.9.0_x64_ARM64.msixbundle

你也可以不用上面的安装包，直接访问 GitHub 安装最新的版本：

github.com/microsoft/W...

2、下载安装虚拟机

这里我们用到的是 Ubuntu，在安装完 WSL 之后，我们可以在微软应用商店中安装最新的 Ubuntu 或者直接通过命令安装：

bash 复制代码

wsl --install -d Ubuntu-24.04

也可通过 wsl -l -o 命令选择其他系统版本。

安装完 Ubuntu 之后，你可以在终端（或PowerShell） 输入wsl访问安装的操作系统：

首次用需要设置用户名和密码：

如果您通过开始菜单的应用访问一次，直接关闭窗口而不输入用户名和密码，下次访问将使用root用户

Windows将安装的操作系统虚拟机视作一个应用，如Ubuntu 24.04 LTS 会出现在你的开始菜单

3、安装 Claude Code

完成上面步骤之后，我们再次运行安装命令：

bash 复制代码

npm install -g @anthropic-ai/claude-code

会发现还是报错，又是因为什么呢？我们可以进入到 Claude 文档中找寻答案，

所以官方也告诉我们原因了，我们的 WSL 环境正在使用的是 Windows 安装的 Node.js，解决这个问题也简单，我们在 WSL 环境中使用由 Linux 发行的包管理器或者 nvm 安装 Node。下面是详细步骤：

在 WSL 中安装 NVM（Node 版本管理器）：

bash 复制代码

sudo apt-get install curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

关闭并重新打开终端，或运行：
bash 复制代码
```
source ~/.bashrc
```
使用 NVM 安装 Node.js：
bash 复制代码
```
nvm install node
```
验证 Node.js 是否安装在 Linux 环境中：
bash 复制代码
```
which npm
```
应该显示：/home/username/.nvm/versions/node/vX.X.X/bin/npm
现在通过此 Node.js 安装来安装软件包：
bash 复制代码
```
npm config set os linux
npm install -g @anthropic-ai/claude-code
```

按照以上步骤安装完毕之后，接下来就得使用我们在第一步所获得的 API 口令了。

4、输入 API 口令，启动 Claude Code

安装完成之后，我们将第一步获取到的 API 口令复制一份，按照以下命令输入到终端中：

bash 复制代码

export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_BASE_URL=https://anyrouter.top
claude

将成上面的 ...替换成口令中以sk开头后面的字段，当然这种得每次输入口令和地址才能运行，为了避免这种情况，我们采用持久化配置：

bash 复制代码

echo "export ANTHROPIC_AUTH_TOKEN=sk-..." >> ~/.bashrc
echo "export ANTHROPIC_BASE_URL=https://anyrouter.top" >> ~/.bashrc
source ~/.bashrc

到这里就大功告成了，我们打开 Ubuntu ，输入命令：

bash 复制代码

claude

就可以运行起来了，运行后

选择你喜欢的主题 + Enter
确认安全须知 + Enter
使用默认 Terminal 配置 + Enter
信任工作目录 + Enter

第四步：在 VSCode 中运行Claude Code

部署完成之后，我们就能在 Ubuntu 终端中，运行Claude Code，可是我觉得这样使用很不方便，还记得我开篇说的在 VSCode 中就有Claude Code这么一个插件，所以我们可以直接在 VSCode 中使用。我们打开 VSCode ，在插件市场中下载两个插件，第一个就是Claude Code，另一个是 WSL 插件。

其实有很多种方法在 VSCode 中打开并使用 Claude Code，比如：找到我们所需要使用 Claude Code协助的项目，在项目的根路径下，打开 Ubuntu 终端，并输入 code . 命令，就能直接打开 VSCode ，且之前安装的两个插件都正常运行起来，如果需要重新加载插件的话，点击重新加载就可以了，打开之后，可以在 VSCode 最左下角和右上角的部位看到两个插件运行起来的证明。

还有直接在终端中切到自己项目所在的路径下，通过同样的方式，输入 code . 命令，就能直接打开 VSCode ，或者直接打开 VSCode，在最左边的tab栏中，点击这个

选择 WSL ，然后选择环境 Ubuntu ，创建远程连接之后，再从 VSCode 中打开项目，一样能够使用Claude Code。

在 VSCode 中使用Claude Code非常简单方便，直接点击上面图片中 Claude 的logo就可以了，直接弹出对话框，正常输入需求就可以了。

尾声

到这里，在 VSCode 中使用 Claude Code 的教程就结束了，更详细的使用教程可以去anthropic官网查询，也可以在这个文档中查看。部署的步骤和过程确实很繁琐，有不嫌麻烦的小伙伴可以去尝试尝试，遇到什么问题也可以在评论区讨论讨论，谢谢大家。