Windows 11 上配置 Claude Code 和 Vibe Coding

�� 目录

1. 系统要求和前置条件
2. 方案选择：原生安装 vs WSL2
3. 方案 A：原生安装 Claude Code（推荐）
4. 方案 B：使用 WSL2 的完整配置
5. 配置 Vibe Coding VSCode 扩展
6. 常见错误及解决方案

1️⃣ 系统要求和前置条件

系统最低要求

要求项	具体配置
Windows 版本	Windows 11（版本 21H2 或更高，建议 22H2）
内存	最少 4GB（建议 8GB 或以上）
硬盘空间	2-4GB（用于 Claude Code 和依赖项）
网络连接	稳定的互联网连接（用于下载工具和认证）

检查 Windows 版本

1. 按 Windows 键 + R 打开运行对话框
2. 输入 winver 并按 Enter
3. 查看显示的版本号（如 "版本 22H2"）
4. 确保版本号在 21H2 或更高

⚠️ 提示：如果版本过低，请转到 设置 > 系统 > 系统更新 进行更新

2️⃣ 方案选择：原生安装 vs WSL2

Claude Code 现在支持两种安装方式。选择最适合您的方案：

对比项	原生安装	WSL2 安装
难度	⭐ 简单（5分钟）	⭐⭐⭐ 中等（15-30分钟）
依赖项	仅需 Git for Windows	需要 WSL2、Python、Node.js
更新	自动更新	需手动更新
推荐使用	✅ 大多数用户	需要 Linux 环境用户

3️⃣ 方案 A：原生安装 Claude Code（推荐）

步骤 1：检查 Claude 账户和计费

Claude Code 不是免费工具。您需要以下之一：

• Claude.ai Pro 订阅账户
• Claude API 账户（配置计费信息）
• 企业级 Claude 访问权限

步骤 2：安装 Git for Windows

Claude Code 内部使用 Git Bash，这是必需的。

1. 访问 https://git-scm.com/download/win
2. 下载最新的 Git 安装程序（64-bit 版本）
3. 运行安装程序，使用所有默认设置
4. 完成安装后重启计算机

✅ 验证安装：打开 PowerShell，输入：git --version

步骤 3：安装 Claude Code CLI

这是最简单的部分。

1. 打开 PowerShell（任何版本都可以，不需要管理员权限）
2. 复制并粘贴以下命令：

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

1. 按 Enter 并等待安装完成
2. 安装完成后，您将看到成功消息和版本号

步骤 4：修复 PATH（如果需要）

通常这一步会自动完成，但如果 claude 命令不被识别：

setx PATH "%PATH%;C:\Users\<YourUser>\.local\bin"

将 <YourUser> 替换为您的 Windows 用户名

或使用 GUI 方法：Win + R → sysdm.cpl → 高级 → 环境变量 → 编辑 Path，添加新项：C:\Users\<YourUser>\.local\bin

步骤 5：验证安装

claude --version

应该看到类似的输出：claude version 1.0.86

步骤 6：首次运行 Claude Code

claude . -m plan

1. 首次运行时会提示您进行身份验证
2. 浏览器将自动打开 Claude 登录页面
3. 使用您的 Claude.ai Pro 或 API 账户登录
4. 授权访问权限后，CLI 可立即使用

4️⃣ 方案 B：使用 WSL2 的完整配置

本方案适合需要 Linux 环境或偏好沙箱隔离的用户。总耗时：20-30 分钟。

步骤 1：启用 WSL 和虚拟化功能

1. 以管理员身份打开 PowerShell
2. 输入以下命令：

wsl --install

1. 重启计算机
2. 重启后，Ubuntu 将自动完成最终安装
3. 设置 Ubuntu 用户名和密码（不需要匹配 Windows 用户）

❌ 常见错误："执行策略被限制"

如果看到关于执行策略的错误，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

步骤 2：在 WSL Ubuntu 中安装 Python

1. 打开 Ubuntu 终端（从开始菜单搜索）
2. 运行更新命令：

sudo apt update && sudo apt upgrade -y

1. 安装 Python 3 和 pip：

sudo apt install python3 python3-pip -y

1. 验证安装：

python3 --version && pip3 --version

步骤 3：在 WSL 中安装 Node.js

1. Claude Code 需要 Node.js 18 或更高版本
2. 安装 NVM（Node 版本管理器）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

