Windows 系统Claude Code安装与使用笔记

一、基础信息说明

1. 适配系统

支持 Windows 10（22H2 及以上）、Windows 11（全版本） ，仅适配 64 位系统。Claude Code 是 Anthropic 推出的 AI 编程助手，可实现代码生成、BUG 修复、代码分析、文件处理等功能，提供 CLI 终端、无 Node 一键安装、VS Code 插件、WSL 子系统 四种安装方案，可根据使用场景选择。

2. 通用前置要求（所有安装方式必看）

网络：设备需正常访问 Anthropic 官方服务器。
核心凭证 ：提前获取 Claude API Key （调用服务必备，切勿泄露）。
- 获取步骤：登录 Anthropic 官网控制台 → 进入 API Keys 页面 → 点击 Create API Key 生成并复制保存。
可选工具 ：推荐安装 Git for Windows，提升多安装方式的兼容性。
- 安装：官网下载对应版本，全程默认安装；
- 验证（PowerShell）：git --version，输出版本号即为成功。

二、前置环境部署（CLI 专属：Node.js）

该步骤仅原生 CLI 安装方式需要，其余三种安装方式可跳过。

下载安装包 ：前往 Node.js 官网，选择 Windows 平台 LTS 长期版（.msi 格式），推荐 18+ / 20.x 版本。
安装配置 ：双击安装包，全程默认下一步，务必保留「Add to PATH」勾选状态。

环境验证 （PowerShell）：

powershell 复制代码

node -v   # 要求输出 v18.x 及以上
npm -v    # 要求输出 v9.x 及以上

三、四种安装方案分步教程

方案一：原生 CLI 安装（推荐，依赖 Node.js）

适合习惯终端操作、主流 Windows 开发环境，稳定性最强。

管理员身份启动 PowerShell（右键开始菜单 → 终端(管理员)）。
国内网络优化（可选） ：切换 npm 镜像加速下载
powershell 复制代码
```
npm config set registry shturl.cc/cwoqX9v18M9uyqVSPbiL
```
全局安装 Claude Code
powershell 复制代码
```
npm install -g @anthropic-ai/claude-code
```

安装验证

powershell 复制代码

claude --version  # 正常输出版本号即安装成功

补充：命令未识别解决方案（`claude 不是内部或外部命令`）

执行命令获取 npm 全局路径：npm config get prefix；
右键「此电脑」→ 属性 → 高级系统设置 → 环境变量；
在用户变量 中编辑 Path，新建条目并粘贴上一步获取的路径；
关闭所有终端，重新打开 PowerShell 即可生效。

API Key 配置（核心，二选一）

永久配置（推荐，重启终端仍生效）
- 快捷键 Win+R 输入 sysdm.cpl 打开系统属性 → 高级 → 环境变量；
- 用户变量新建：变量名 ANTHROPIC_API_KEY，变量值粘贴你的 API Key；
- 保存后重启终端。
临时配置（仅当前终端生效，关闭即失效）
powershell 复制代码
```
$env:ANTHROPIC_API_KEY="你的Claude API Key"
```
验证配置：echo $env:ANTHROPIC_API_KEY，输出对应 Key 即配置成功。

CLI 常用基础命令

powershell 复制代码

# 1. 进入交互式编程对话模式
claude code
# 2. 直接提交代码需求
claude code "编写Python爬虫爬取豆瓣Top250并保存为CSV"
# 3. 指定模型执行任务（claude-3-sonnet 通用首选）
claude code --model claude-3-sonnet-20240229 "优化JS代码性能"
# 4. 读取本地代码文件分析
claude code --file ./main.py "分析代码性能瓶颈并给出优化方案"

方案二：无 Node.js 一键安装（轻量版）

无需部署 Node.js，操作最简单，适合临时使用、不想配置复杂环境的场景。

前置条件 ：必须提前安装 Git for Windows。

