Skip to content

WSL2 安装 Claude CLI 进度记录

当前状态:未完成


已完成的步骤

  1. Node.js 安装

    • 在 WSL2 Ubuntu 24.04 里安装了 Node.js v18.19.1
    • Linux npm 路径:/usr/bin/npm
  2. 发现代理问题 ⚠️

    • WSL2 里不能直接用 127.0.0.1:10808
    • Windows 主机 IP 是 172.17.0.1
    • 但代理默认只监听 Windows 的 127.0.0.1,WSL2 连不上
    • 加了端口转发规则也没解决(可能防火墙拦截)
  3. 发现替代方案

    • Windows 已安装 claude.exe,路径: C:\Users\Administrator\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code\bin\claude.exe
    • 在 WSL2 里可以直接调用这个 .exe: /mnt/c/Users/Administrator/AppData/Roaming/npm/node_modules/@anthropic-ai/claude-code/bin/claude.exe --version
    • 返回正常:2.1.150 (Claude Code)

下次继续的步骤

方案A:用包装脚本(推荐,5分钟)

在 WSL2 里执行:

bash
sudo tee /usr/local/bin/claude > /dev/null << 'SCRIPT'
#!/bin/bash
exec '/mnt/c/Users/Administrator/AppData/Roaming/npm/node_modules/@anthropic-ai/claude-code/bin/claude.exe' "$@"
SCRIPT
sudo chmod +x /usr/local/bin/claude

然后验证:

bash
claude --version

完成后就可以在 WSL2 里直接用 claude 命令了。

方案B:修复代理后原生安装(稍复杂)

需要让 Windows 代理监听所有网卡(0.0.0.0:10808), 或在 Windows 防火墙放行 WSL2 访问 172.17.0.1:10808, 然后再运行:

bash
export HTTP_PROXY=http://172.17.0.1:10808
export HTTPS_PROXY=http://172.17.0.1:10808
/usr/bin/npm install -g @anthropic-ai/claude-code

配置好后的使用方式

bash
wsl                          # 进入 WSL2
tmux attach || tmux new -s main   # 开启 tmux
cd /mnt/f/project            # 进入项目目录
claude                       # 启动 Claude

个人科研与运维文档 · 内容持续修订