Claude Code Window系统安装教程
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✅ 如果显示类似 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 | iex2.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 ($20/月) 或 Max ($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安装流程图
graph TD
A[检查系统64位 Windows 10/11] --> B[安装 Git for Windows]
B --> C[以管理员身份打开 PowerShell]
C --> D[运行安装命令]
D --> E[添加 PATH 环境变量]
E --> F[重启 PowerShell]
F --> G[验证安装 claude --version]
G --> H{安装成功?}
H -->|是| I[配置 API Key]
H -->|否| J[检查故障排查章节]
I --> K[开始使用!]
J --> F使用示例
基础使用
# 进入您的项目目录
cd C:\Users\你的用户名\Documents\my-project
# 启动 Claude Code
claude
# Claude 会分析您的项目并等待您的指令
# 您可以用自然语言描述您想做什么示例对话
> 创建一个 Python 函数来检查回文
> 为这个函数添加单元测试
> 重构代码使其更高效
> 解释这段代码的工作原理总结
Windows 上安装 Claude Code 的核心步骤：
- ✅ 先装 Git - 这是前提条件
- ✅ 用 PowerShell 安装 - 以管理员身份运行
- ✅ 配置 PATH - 让系统能找到
claude命令 - ✅ 重启终端 - 让 PATH 配置生效
- ✅ 记住命令名是
claude- 不是claude-code
按照本教程，整个安装过程大约需要 10-15 分钟。