Windows Claude Code 安装完整教程

Windows Claude Code 安装完整教程

本文适配 Windows 10/11（64位，推荐 22H2 及以上版本），涵盖「原生 CLI（Node.js 依赖）、无 Node.js 一键安装、VS Code 插件集成、WSL 安装」四种方式，详细说明配置流程、使用方法及常见问题排查，兼顾新手友好与进阶需求。

一、前置准备（必做）

1.1 系统与环境要求

• 系统版本：Windows 10 22H2+ / Windows 11 任意版本（64位）

• 核心依赖：Node.js 18+（LTS 20.x 版本优先，仅 CLI 方式 1 必需）

• 网络要求：需可访问 Anthropic 服务器（需科学上网）

• 关键凭证：Claude API Key（用于调用服务，需提前获取）

1.2 获取 Claude API Key

1. 访问 Anthropic 官网控制台，注册/登录账号；

2. 进入「API Keys」页面，点击「Create API Key」生成密钥；

3. 复制生成的 API Key 并保存（后续配置必需，请勿泄露）。

1.3 安装 Node.js（仅 CLI 方式 1 必需）

1. 下载安装包：访问 Node.js 官网，选择「Windows LTS 版本」（.msi 格式）；

2. 安装步骤：双击运行安装包，全程默认下一步，确保勾选「Add to PATH」（默认已勾选，勿取消）；

3. 验证安装：打开 PowerShell，执行以下命令，能输出版本号即成功：
   node -v # 需输出 v18.x 及以上版本 npm -v # 需输出 v9.x 及以上版本

1.4 可选：安装 Git for Windows（增强兼容性）

部分安装方式依赖 Git 环境，推荐安装：

1. 下载：访问 Git for Windows 官网，选择对应版本；

2. 安装：全程默认选项，完成后验证：
   git --version # 输出版本号即成功

二、安装方式 1：原生 CLI 安装（Node.js 依赖，推荐）

通过 npm 全局安装，适配大多数 Windows 环境，支持终端直接调用 Claude Code 功能。

2.1 安装 Claude Code CLI

1. 以管理员身份打开 PowerShell（右键开始菜单 → 终端(管理员)）；

2. （可选，国内网络加速）切换 npm 国内镜像：
   npm config set registry https://registry.npmmirror.com

3. 全局安装 Claude Code：
   npm install -g @anthropic-ai/claude-code

4. 验证安装：
   claude --version # 输出版本号即成功

2.2 解决「claude 不是内部或外部命令」问题

若终端提示命令未识别，需配置 npm 全局路径到系统环境变量：

1. 获取 npm 全局安装路径：
   npm config get prefix # 输出示例：C:\Users\你的用户名\AppData\Roaming\npm

2. 配置环境变量：

   • 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量；

   • 在「用户变量」中找到「Path」，点击「编辑」→「新建」；

   • 粘贴步骤 1 获取的 npm 路径，点击「确定」保存；

   • 关闭所有终端，重新打开 PowerShell 即可生效。

2.3 配置 API Key（核心步骤）

配置 API Key 后才能正常调用 Claude 服务，支持永久配置 （推荐）和临时配置两种方式：

方式 A：永久配置（推荐）

1. 按 Win+R 输入 sysdm.cpl，打开「系统属性」→「高级」→「环境变量」；

2. 在「用户变量」中点击「新建」；

3. 变量名：ANTHROPIC_API_KEY，变量值：你的 Claude API Key；

4. 点击「确定」保存，关闭所有终端重新打开。

方式 B：临时配置（终端关闭后失效）

$env:ANTHROPIC_API_KEY="你的 Claude API Key"

验证配置

echo $env:ANTHROPIC_API_KEY  # 输出你的 API Key 即成功

2.4 CLI 基础使用示例

# 1. 进入编程交互模式（实时对话编程）
claude code

# 2. 直接提交编程需求（生成指定代码）
claude code "写Python爬虫爬取豆瓣Top250电影列表，保存为CSV文件，包含异常处理"

# 3. 指定模型（推荐 Claude 3 Sonnet，平衡速度与效果）
claude code --model claude-3-sonnet-20240229 "优化这段JavaScript代码的性能：[粘贴你的代码]"

# 4. 读取本地文件并分析/修复
claude code --file ./main.py "分析这段代码的性能瓶颈，给出优化方案"

# 5. 生成 C# 控制台程序
claude code "用C#写一个控制台版计算器，支持加减乘除，含输入验证"

三、安装方式 2：无 Node.js 一键安装（轻量版）

适合不想安装 Node.js 的场景，通过官方脚本直接安装，步骤更简洁。

2.1 前置条件

必须安装 Git for Windows（参考「一、前置准备 1.4」），否则脚本无法执行。

2.2 执行安装脚本

根据终端类型选择对应命令：

PowerShell 终端

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

CMD 终端

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

2.3 配置 PATH 环境变量

1. 安装后的程序路径：C:\Users\你的用户名\.local\bin；

2. 按「方式 1 2.2」的步骤，将上述路径添加到用户变量 PATH 中；

3. 重启终端，执行 claude --version 验证安装。

2.4 配置 API Key

