Windows安装Claude Code全流程

撒币使我快乐
282 阅读3分钟

这里不赘述账号申请，很多网上很多资料了。在 Windows 系统上使用 Claude Code，主要有两种官方推荐的路径：一种是利用 Windows 自带的 Linux 子系统（WSL），另一种是尝试通过 PowerShell 直接安装。此外，你也可以选择将其功能集成到 VS Code 编辑器中使用。这里我们使用第一种，因为这是目前最稳定、被广泛验证的方式。

  1. 启用并安装 WSL：
    • 以管理员身份打开 PowerShell。
    • 依次执行以下命令： 
      dism.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
  2. 处理网络问题方法
    1. 诊断DNS解析问题
    • 按Win + R输入cmd回车打开命令行工具，执行 ping raw.githubusercontent.com 获取IP地址（如 185.199.110.133）
    1. 修改Hosts文件

    • 使用IDE（需管理员权限）编辑 C:\Windows\System32\drivers\etc\hosts

    • 添加行：185.199.110.133 raw.githubusercontent.com

    1. 刷新DNS缓存
    • 在PowerShell中执行：ipconfig /flushdns
    1. 重新执行wsl --install
    • 执行命令并设置WSL用户名和密码
  3. 在 WSL 中安装 Node.js：
    • 从开始菜单打开你安装的 Linux 发行版（如 Ubuntu）。
    • 首先更新系统包并安装 Node.js（如果未安装）： 
      sudo 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）
  4. 安装Claude Code 
    npm install -g @anthropic-ai/claude-code
    如果安装过程中出现权限错误，你可能需要以管理员权限运行（使用sudo）或者配置npm的全局安装目录为当前用户有写权限的目录。但是，使用sudo安装可能会带来其他问题，因此更推荐配置npm的全局安装目录到当前用户目录下。
  5. 配置npm的全局安装目录到当前用户目录下 
    # 配置npm使用用户目录，避免权限问题
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

# 将用户bin目录添加到PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 现在安装Claude Code
npm install -g @anthropic-ai/claude-code
  6. 将ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL写入~/.bashrc
    在Ubuntu中，使用vim命令修改~/.bashrc 
    vim ~/.bashrc
    将如下内容写入~/.bashrc，注意将xxxx替换为自己的ANTHROPIC_AUTH_TOKEN，将ANTHROPIC_BASE_URL替换为自己的ANTHROPIC_BASE_URL 
    # Claude Code 环境变量
export ANTHROPIC_AUTH_TOKEN=xxxx
export ANTHROPIC_BASE_URL=xxx
    立即重新加载并执行当前用户的~/.bashrc 配置文件，后续如果遇到需要输入/login登录的场景可以执行一下完成登录 
    source ~/.bashrc
  7. 科学上网
  8. 使用Claude Code
    在Ubuntu中，输入claude即可启动
  9. 如果遇到接口400，Ctrl + C两次退出 007.png 再次进入，按下Tab关闭think mode 即可 996.png
avatar
文章
阅读
粉丝