Claude Code 完整安装指南

Claude Code Windows 完整安装指南

本文档整合了 Claude Code 在 Windows 系统上的完整安装流程，包括环境准备、安装步骤、常见问题解决及 VS Code 插件配置。

文档版本: 2026 年 3 月
适用系统: Windows 10/11

目录

  1. 系统要求
  2. 安装流程概览
  3. 详细安装步骤
  4. [PowerShell 执行策略配置](#4-powershell 执行策略配置)
  5. [VS Code 插件安装](#5-vs-code 插件安装)
  6. 常见问题解决
  7. 快速命令参考

1. 系统要求

在开始安装之前，请确保您的系统满足以下要求：

组件 要求 说明
操作系统 Windows 10/11 64 位系统推荐
Node.js v18+ 或 v20+ LTS 包含 npm 包管理器
Git 最新版 包含 git-bash

2. 安装流程概览

┌─────────────────────────────────────────────────────────┐
│  Claude Code Windows 安装流程                            │
├─────────────────────────────────────────────────────────┤
│  1. 安装 Node.js + npm  ───────────────────►  5 分钟    │
│  2. 安装 Git（含 git-bash）─────────────────►  5 分钟    │
│  3. 配置环境变量 CLAUDE_CODE_GIT_BASH_PATH ─►  2 分钟    │
│  4. 创建配置目录 ~/.claude ────────────────►  1 分钟    │
│  5. 安装 Claude Code（npm install）─────────►  5 分钟    │
│  6. 配置 PowerShell 执行策略 ──────────────►  1 分钟    │
│  7. 验证安装 ──────────────────────────────►  1 分钟    │
└─────────────────────────────────────────────────────────┘

3. 详细安装步骤

步骤 1：安装 Node.js 和 npm

Claude Code 依赖 npm 进行安装，因此需要先安装 Node.js。

下载地址

访问 Node.js 官方下载页面：https://nodejs.org/zh-cn/download/

安装步骤

  1. 选择 Windows 安装程序 (.msi)，推荐下载 LTS 长期支持版（如 20.x 版本）

    • 64 位系统选择：node-v20.x.x-x64.msi
    • 32 位系统选择：node-v20.x.x-x86.msi

  2. 双击下载的安装包，按以下步骤完成安装：

    • 勾选 "I accept the terms in the License Agreement"，点击 Next
    • 选择安装路径（默认 C:\Program Files\nodejs\ 即可），点击 Next
    • 关键：确保以下选项已勾选（默认已勾选）：
      • Node.js runtime
      • npm package manager
      • Add to PATH
    • 无需勾选 "Tools for Native Modules"，直接点击 Install
    • 安装完成后点击 Finish

验证安装

打开命令提示符（CMD）或 PowerShell，执行以下命令：

node -v    # 检查 Node.js 版本
npm -v     # 检查 npm 版本

如果能输出版本号（如 v20.11.1 和 10.2.4），说明安装成功。

步骤 2：安装 Git（含 git-bash）

Claude Code 在 Windows 上运行需要依赖 git-bash。

下载地址

访问 Git 官方下载页面：https://git-scm.com/downloads/win

安装步骤

  1. 双击下载的安装包，一路点击 Next，使用默认配置即可
  2. 关键：确保以下选项已勾选：
    • Add Git to PATH
    • Install Git Bash Here

查找 git-bash 路径

安装完成后，找到 bash.exe 的路径（记下来备用）：

  • 64 位系统默认路径：C:\Program Files\Git\bin\bash.exe
  • 32 位系统默认路径：C:\Program Files (x86)\Git\bin\bash.exe

验证路径：打开文件资源管理器，粘贴上述路径，确认 bash.exe 存在。

步骤 3：配置环境变量

Claude Code 需要通过环境变量找到 git-bash。

设置环境变量 CLAUDE_CODE_GIT_BASH_PATH

  1. 按下 Win + R，输入 sysdm.cpl，回车打开「系统属性」
  2. 切换到「高级」选项卡，点击「环境变量」
  3. 在「用户变量」区域点击「新建」：
    • 变量名：CLAUDE_CODE_GIT_BASH_PATH
    • 变量值：git-bash 路径（如 C:\Program Files\Git\bin\bash.exe）
  4. 点击「确定」保存所有设置

验证环境变量配置

关闭所有已打开的终端/程序，重新打开 CMD，执行以下命令：

echo %CLAUDE_CODE_GIT_BASH_PATH%

如果输出你设置的 bash.exe 路径，说明配置成功。

步骤 4：创建配置目录（可选但推荐）

Claude Code 会使用用户目录下的 .claude 文件夹作为配置目录。

打开 CMD，执行以下命令自动创建：

if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"

验证：打开「此电脑」→ C:\Users\你的用户名，可以看到 .claude 文件夹。

步骤 5：安装 Claude Code

配置 npm 镜像（可选，加速下载）

如果 npm 下载速度慢，可配置淘宝镜像：

npm config set registry https://registry.npmmirror.com

安装命令

打开 CMD 或 PowerShell，执行以下命令：

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

-g 参数表示全局安装，推荐。

安装成功后，会看到类似以下输出：

added 2 packages in 4s

1 package is looking for funding
  run `npm fund` for details

忽略以下提示（不影响使用）：

  • 1 package is looking for funding - 包的公益提示
  • npm notice New minor version available - npm 版本更新提示

4. PowerShell 执行策略配置

如果在 PowerShell 中运行 claude 命令时出现以下错误：

无法加载文件 xxx.ps1，因为在此系统上禁止运行脚本

需要修改 PowerShell 执行策略。

解决方法

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

    • 按下 Win 键，输入 PowerShell
    • 右键「Windows PowerShell」，选择「以管理员身份运行」

  2. 执行以下命令：

    Set-ExecutionPolicy RemoteSigned

    输入 Y 并回车确认

  3. 验证：
    关闭所有 PowerShell 窗口，重新打开普通 PowerShell，再次运行 claude 命令

执行策略说明

策略 说明 推荐度
Restricted 禁止运行所有脚本（默认） ❌
RemoteSigned 允许本地脚本，远程脚本需签名 ✅ 推荐
Unrestricted 允许所有脚本运行 ❌ 不安全

5. VS Code 插件安装

5.1 安装 VS Code（如未安装）

访问 VS Code 官方下载页面：https://code.visualstudio.com/

5.2 设置 VS Code 中文界面（可选）

  1. 打开 VS Code，点击左侧边栏的「扩展」图标（快捷键 Ctrl+Shift+X）
  2. 搜索 Chinese，找到「Chinese (Simplified) Language Pack for VS Code」
  3. 点击「Install」安装，安装完成后重启 VS Code

5.3 安装 Claude Code 插件

  1. 打开 VS Code，点击左侧边栏的「扩展」图标
  2. 搜索 Claude Code，找到官方插件并安装
  3. 安装完成后，重启 VS Code
  4. 单击右上角 Claude Code 图标开始使用

5.4 配置 API Key（如使用 Coding Plan）

编辑配置文件 C:\Users\你的用户名\.claude\settings.json：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.5-plus"
    }
}

