将ClaudeCode放到Cursor使用，完整配置安装指南！

# WSL + Claude Code + Cursor 完整安装指南 本指南将引导您完成在 Windows 上设置专业开发环境所需的所有步骤。WSL + Claude Code + Cursor 完整安装指南

本指南将引导您完成在 Windows 上设置专业开发环境所需的所有步骤。

阶段一：Windows 准备工作

目标：启用WSL和虚拟机功能，并为WSL2的安装做好准备。

1.以管理员身份打开PowerShell：

在开始菜单中搜索"PowerShell"。右键点击"WindowsPowerShell"，然后选择“以管理员身份运行”。

1. 在PowerShell中执行以下命令以启用WSL和虚拟机平台：

启用“适用于Linux的windows子系统"功能dism.exe /online /enable- feature /featurename:Microsoft- windows- Subsystem- Linux /all/norestart

启用“虚拟机平台”功能dism.exe /online /enable- feature /featurename:VirtualMachinePlatform /all /norestart

3.重启您的电脑以使更改生效：

shutdown /r/t0

阶段二：WSL2安装

目标：安装WSL2和Ubuntu发行版

1. 重启后，再次以管理员身份打开PowerShell。

2. 执行以下命令来安装WSL2和默认的Ubuntu发行版：

ws1- - install

如果上述命令无效，可以尝试指定Ubuntu版本：

ws1- - install - d ubuntu- 22.04

1. 再次重启Windows。

2. 重启后，打开PowerShell并验证WSL版本：

查看已安装的WSL发行版及其版本ws1 - - list - - verbose# 或者使用简写ws1 - 1 - v

确保在VERSION列下看到的是2。

1. 如果版本显示为1，请将其升级到WSL2：

将WSL2设置为默认版本ws1 - - set- default- version 2

将您已安装的Ubuntu转换为WSL2ws1 - - set- version ubuntu- 22.04 2

1. 完成Ubuntu设置：

首次运行Ubuntu时，系统会提示您创建一个新的UNIX用户名和密码。请务必记住它们。

阶段三：在WSL中安装开发工具

目标：在您的Ubuntu环境中安装所有必需的开发工具。

步骤：

在您的WSL/Ubuntu终端中执行以下所有命令。

1. 更新Ubuntu包列表并安装基础工具：

安装 Gitsudo apt updatesudo apt install git - y

安装 curlsudo apt install curl - y

安装编译工具sudo apt install build- essential - y

安装Python3的pip和venvsudo apt install python3- pip python3- venv - y

2.配置Git：

git config - - global user.name "您的名字" git config - - global user.email "您的邮箱地址" git config - - global init.defaultBranch main git config - - global color.ui auto git config - - global pull.rebase false

3.安装pyenv（用于管理Python版本）及其依赖：

安装pyenv的依赖项

sudo apt install make build- essential libssl- dev zlib1g- dev\ libbz2- dev libreadline- dev libsqlite3- dev wget curl 11vm\ libncursesw5- dev xz- utils tk- dev libxml2- dev libxmlsec1- dev\ libffi- dev liblzma- dev - y

安装pyenv

curlhttps://pyenv.run|bash

将pyenv添加到您的shell配置中echo'exportPYENV_ROOT $\equiv$ "\ $HOME/.pyenv" >>\~/.bashrcecho'command - v pyenv > / dev / null | | export PATH$ \equiv $"PYENV_ROOT / bin:$ PATH" >\~/.bashrcechoeval"\$(pyenv init - )">>\~/.bashrc

重新加载shell配置source \~/.bashrc

安装指定版本的Python并设置为全局版本pyenv install 3.11.8pyenv global 3.11.8

4.安装nvm（用于管理Node.js版本）：

安装nvmcurl - o- https://raw.githubusercontent.com/nvm- sh/nvm/v0.39.0/install.sh | bash

重新加载shell配置source \~/.bashrc

安装最新的长期支持版（LTS）Node.js并使用它nvm install - - ltsnvm use - - lts

阶段四：Cursor安装与配置

目标：安装CursorIDE并配置其与WSL的集成

1. 在Windows上安装Cursor：从官方网站下载并安装。

2. 安装Cursor扩展：打开Cursor，转到扩展市场，并安装以下扩展：