执行安装脚本 （根据终端选择命令）

PowerShell 终端：
powershell 复制代码
```
irm https://claude.ai/install.ps1 | iex
```

CMD 终端：

cmd 复制代码

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

配置环境变量
- 安装路径固定：C:\Users\你的用户名\.local\bin；
- 参考方案一的 Path 配置步骤，将上述路径添加至用户变量 Path；
验证：重启终端，执行 claude --version。
API Key 配置：与方案一完全一致。

方案三：VS Code 插件安装（可视化操作，推荐日常开发）

深度集成代码编辑器，支持右键操作、侧边栏对话，贴合常规编程习惯。

安装 VS Code：前往官网下载并安装。
安装官方插件
- 打开 VS Code，快捷键 Ctrl+Shift+X 进入扩展商店；
- 搜索 Claude AI（认准 Anthropic 官方蓝色图标），点击安装，重启编辑器生效。
插件配置
- 快捷键 Ctrl+, 打开设置，搜索 Claude API Key，粘贴你的密钥；
- 可选配置：搜索 Claude Model，默认选择 claude-3-sonnet-20240229。
核心使用功能
- 代码生成：右键空白处 → Claude: Generate Code；
- 代码修复/优化：选中代码 → 右键 Fix Code / Optimize Code；
- 实时对话：打开左侧 Claude 侧边栏，直接输入需求；
- 文件分析：拖拽本地代码文件至侧边栏，发起分析指令。

方案四：WSL 子系统安装（兼容 Linux 生态）

适合习惯 Linux 命令行、需要搭配 Linux 开发工具的用户。

安装 WSL（管理员 PowerShell）
powershell 复制代码
```
wsl --install
```
重启电脑，根据提示设置 Ubuntu 用户名与密码（后续 sudo 命令需要）。

WSL 终端内部署环境 （打开 Ubuntu 终端）

bash 复制代码

sudo apt update && sudo apt install nodejs npm -y
node -v  # 验证 Node.js 版本 ≥18

安装 Claude Code

bash 复制代码

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

永久配置 API Key

bash 复制代码

echo 'export ANTHROPIC_API_KEY="你的Claude API Key"' >> ~/.bashrc
source ~/.bashrc

验证：执行 claude --version。

四、常见问题排查表

问题现象	原因	解决方法
npm 安装提示 `Permission denied` 权限错误	终端无管理员权限	1. 以管理员身份运行 PowerShell；2. 追加参数：`npm install -g @anthropic-ai/claude-code --force`
配置 API Key 后提示「未授权」	Key 错误/过期、账号无额度	1. 检查 Key 无空格、换行；2. 登录控制台核对账号额度；3. 重新生成 Key
VS Code 插件无响应	网络无法访问官方服务器、插件未生效	1. 检查网络；2. 重启 VS Code；3. 重装插件
CLI 提示「模型不存在」	模型名称错误	使用官方模型：`claude-3-sonnet-20240229`（通用）、`claude-3-opus-20240229`（复杂任务）
npm 下载缓慢/超时	官方源网络不佳	切换国内镜像：`npm config set registry shturl.cc/cwoqX9v18M9uyqVSPbiL`
一键安装后命令无法识别	未添加 `.local/bin` 至环境变量	将 `C:\Users\用户名\.local\bin` 加入系统 Path，重启终端

五、安装方案选型总结

新手首选 ：原生 CLI + VS Code 插件 组合，兼顾终端高效操作与可视化编辑；
轻量使用 ：选择无 Node.js 一键安装，零额外依赖，快速上手；
Linux 开发习惯 ：选择 WSL 子系统安装，兼容 Linux 工具链；
通用核心提醒 ：API Key 是服务调用核心，务必妥善保管；命令识别异常优先检查系统 Path 环境变量。

需要我帮你整理一份常用命令速查表，方便你日常调用吗？

Windows 系统Claude Code安装与使用笔记