与「方式 1 2.3」完全一致，推荐永久配置（环境变量方式）。

四、安装方式 3：VS Code 插件集成（可视化，推荐）

通过 VS Code 插件实现可视化操作，支持右键生成/修复代码、侧边栏实时聊天，适配日常编程习惯。

3.1 安装 VS Code 插件

1. 打开 VS Code（官网下载：https://code.visualstudio.com/Download）；

2. 按 Ctrl+Shift+X 打开扩展商店；

3. 搜索「Claude AI」（Anthropic 官方出品，认准蓝色官方图标）；

4. 点击「安装」，安装完成后重启 VS Code 生效。

3.2 配置插件 API Key

1. 打开 VS Code 设置（快捷键 Ctrl+,）；

2. 在搜索框输入「Claude API Key」；

3. 在对应输入框粘贴你的 Claude API Key；

4. （可选）设置默认模型：搜索「Claude Model」，选择 claude-3-sonnet-20240229（推荐）。

3.3 插件核心功能使用

• 代码生成：右键编辑器空白处 → 选择「Claude: Generate Code」，输入编程需求；

• 代码修复：选中报错/待优化代码 → 右键 → 选择「Claude: Fix Code」或「Claude: Optimize Code」；

• 实时聊天编程：打开 VS Code 左侧边栏的「Claude」面板，直接输入需求对话；

• 文件分析：拖拽本地代码文件到 Claude 面板，输入「分析这个文件的功能和潜在问题」。

五、安装方式 4：WSL 安装（兼容 Linux 生态，可选）

适合习惯 Linux 命令行的用户，通过 WSL（Windows 子系统 for Linux）安装，兼容 Linux 生态的开发工具。

4.1 安装 WSL

1. 以管理员身份打开 PowerShell；

2. 执行安装命令：
   wsl --install

3. 重启电脑，按提示设置 Ubuntu 用户名和密码（记住密码，后续 sudo 需使用）。

4.2 在 WSL 中安装 Claude Code

1. 打开 WSL 终端（开始菜单 → Ubuntu）；

2. 安装 Node.js 和 npm：

   `sudo apt update && sudo apt install nodejs npm -y

验证版本（需 ≥18）

node -v`

3. 安装 Claude Code：
   npm install -g @anthropic-ai/claude-code

4. 配置 API Key（永久生效）：
   echo 'export ANTHROPIC_API_KEY="你的 Claude API Key"' >> ~/.bashrc source ~/.bashrc

5. 验证：
   claude --version # 输出版本号即成功

六、常见问题排查

问题现象	可能原因	解决方法
npm 安装时提示「Permission denied」权限错误	无全局安装权限	1. 确保以管理员身份运行终端；2. 加 --force 参数强制安装：npm install -g @anthropic-ai/claude-code --force
配置 API Key 后仍提示「未授权」	API Key 错误、过期，或账号无可用额度	1. 检查 API Key 是否完整（无空格/换行）；2. 登录 Anthropic 控制台确认账号有余额/免费额度；3. 重新创建并配置新的 API Key
VS Code 插件无响应，无法加载 Claude	网络无法访问 Anthropic 服务器，或插件未重启生效	1. 检查网络环境（需可访问境外网络）；2. 重启 VS Code；3. 卸载并重新安装插件
CLI 执行命令时提示「模型不存在」	模型名称错误，或版本号不匹配	使用官方支持的模型名称，推荐：claude-3-sonnet-20240229（代码生成首选）claude-3-opus-20240229（复杂任务）
国内网络安装 npm 包慢/超时	npm 官方源访问慢	切换国内镜像：npm config set registry https://registry.npmmirror.com
无 Node.js 一键安装后命令未识别	.local/bin 路径未添加到 PATH	将 C:\Users\你的用户名\.local\bin 添加到用户变量 PATH，重启终端

七、核心使用示例（编程场景）

# 1. 生成 Java 异常处理代码
claude code "写一个 Java 工具类，实现文件读取功能，包含空指针、文件不存在、IO 异常的完整处理"

# 2. 修复 Python 代码错误
claude code --file ./data_process.py "修复这个文件中的数据读取报错，优化内存占用"

# 3. 解释 Go 代码逻辑
claude code "解释这段 Go 代码的并发控制逻辑，指出潜在的 goroutine 泄漏风险：[粘贴你的代码]"

# 4. 生成前端 Vue 组件
claude code "用 Vue 3 + Element Plus 写一个表格组件，支持分页、搜索、排序功能"

八、总结

• 新手推荐：「方式 1（Node.js + CLI）+ 方式 3（VS Code 插件）」组合，兼顾终端高效操作与可视化编程；

• 轻量需求：选择「方式 2（无 Node.js 一键安装）」，无需额外依赖；

• Linux 习惯：选择「方式 4（WSL 安装）」，兼容 Linux 生态工具；

• 核心要点：API Key 是调用服务的关键，需确保配置正确且未泄露；PATH 配置是 CLI 命令识别的核心，若命令未识别优先检查 PATH；

• 网络注意：需可访问 Anthropic 服务器，否则无法调用 Claude 服务。

（注：文档部分内容可能由 AI 生成）