Remote- WSL Remote Development o Python o Prettier

阶段五：设置开发结构

目标：在WSL中创建一个有组织的目录结构来存放您的项目。

1.创建目录结构：

1. 创建目录结构：# 创建主开发目录和子目录mkdir -p ~/dev/{projects, tools, workspace, templates}mkdir -p ~/dev/projects/{python-projects, js-projects, ai-automation}

2.验证目录是否创建成功：

ls - la \~/dev/ ls - la \~/dev/projects/

3.设置有用的别名（可选但推荐）：

使用nano编辑器打开.bashrc文件nano $\sim /$ .bashrc

在文件末尾添加以下别名：

alias dev='cd ~/dev/projects'alias tools='cd ~/dev/tools'alias py='cd ~/dev/projects/python- projects'alias js='cd ~/dev/projects/js- projects'

按 $\mathbb{C}tr\mathbb{I} + \mathbb{X}$ ，然后按Y和Enter保存并退出。

4.重新加载shell配置以使别名生效：

source $\sim /$ .bashrc

现在，您可以使用dev、py等命令快速切换目录。

阶段六：配置NPM无需sudo

目标：配置npm以便在不使用sudo的情况下全局安装包。

步骤：

设置 npm 的全局安装目录npm config set prefix ~/.npm- global'

将该目录添加到您的PATH中echo 'export PATH=- ~/.npm- global/bin:(PATH' >> ~/.bashrc

重新加载shell配置source ~/.bashrc

阶段七：ClaudeCode安装

目标：安装ClaudeCode命令行工具

切换到您的项目目录cd \~ /dev/projects

注意～以下A/B要二选一#A.全局安装ClaudeCode[这个是官方的]，你有官方Claude账号就用这个指令

npm install - g claude- code

B.全局安装ClaudeCode[这个是中转站的]，如果是中转站用户，选这个指令！Claude Code国内镜像使用教程：http://h5ma.cn/bxa

npm install - g https://gaccode.com/claudecode/install --registry=https://registry.npmmirror.com

运行claude- code进行设置claude- code

首次运行时，它会引导您完成一些设置，建议选择推荐选项

中转Claude Code国内镜像使用教程：http://h5ma.cn/bxa（主用）

中转Claude Code国内镜像使用教程：http://c8a.cn/KAHFp（主用）

阶段八：测试Cursor-WSL集成

目标：确保Cursor可以成功连接到您的WSL环境

步骤：

1. 打开Cursor。2.点击左下角的绿色远程窗口图标。3.从下拉菜单中选择"ConnecttoWSL"。4.选择您的Ubuntu发行版。5.一个新的Cursor窗口将会打开，它现在正运行在您的WSL环境中。您可以通过"File" $>$ "OpenFolder"来打开您在WSL中的项目文件夹（例如\~/dev/projects）。

阶段九：将ClaudeCode连接到Cursor

目标：确保ClaudeCode能够与您的CursorIDE通信。

步骤：

1. 在连接到 WSL 的 Cursor 终端中，启动 Claude Code。2. Claude Code 应该会自动检测到正在运行的 IDE (Cursor) 并连接。3. 按照 Claude Code 的指示在 Cursor 中进行测试，以验证其功能是否正常。

阶段十：完成测试

目标：验证所有工具是否已正确安装并可以正常工作。

步骤：

1. 检查所有工具的版本：

git - - versionpython - - versionnode - - versionnpm - - versionpyenv - - versionnvm - - version

1. 检查可执行文件的路径：

which python which node

1. 测试 Python 虚拟环境：

切换到项目目录cd $\sim$ /dev/projects/python- projects#创建测试项目mkdir test- python &&cd test- python#创建虚拟环境python - m venv venv#激活虚拟环境source venv/bin/activate#检查Python版本和已安装的包python - - versionpip list#停用虚拟环境deactivate#删除测试项目cd .. && rm - rf test- python

1. 测试 Node.js 项目：

切换到项目目录cd \~/dev/projects/js- projects#创建测试项目mkdir test- node && cd test- node# 初始化 npm 项目npm init - y# 安装一个包npm install express# 列出已安装的包npm list# 删除测试项目cd .. && rm - rf test- node