WSL部署指南

Claude Code于2025-05-23更新了VSCode/JetBrains插件功能🎉🎉🎉🎉

Claude 4 已经更新，目前Claude Code可以通过/model切换到该模型🎉🎉🎉🎉

我们强烈推荐在Ubuntu，MacOS 上使用Claude Code

本文档要求您具备基础的Linux使用经验，VSCode Remote-SSH 插件使用经验，您可以向ChatGPT寻求帮助

Claude Code for Windows当前不受支持，但您仍可以通过WSL在Windows上部署：

WSL （Windows Subsystem for Linux），微软开源的Linux on Windows框架。
由于 Claude Code 并不支持 Windows 的文件系统，您不能在Windows的文件系统内部署。建议您的操作均基于WSL安装的虚拟操作系统（如 Ubuntu 24.04 LTS）

安装WSL，必须满足以下要求：

Windows 11 Pro/Workstation/Enterprises（非家庭版，需支持Hyper-V）
已在 BIOS/UEFI 中启用虚拟化
在终端执行以下命令安装WSL：

wsl --install

安装后，您可以在微软应用商店中安装Ubuntu 24.04 LTS（我们强烈推荐此发行版）
安装后，您可以在终端输入wsl访问安装的操作系统。
- 首次用需要设置用户名和密码
- 如果您通过微软商店访问一次，直接关闭窗口而不输入用户名和密码，这将使用root用户
- 您可以通过终端中输入wsl访问安装的发行版，也可以直接打开应用。Windows将安装的操作系统虚拟机视作一个应用，如Ubuntu 24.04 LTS 会出现在您的开始菜单
在进入Linux环境后，您可以通过以下命令安装Node.js和npm

cd ~
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs

在完成安装后，您可以使用以下命令安装我们的Claude Code

sudo npm install -g https://code.gac.zoco.cc/claudecode/install --registry=https://registry.npmmirror.com

您可以在安装后使用以下命令直接使用Claude Code，他将访问您的当前位置

claude

- 当您首次使用时，Claude Code要求您输入验证码。您需要访问命令行中提供的链接登录并获取，并输入命令行以完成验证。
- - 您可以通过此链接访问您的账户：Login - Claude Code
对于Windows本身的文件系统，您可以通过以下命令访问。WSL将您的每个磁盘视为/mnt/下的一个文件夹

cd /mnt/

如果您需要跨文件系统编辑文件，建议您为Claude Code添加以下记忆：

> # 请注意，你运行在WSL中。如果有需要保存文件的操作，通过/mnt/目录访问Windows文件系统。

如果您需要访问 WSL 的文件系统，您可以通过资源管理器访问以下目录实现：

\\wsl.localhost\

我们十分不推荐直接跨文件系统传输文件并跨平台运行，这可能导致一些意外的bug。
验证您的安装，在打开Claude Code后输入以下命令将会为当前目录下的项目生成Claude.md

/init

对于Claude Code IDE插件在WSL上的使用：

在 v1.0.2 或更高版本，您可以在IDE的终端中使用/ide连接到IDE
对于官方文档，您可以详细参考：IDE integrations - Anthropic
Claude Code 插件支持VSCode，JetBrains。
如果您在本地使用Linux/MacOS，您可以直接连接到插件，插件在VSCode会被自动安装，在JetBrains中需要在商店中搜索并安装。
如果您使用Windows 11或远程的Linux服务器，您可以参考以下文档来使用这一插件：
在WSL中，您可能习惯使用code .命令来启动VSCode，您需要安装WSL插件才能启用
如果您使用请您在VSCode的插件商店搜索
我们推荐您使用SSH连接到WSL，通过OpenSSH-Server来连接到WSL
您在使用WSL时可能需要连接代理，推荐您使用以下配置文件
您需要创建并将以下内容写入到C:/Users/您的用户名/.wslconfig

[wsl2]
networkingMode=mirrored   # or bridged
autoProxy=false            # optional for Windows proxy forwarding
dnsTunneling=true         # optional for VPN
ipv6=true

如果您连接成功，现在可以在VSCode的内置终端输入以下命令来访问Claude，插件将自动安装

claude

您可能需要在Claude Code的交互界面中输入以下内容来指定IDE

> /ide

恭喜您！如果您完成了部署，在VSCode右上角将看到标志性的Claude图标，您可以点击该图标来运行Claude Code。

PreviousClaude Code Next计费与订阅

Last updated 3 days ago

