Windows 系统安装 Claude Code 完整教程

适用于 Windows 10/11 (64位) 系统的 Claude Code 安装指南

系统要求

✅ 操作系统：Windows 10 或 Windows 11（必须是 64 位）

✅ 内存：建议 4GB 以上

✅ 硬盘空间：约 2-4GB

✅ 网络：需要联网进行安装和使用

✅ 权限：需要管理员权限

完整安装步骤

第一步：安装 Git for Windows（必需）

⚠️ 重要：Claude Code 在 Windows 上依赖 Git Bash 运行，必须先安装 Git。

1.1 下载 Git

访问 Git 官网下载页面：

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

点击下载最新的 64 位版本。

1.2 安装 Git

双击下载的安装文件（如 Git-2.51.2-64-bit.exe）

全程使用默认选项，一路点击 "Next"

确保在 "Adjusting your PATH environment" 步骤中选择：

✅ "Git from the command line and also from 3rd-party software"（默认选项）

点击 "Install" 开始安装

完成后点击 "Finish"

1.3 验证 Git 安装

按 Win + R

输入 cmd，按回车

在命令提示符中输入：

✅ 如果显示类似 git version 2.51.2.windows.1，说明安装成功。

第二步：安装 Claude Code

2.1 以管理员身份打开 PowerShell

按 Win 键

输入 powershell

右键点击 "Windows PowerShell"

选择 "以管理员身份运行"

2.2 运行安装命令

在 PowerShell 中复制并运行以下命令：

irm https://claude.ai/install.ps1 | iex

2.3 等待安装完成

安装过程会显示进度信息，完成后会显示：

✅ Installation complete!
Version: 2.0.34
Location: C:\Users\你的用户名\.local\bin\claude.exe

第三步：配置环境变量（添加 PATH）

安装完成后需要将 Claude 添加到系统 PATH，这样才能在任何地方运行 claude 命令。

方法一：图形界面操作（推荐新手）

按 Win + R，输入 sysdm.cpl，按回车

点击 "高级" 标签

点击 "环境变量" 按钮

在 "用户变量" 区域（窗口上半部分），找到并双击 Path

点击 "新建" 按钮

输入：C:\Users\你的用户名\.local\bin

将 你的用户名 替换为实际的 Windows 用户名

依次点击 "确定" 关闭所有窗口

方法二：PowerShell 命令（快速）

在 PowerShell（管理员模式）中运行：

