安装 Claude Code

Cluade Code

Claude Code，一个由Anthropic开发的智能编程工具。

• 官方文档：https://docs.anthropic.com/zh-CN/docs/claude-code/overview
• 官方推荐的最佳实践：https://www.anthropic.com/engineering/claude-code-best-practices

在Windows安装

WSL

WSL，Windows Subsystem for Linux。

在Windows系统上，目前Claude Code只能通过WSL运行，所有的安装也都必须在WSL上。

安装

开启及设定PowerShell

以管理员身份运行PowerShell。

更改PowerShell的执行策略，允许执行本地脚本：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

安装WSL

检查是否已安装WSL：

wsl --list --verbose

查看可选择的Linux列表：

wsl --list --online

在本文，我们选择Ubuntu-24.04：

wsl --install Ubuntu-24.04

安装过程会要求我们设定Linux用户名和密码。

在WSL中安装Node.js和npm

可以PowerShell中输入wsl进入WSL；或者，可以通过如下的方式进入WSL。

更新包列表：

sudo apt update

升级包(可选)：

sudo apt upgrade

安装Node.js和npm：

sudo apt install nodejs npm

确认安装成功：

node --version
npm --version

关于该部分，可以参考《Linux操作系统使用入门：4.Ubuntu》

配置npm全局安装目录

为避免权限问题(npm无法在系统目录中创建文件)，我们需要更改npm全局安装目录：

从Windows的系统目录切换到Linux目录：

cd

创建新的全局安装路径：

mkdir ~/.npm-global

设定npm使用新路径：

npm config set prefix '~/.npm-global'

将上述路径加到PATH：

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

更新环境：

source ~/.bashrc

安装Claude Code

安装Claude Code：

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

确认安装成功：

claude --version

登录

在WSL下，输入claude启动，第一次进入会出现登录画面，接着按Enter登录。

Claude Code会给我们一行网址，在浏览器中打开，按下授权后会生成一组code(92个英文字母数字标点符号组成)，然后再回来WSL粘贴登录。

使用

1. 打开PowerShell，输入wsl进入WSL环境。
2. 切换到工作目录。
3. 输入claude，启动Claude Code。
4. 完成后，输入exit或按Ctrl+C退出Claude Code。
5. 输入exit退出WSL，回到 PowerShell。

WSL中的Claude Code可以访问挂载在/mnt/下的Windows文件系统，例如：

• C盘：/mnt/c/
• D盘：/mnt/d/

代理

需要打开TUN Mode，并把Terminal关掉，重新开启。才能在WSL中使用代理。

如果依旧有问题，考虑在"WSL Setting"的"网络"中，设置网络模式如下

在Linux和Mac安装

Claude Code 原生支持Linux和Mac系统。

安装命令：

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

关于Node.js的安装，可以参考《基于JavaScript的前端开发入门：4.Node.js》

双持(Cursor)

对于Windows，需要基于WSL双持。

对于Linux和Mac，一般只需要在默认的"Terminal"输入命令"claude"。