Windows 安装 - Claude Code

💡

下面是手动安装步骤，如果您觉得麻烦，我们编写了自动化安装脚本，您可以点击下载自动安装：点我前往下载

第一步：安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

方法一：官网下载（推荐）

打开浏览器访问 https://nodejs.org/

点击 "LTS" 版本进行下载（推荐长期支持版本）

下载完成后双击 .msi 文件

按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

# 使用 Chocolatey
choco install nodejs
# 或使用 Scoop
scoop install nodejs

📌

Windows 注意事项
• 建议使用 PowerShell 而不是 CMD
• 如果遇到权限问题，尝试以管理员身份运行
• 某些杀毒软件可能会误报，需要添加白名单

📌

验证安装是否成功
安装完成后，打开 PowerShell 或 CMD，输入以下命令：

如果显示版本号，说明安装成功了！

第二步：安装 Git Bash

Windows 环境下需要使用 Git Bash 安装Claude code。安装完成后，环境变量设置和使用 Claude Code 仍然在普通的 PowerShell 或 CMD 中进行。

下载并安装 Git for Windows

访问 https://git-scm.com/downloads/win

点击 "Download for Windows" 下载安装包

运行下载的 .exe 安装文件

在安装过程中保持默认设置，直接点击 "Next" 完成安装

📌

安装完成之后
• 在任意文件夹右键可以看到 "Git Bash Here" 选项
• 也可以从开始菜单启动 "Git Bash"
• 只需要在 Git Bash 中运行 npm install 命令
• 后续的环境变量设置和使用都在 PowerShell/CMD 中

📌

验证安装是否成功
打开 Git Bash，输入以下命令验证：

如果显示 Git 版本号，说明安装成功！

第三步：安装 Claude Code

打开 Git Bash（重要：不要使用 PowerShell），运行以下命令：

这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。

📌

重要提醒
• 必须在 Git Bash 中运行，不要在 PowerShell 中运行
• 如果遇到权限问题，可以尝试在 Git Bash 中使用 sudo 命令

📌

验证 Claude Code 安装
安装完成后，输入以下命令检查是否安装成功：

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

第四步：配置 Claude Code 环境变量

为了让 Claude Code 连接到服务，需要设置两个环境变量：

方法一：PowerShell 临时设置（推荐）

在 PowerShell 中运行以下命令：

💡 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。

方法二：系统环境变量（永久设置）

右键"此电脑" → "属性" → "高级系统设置"

点击"环境变量"按钮

在"用户变量"或"系统变量"中点击"新建"

添加以下两个变量：

📌

验证环境变量设置

设置完环境变量后，可以通过以下命令验证是否设置成功：

在 PowerShell 中验证：

在 CMD 中验证：

预期输出示例：

cr_xxxxxxxxxxxxxxxxxx

💡 如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置。

第五步：开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code

在特定项目中使用