[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Users\$env:USERNAME\.local\bin", "User")

第四步：验证安装

4.1 重启 PowerShell

⚠️ 必须关闭所有 PowerShell 窗口并重新打开，PATH 修改才会生效。

4.2 测试命令

打开新的 PowerShell 窗口，输入：

claude --version

✅ 如果显示版本号（如 2.0.34），说明安装成功！

第五步：配置 API Key

要使用 Claude Code，需要配置 Anthropic 的访问权限。

选项 A：使用 Claude Pro/Max 订阅（推荐）

如果您已订阅 Claude Pro (100/月)：

在项目目录中运行：

claude

按照提示完成 OAuth 登录

选项 B：使用 API 付费

访问 Anthropic Console：https://console.anthropic.com/

登录并设置付费方式

在左侧菜单找到 "API Keys"

点击 "Create Key" 创建新的 API key

复制生成的 API key

在 PowerShell 中运行：

claude config set apiKey

粘贴您的 API key 并按回车

重要注意事项

⚠️ 常见错误及解决方法

错误信息	原因	解决方法
`'claude' 不是内部或外部命令`	PATH 未配置或 PowerShell 未重启	添加 PATH 后必须关闭并重新打开 PowerShell
`Claude Code does not support 32-bit`	使用了 32 位 PowerShell 或系统	确保系统是 64 位，使用 64 位 PowerShell
`requires git-bash`	Git 未安装	必须先安装 Git for Windows
`'claude-code' 不是内部或外部命令`	命令名错误	正确命令是 `claude`，不是 `claude-code`

✅ 关键要点

🔴 命令名是 claude，不是 claude-code

🔴 必须先安装 Git，再安装 Claude Code

🔴 添加 PATH 后必须重启 PowerShell

🔴 PowerShell 必须以管理员身份运行（安装时）

🔴 系统必须是 64 位 Windows

故障排查

问题 1：找不到 `git` 命令

症状：

'git' 不是内部或外部命令

解决方法：

检查 Git 是否已安装

重新安装 Git for Windows

重启计算机后再试

问题 2：找不到 `claude` 命令

症状：

'claude' 不是内部或外部命令

解决方法：

检查是否已添加到 PATH（参考第三步）

关闭所有 PowerShell 窗口后重新打开

使用完整路径测试：

C:\Users\你的用户名\.local\bin\claude.exe --version

问题 3：32 位系统错误

症状：

Claude Code does not support 32-bit Windows

解决方法：

检查系统是否为 64 位：

按 Win + Pause/Break

查看 "系统类型"

确保使用 64 位 PowerShell：

按 Win + R

输入：%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe

问题 4：权限错误

症状：

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

解决方法：

在 PowerShell（管理员模式）中运行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

常用命令

安装完成后，您可以使用以下命令：

# 查看版本
claude --version

# 查看帮助
claude --help

# 在当前目录启动 Claude Code
claude

# 指定模型启动
claude --model claude-sonnet-4-20250514

# 查看配置
claude config list

# 设置 API Key
claude config set apiKey

安装流程图

使用示例

基础使用

# 进入您的项目目录
cd C:\Users\你的用户名\Documents\my-project

# 启动 Claude Code
claude

# Claude 会分析您的项目并等待您的指令
# 您可以用自然语言描述您想做什么

示例对话

> 创建一个 Python 函数来检查回文
> 为这个函数添加单元测试
> 重构代码使其更高效
> 解释这段代码的工作原理

总结

Windows 上安装 Claude Code 的核心步骤：

✅ 先装 Git - 这是前提条件

✅ 用 PowerShell 安装 - 以管理员身份运行

✅ 配置 PATH - 让系统能找到 claude 命令

✅ 重启终端 - 让 PATH 配置生效

✅ 记住命令名是 claude - 不是 claude-code

按照本教程，整个安装过程大约需要 10-15 分钟。

Claude Code Window系统安装教程

Windows 系统安装 Claude Code 完整教程

目录

系统要求

完整安装步骤

第一步：安装 Git for Windows（必需）

1.1 下载 Git

1.2 安装 Git

1.3 验证 Git 安装

第二步：安装 Claude Code

2.1 以管理员身份打开 PowerShell

2.2 运行安装命令

2.3 等待安装完成

第三步：配置环境变量（添加 PATH）

方法一：图形界面操作（推荐新手）

方法二：PowerShell 命令（快速）

第四步：验证安装

4.1 重启 PowerShell

4.2 测试命令

第五步：配置 API Key

选项 A：使用 Claude Pro/Max 订阅（推荐）

选项 B：使用 API 付费

重要注意事项

⚠️ 常见错误及解决方法

✅ 关键要点

故障排查

问题 1：找不到 `git` 命令

问题 2：找不到 `claude` 命令

问题 3：32 位系统错误

问题 4：权限错误

常用命令

安装流程图

使用示例

基础使用

示例对话

总结

相关链接

Claude Code Window系统安装教程

Windows 系统安装 Claude Code 完整教程#

目录#

系统要求#

完整安装步骤#

第一步：安装 Git for Windows（必需）#

1.1 下载 Git#

1.2 安装 Git#

1.3 验证 Git 安装#

第二步：安装 Claude Code#

2.1 以管理员身份打开 PowerShell#

2.2 运行安装命令#

2.3 等待安装完成#

第三步：配置环境变量（添加 PATH）#

方法一：图形界面操作（推荐新手）#

方法二：PowerShell 命令（快速）#

第四步：验证安装#

4.1 重启 PowerShell#

4.2 测试命令#

第五步：配置 API Key#

选项 A：使用 Claude Pro/Max 订阅（推荐）#

选项 B：使用 API 付费#

重要注意事项#

⚠️ 常见错误及解决方法#

✅ 关键要点#

故障排查#

问题 1：找不到 git 命令#

问题 2：找不到 claude 命令#

问题 3：32 位系统错误#

问题 4：权限错误#

常用命令#

安装流程图#

使用示例#

基础使用#

示例对话#

总结#

相关链接#

Windows 系统安装 Claude Code 完整教程

目录

系统要求

完整安装步骤

第一步：安装 Git for Windows（必需）

1.1 下载 Git

1.2 安装 Git

1.3 验证 Git 安装

第二步：安装 Claude Code

2.1 以管理员身份打开 PowerShell

2.2 运行安装命令

2.3 等待安装完成

第三步：配置环境变量（添加 PATH）

方法一：图形界面操作（推荐新手）

方法二：PowerShell 命令（快速）

第四步：验证安装

4.1 重启 PowerShell

4.2 测试命令

第五步：配置 API Key

选项 A：使用 Claude Pro/Max 订阅（推荐）

选项 B：使用 API 付费

重要注意事项

⚠️ 常见错误及解决方法

✅ 关键要点

故障排查

问题 1：找不到 `git` 命令

问题 2：找不到 `claude` 命令

问题 3：32 位系统错误

问题 4：权限错误

常用命令

安装流程图

使用示例

基础使用

示例对话

总结

相关链接