6. 常见问题解决

问题 1：提示「npm 不是内部或外部命令」

原因：Node.js 安装时未勾选「Add to PATH」

解决方法：

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」中找到「Path」，点击「编辑」
  3. 点击「新建」，添加 Node.js 安装路径（默认 C:\Program Files\nodejs\）
  4. 点击「确定」保存，重启命令提示符

问题 2：Linux/Ubuntu 系统安装 npm

如果在 Ubuntu/Debian 系统上遇到 npm: command not found：

# 方案一：使用 apt 安装（推荐）
sudo apt update
sudo apt install -y nodejs npm

# 方案二：使用 NodeSource 源安装最新版
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 方案三：使用 nvm 安装（可指定版本）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm alias default node

问题 3：提示「git-bash 找不到」

原因：环境变量路径错误或 Git 未安装

解决方法：

  1. 确认 bash.exe 路径正确
  2. 重新安装 Git 并勾选「Add to PATH」
  3. 确认环境变量 CLAUDE_CODE_GIT_BASH_PATH 已正确设置

问题 4：PowerShell 禁止运行脚本

原因：PowerShell 默认执行策略为 Restricted

解决方法：
以管理员身份执行以下命令：

Set-ExecutionPolicy RemoteSigned

问题 5：npm 下载速度慢

解决方法：配置淘宝镜像

npm config set registry https://registry.npmmirror.com

问题 6：进入含空格的目录

如果要进入 D:\Program Files (x86)\damoxing 这类含空格的路径：

CMD:

cd /d "D:\Program Files (x86)\damoxing"

PowerShell:

cd "D:\Program Files (x86)\damoxing"

7. 快速命令参考

常用命令速查

命令 说明 示例
node -v 查看 Node.js 版本 node -v
npm -v 查看 npm 版本 npm -v
git --version 查看 Git 版本 git --version
echo %VAR% 查看环境变量 echo %CLAUDE_CODE_GIT_BASH_PATH%
npm install -g 全局安装 npm 包 npm install -g claude-code
claude --version 查看 Claude Code 版本 claude --version
claude --help 查看帮助信息 claude --help
claude 启动 Claude Code claude

VS Code 常用快捷键

快捷键 功能
Ctrl+Shift+X 打开扩展面板
Ctrl+Shift+P 打开命令面板
Ctrl+,` 打开设置

附录：安装检查清单

安装完成后，请确认以下项目：

如果安装过程中遇到任何错误，请提供具体报错信息以便进一步排查。

文档生成日期：2026 年 3 月 23 日

posted @ 2026-03-23 16:52  苏su  阅读(11031)  评论(0)    收藏  举报