1. 关闭并重新打开 Ubuntu 终端
2. 安装 Node.js 最新 LTS 版本：

nvm install --lts && nvm use --lts

1. 验证：

node --version && npm --version

步骤 4：在 WSL 中安装 Claude Code

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

1. 等待安装完成
2. 验证：

claude --version

5️⃣ 配置 Vibe Coding VSCode 扩展

"Vibe Coding" 是一种开发方法论，使用 AI 辅助工具加速编码。以下是几个热门的 VSCode 扩展配置方案。

选项 1：Vibe Coding（XML 转换工具）

1. 打开 VSCode
2. 按 Ctrl+Shift+X 打开扩展市场
3. 搜索 "vibe-coding"
4. 点击 "Install"
5. 重启 VSCode
6. 使用方式：按 F5 在新窗口中加载扩展，或用 Ctrl+Shift+P 执行 "Open Vibe Coding View"

选项 2：Vibe VS Code（AI 编码助手）

1. 在 VSCode 扩展市场搜索 "Vibe VS Code"
2. 查找版本标有 "CLI Parity Edition"
3. 安装并重启
4. 此扩展提供 35+ 命令、内存系统和 Git 集成

推荐的 Vibe Coding 扩展组合

扩展名称	功能	推荐度
Vibe Coding	XML 文件树转换	⭐⭐⭐⭐⭐
Vibe VS Code	CLI 风格 AI 编码	⭐⭐⭐⭐⭐
VibeCheck	Git 和测试自动化	⭐⭐⭐⭐
VibeGuard	安全漏洞检测	⭐⭐⭐

6️⃣ 常见错误及解决方案

❌ 错误 1："claude: command not found"

症状	运行 claude 命令时收到未找到命令错误
原因	安装路径未添加到系统 PATH
解决方案	关闭所有 PowerShell 窗口 以管理员身份打开新 PowerShell 运行：setx PATH "%PATH%;C:\Users\<YourUser>\.local\bin" 重启计算机

❌ 错误 2："npm command not found"（仅 WSL）

解决方案	在 Ubuntu 终端中运行： nvm use --lts 关闭并重新打开终端 验证：npm --version

❌ 错误 3："Authentication failed" 或 "Invalid API key"

症状	认证失败或 API 密钥无效
检查清单	是否已激活 Claude.ai Pro 订阅？ API 账户是否已配置计费信息？ Claude 账户是否在同一浏览器中登录？ 尝试重新认证：删除 ~/.config/claude/auth.json 然后重新运行 claude

❌ 错误 4："Git not found"

解决方案	访问 git-scm.com 重新安装 Git 使用所有默认选项安装 重启计算机 验证：git --version

❌ 错误 5："WSL installation failed" 或虚拟化错误

故障排除	在 BIOS 中启用虚拟化（Intel VT-x 或 AMD-V） 确保 Windows 功能中启用了 "Hyper-V" 和 "虚拟机平台" 以管理员身份运行：wsl --unregister Ubuntu && wsl --install

❌ 错误 6：VSCode 扩展无法安装

解决步骤	检查互联网连接 清除 VSCode 缓存：关闭 VSCode，删除 C:\Users\<User>\.vscode\extensions 中的相关文件夹 重新打开 VSCode 并重试

✅ 快速检查清单

• ✓ Windows 11 版本 21H2 或更高
• ✓ Git for Windows 已安装
• ✓ Claude.ai Pro 账户已激活或 API 计费已配置
• ✓ Claude Code 已安装（claude --version 可验证）
• ✓ VSCode 已安装（可选但推荐）
• ✓ Vibe Coding 扩展已安装（可选）
• ✓ 首次运行 claude 时已完成身份验证

�� 推荐资源和下一步

• Claude 官方文档：https://docs.claude.com
• Claude Code 文档：https://docs.anthropic.com/en/docs/claude-code
• Vibe Coding GitHub：https://github.com/vibecodev
• VSCode 扩展市场
• Windows Terminal（推荐用于更好的开发体验）

�� 获取支持

如遇到本教程未涵盖的问题，请：

1. 查看官方文档（https://support.claude.com）
2. 在 GitHub 上报告问题（对应项目的 Issues 页面）
3. 联系 Anthropic 支持团队

祝您使用愉快！Happy Vibe Coding! ��