适用于 Windows 10⁄11 (64位) 系统的 Claude Code 安装指南
📋 目录
- 系统要求
- 完整安装步骤
- 第一步:安装 Git for Windows
- 第二步:安装 Claude Code
- 第三步:配置环境变量
- 第四步:验证安装
- 第五步:配置 API Key
- 重要注意事项
- 故障排查
- 常用命令
系统要求
- ✅ 操作系统: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 | iex
2.3 等待安装完成
安装过程会显示进度信息,完成后会显示:
✅ Installation complete!Version: 2.0.34Location: C:Users你的用户名.localbinclaude.exe
第三步:配置环境变量(添加 PATH)
安装完成后需要将 Claude 添加到系统 PATH,这样才能在任何地方运行 claude 命令。
方法一: 图形界面 操作(推荐新手)
- 按
Win + R,输入sysdm.cpl,按回车 - 点击 “高级” 标签
- 点击 “环境变量” 按钮
- 在 “用户变量” 区域(窗口上半部分),找到并双击
Path - 点击 “新建” 按钮
- 输入:
C:Users你的用户名.localbin- 将
你的用户名替换为实际的 Windows 用户名
- 将
- 依次点击 “确定” 关闭所有窗口
方法二:PowerShell 命令(快速)
在 PowerShell(管理员模式)中运行:
[Environment]::SetEnvironmentVariable(“Path”, \(env:Path + “;C:Users\)env:USERNAME.localbin”, “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(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你的用户名.localbinclaude.exe –version
问题 3:32 位系统错误
症状:
Claude Code does not support 32-bit Windows
解决方法:
- 检查系统是否为 64 位:
- 按
Win + Pause/Break - 查看 “系统类型”
- 按
- 确保使用 64 位 PowerShell:
- 按
Win + R - 输入:
%SystemRoot%System32WindowsPowerShellv1.0powershell.exe
- 按
问题 4:权限错误
症状:
无法加载文件,因为在此系统上禁止运行脚本
解决方法:
在 PowerShell(管理员模式)中运行:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
常用命令
安装完成后,您可以使用以下命令:
claude --help
claude
claude --model claude-sonnet-4-
claude config list
claude config set apiKey
安装流程图
使用示例
基础使用
claude
示例对话
> 创建一个 Python 函数来检查回文> 为这个函数添加单元测试> 重构代码使其更高效> 解释这段代码的工作原理
总结
Windows 上安装 Claude Code 的核心步骤:
- ✅ 先装 Git - 这是前提条件
- ✅ 用 PowerShell 安装 - 以管理员身份运行
- ✅ 配置 PATH - 让系统能找到
claude命令 - ✅ 重启终端 - 让 PATH 配置生效
- ✅ 记住命令名是
claude- 不是claude-code
按照本教程,整个安装过程大约需要 10-15 分钟。
相关链接
- 📚 Claude Code 官方文档
- 🌐 Anthropic Console
- 💻 Git for Windows 下载
- 📖 Claude 官网
本文转自 https://blog.csdn.net/weixin_58026642/article/details/159634641?spm=1000.2115.3001.10524,如有侵权,请联系删除。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/271134.html