这里不赘述账号申请,很多网上很多资料了。在 Windows 系统上使用 Claude Code,主要有两种官方推荐的路径:一种是利用 Windows 自带的 Linux 子系统(WSL),另一种是尝试通过 PowerShell 直接安装。此外,你也可以选择将其功能集成到 VS Code 编辑器中使用。这里我们使用第一种,因为这是目前最稳定、被广泛验证的方式。
-
启用并安装 WSL :
-
以管理员身份打开 PowerShell。
-
依次执行以下命令:
powershelldism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart -
重启电脑使更改生效。
-
重启后,再次以管理员身份打开 PowerShell,执行
wsl --install来安装默认的 Linux 发行版(通常是 Ubuntu)。过程中你需要设置一个 Linux 系统的用户名和密码。
如果这一步提示了如下报错,即使这个链接能通过浏览器打开,也需要处理网络问题
无法从"raw.githubusercontent.com/microsoft/W... 提取列表分发。无法解析服务器的名称或地址
错误代码: Wsl/InstallDistro/WININET_E_NAME_NOT_RESOLVED
-
-
处理网络问题方法
- 诊断DNS解析问题
- 按Win + R输入cmd回车打开命令行工具,执行
ping raw.githubusercontent.com获取IP地址(如185.199.110.133)
- 修改Hosts文件
-
使用IDE(需管理员权限)编辑
C:\Windows\System32\drivers\etc\hosts -
添加行:
185.199.110.133 raw.githubusercontent.com
- 刷新DNS缓存
- 在PowerShell中执行:
ipconfig /flushdns
- 重新执行
wsl --install
- 执行命令并设置WSL用户名和密码
-
在 WSL 中安装 Node.js :
-
从开始菜单打开你安装的 Linux 发行版(如 Ubuntu)。
-
首先更新系统包并安装 Node.js(如果未安装):
bashsudo apt update && sudo apt upgrade -y curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs -
验证Node.js安装,执行:
node --version(成功输出:20.19.5)
-
-
安装Claude Code
bashnpm install -g @anthropic-ai/claude-code -
将ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL写入~/.zshrc
在Ubuntu中,使用vim命令修改~/.zshrcbashvim ~/.zshrc将如下内容写入~/.zshrc,注意将xxxx替换为自己的ANTHROPIC_AUTH_TOKEN,将ANTHROPIC_BASE_URL替换为自己的ANTHROPIC_BASE_URL
bash# Claude Code 环境变量 export ANTHROPIC_AUTH_TOKEN=xxxx export ANTHROPIC_BASE_URL=xxx立即重新加载并执行当前用户的 .zshrc 配置文件,后续如果遇到需要输入
/login登录的场景可以执行一下完成登录bashsource ~/.zshrc -
使用Claude Code
在Ubuntu中,输入claude code即可启动