WSL部署指南

Claude Code于2025-05-23更新了VSCode/JetBrains插件功能🎉🎉🎉🎉

Claude 4 已经更新，目前Claude Code可以通过/model切换到该模型🎉🎉🎉🎉

我们强烈推荐在Ubuntu，MacOS 上使用Claude Code

本文档要求您具备基础的Linux使用经验，VSCode Remote-SSH 插件使用经验，您可以向ChatGPT寻求帮助

Claude Code for Windows当前不受支持，但您仍可以通过WSL在Windows上部署：

WSL （Windows Subsystem for Linux），微软开源的Linux on Windows框架。
由于 Claude Code 并不支持 Windows 的文件系统，您不能在Windows的文件系统内部署。建议您的操作均基于WSL安装的虚拟操作系统（如 Ubuntu 24.04 LTS）

安装WSL，必须满足以下要求：

Windows 11 Pro/Workstation/Enterprises（非家庭版，需支持Hyper-V）
已在 BIOS/UEFI 中启用虚拟化
在终端执行以下命令安装WSL：

wsl --install

安装后，您可以在微软应用商店中安装Ubuntu 24.04 LTS（我们强烈推荐此发行版）
安装后，您可以在终端输入wsl访问安装的操作系统。
- 首次用需要设置用户名和密码
- 如果您通过微软商店访问一次，直接关闭窗口而不输入用户名和密码，这将使用root用户
- 您可以通过终端中输入wsl访问安装的发行版，也可以直接打开应用。Windows将安装的操作系统虚拟机视作一个应用，如Ubuntu 24.04 LTS 会出现在您的开始菜单
在进入Linux环境后，您可以通过以下命令安装Node.js和npm

cd ~
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs

在完成安装后，您可以使用以下命令安装我们的Claude Code

sudo npm install -g https://code.gac.zoco.cc/claudecode/install --registry=https://registry.npmmirror.com

您可以在安装后使用以下命令直接使用Claude Code，他将访问您的当前位置

claude

- 当您首次使用时，Claude Code要求您输入验证码。您需要访问命令行中提供的链接登录并获取，并输入命令行以完成验证。
- - 您可以通过此链接访问您的账户：Login - Claude Code
对于Windows本身的文件系统，您可以通过以下命令访问。WSL将您的每个磁盘视为/mnt/下的一个文件夹

cd /mnt/

如果您需要跨文件系统编辑文件，建议您为Claude Code添加以下记忆：

> # 请注意，你运行在WSL中。如果有需要保存文件的操作，通过/mnt/目录访问Windows文件系统。

如果您需要访问 WSL 的文件系统，您可以通过资源管理器访问以下目录实现：

\\wsl.localhost\

我们十分不推荐直接跨文件系统传输文件并跨平台运行，这可能导致一些意外的bug。
验证您的安装，在打开Claude Code后输入以下命令将会为当前目录下的项目生成Claude.md

/init

对于Claude Code IDE插件在WSL上的使用：

在 v1.0.2 或更高版本，您可以在IDE的终端中使用/ide连接到IDE
对于官方文档，您可以详细参考：IDE integrations - Anthropic
Claude Code 插件支持VSCode，JetBrains。
如果您在本地使用Linux/MacOS，您可以直接连接到插件，插件在VSCode会被自动安装，在JetBrains中需要在商店中搜索并安装。
如果您使用Windows 11或远程的Linux服务器，您可以参考以下文档来使用这一插件：
在WSL中，您可能习惯使用code .命令来启动VSCode，您需要安装WSL插件才能启用
如果您使用请您在VSCode的插件商店搜索
我们推荐您使用SSH连接到WSL，通过OpenSSH-Server来连接到WSL
您在使用WSL时可能需要连接代理，推荐您使用以下配置文件
您需要创建并将以下内容写入到C:/Users/您的用户名/.wslconfig

[wsl2]
networkingMode=mirrored   # or bridged
autoProxy=false            # optional for Windows proxy forwarding
dnsTunneling=true         # optional for VPN
ipv6=true

如果您连接成功，现在可以在VSCode的内置终端输入以下命令来访问Claude，插件将自动安装

claude

您可能需要在Claude Code的交互界面中输入以下内容来指定IDE

> /ide

恭喜您！如果您完成了部署，在VSCode右上角将看到标志性的Claude图标，您可以点击该图标来运行Claude Code。

PreviousClaude Code Next计费与订阅

Last updated 3 days ago