2026-06-11 2221 字 10 分钟 -- 次

部署

最后更新于: 2026-06-27 15:38:29

提问

 1请给我出一份如何在win11上安装和卸载claude code的详细文档
 2
 3● 已为你生成详细文档，保存在：
 4
 5  📄 C:\Users\Administrator\claude-code-win11-guide.md
 6
 7  ---
 8  文档内容概览
 9
10  ┌────────────────┬───────────────────────────────────────────────────────┐
11  │      章节      │                         内容                          │
12  ├────────────────┼───────────────────────────────────────────────────────┤
13  │ 一、安装前准备 │ 系统要求、Node.js 安装（官网 / nvm）、Git 安装        │
14  ├────────────────┼───────────────────────────────────────────────────────┤
15  │ 二、安装       │ npm 全局安装、淘宝镜像加速、安装验证                  │
16  ├────────────────┼───────────────────────────────────────────────────────┤
17  │ 三、首次配置   │ 启动登录、浏览器授权、API Key 配置                    │
18  ├────────────────┼───────────────────────────────────────────────────────┤
19  │ 四、验证安装   │ 基础测试、配置目录结构、命令测试                      │
20  ├────────────────┼───────────────────────────────────────────────────────┤
21  │ 五、常用命令   │ 速查表（/quit、/model、/config 等）                   │
22  ├────────────────┼───────────────────────────────────────────────────────┤
23  │ 六、卸载       │ npm uninstall、手动删除残留                           │
24  ├────────────────┼───────────────────────────────────────────────────────┤
25  │ 七、完全清理   │ 删除 ~/.claude 配置、清理环境变量、一键卸载脚本       │
26  ├────────────────┼───────────────────────────────────────────────────────┤
27  │ 八、常见问题   │ 权限错误、PATH 问题、浏览器打不开、国内网络、更新方法 │
28  └────────────────┴───────────────────────────────────────────────────────┘
29
30  ---
31  核心命令速记
32
33  # 安装
34  npm install -g @anthropic-ai/claude-code
35
36  # 启动（在项目目录）
37  claude
38
39  # 卸载
40  npm uninstall -g @anthropic-ai/claude-code
41
42  # 完全清理（包括配置）
43  Remove-Item -Recurse -Force "$env:USERPROFILE\.claude"
44
45  文档里还附带了一个一键卸载脚本 uninstall-claude.ps1，保存后右键运行即可自动完成全部清理工作。

Claude Code Windows 11 安装与卸载指南

本文档适用于 Windows 11 系统，包含 Claude Code 的完整安装、配置和卸载流程。

一、安装前准备

1.1 系统要求

项目	要求
操作系统	Windows 11（64位）
Node.js	v18.0.0 或更高版本（推荐 LTS）
npm	v9.0.0 或更高版本
Git	任意版本（可选，但强烈推荐）
网络	能访问 npm registry 和 Anthropic API

1.2 安装 Node.js

Claude Code 基于 Node.js 运行，必须先安装 Node.js。

方式一：通过官网安装（推荐）

访问 https://nodejs.org/
下载 LTS（长期支持）版本，如 v20.x.x
运行下载的 .msi 安装程序
全程点击「Next」即可（保持默认安装路径 C:\Program Files\nodejs）
安装完成后打开 PowerShell 或 CMD，验证：

1node --version
2# 输出示例：v20.12.0
3
4npm --version
5# 输出示例：10.5.0

方式二：通过 nvm-windows 安装（进阶用户）

如果你需要管理多个 Node.js 版本：

1# 安装 nvm-windows
2winget install CoreyButler.NVMforWindows
3
4# 重启终端后
5nvm install 20
6nvm use 20

1.3 安装 Git（可选但推荐）

Claude Code 深度集成 Git，建议安装：

1winget install Git.Git

安装后验证：

1git --version

二、安装 Claude Code

2.1 通过 npm 全局安装（推荐）

打开 PowerShell（推荐以管理员身份运行），执行：

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

安装过程约需 1-3 分钟，取决于网络状况。

如果网络较慢，可以切换国内 npm 镜像：

1# 临时使用淘宝镜像
2npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

2.2 通过官方安装脚本安装

如果 npm 安装遇到问题，可以使用官方脚本：

1# 在 PowerShell 中执行
2npm install -g @anthropic-ai/claude-code

2.3 安装完成验证

1claude --version
2# 输出示例：0.2.x

三、首次配置与登录

3.1 启动 Claude Code

在任意项目的目录下打开 PowerShell，执行：

1claude

或者先进入某个项目目录：

1cd C:\Users\你的用户名\Projects\my-project
2claude

3.2 登录 Anthropic 账号

首次启动会提示登录：

1╭──────────────────────────────────────────╮
2│                                          │
3│  Welcome to Claude Code!                 │
4│                                          │
5│  Please log in to get started.           │
6│                                          │
7│  A browser window will open...           │
8│                                          │
9╰──────────────────────────────────────────╯

按回车确认，系统会自动打开浏览器
在浏览器中登录你的 Anthropic 账号（或注册新账号）
授权 Claude Code 访问
浏览器会跳转到 localhost 完成回调
终端显示登录成功提示

如果浏览器没有自动打开，可以手动复制终端中的 URL 到浏览器打开。

3.3 配置 API Key（可选）

如果你需要使用自己的 API Key（而不是通过网页登录）：

1# 设置环境变量（临时）
2$env:ANTHROPIC_API_KEY = "sk-你的API密钥"
3
4# 或者设置永久环境变量
5[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-你的API密钥", "User")

四、验证安装

4.1 基础功能测试

在 Claude Code 交互界面中，输入：

1> 你好

如果能正常收到回复，说明安装成功。

4.2 检查配置

1# 查看 Claude Code 配置目录
2ls $env:USERPROFILE\.claude
3
4# 应该包含以下文件/目录：
5# - settings.json      ← 用户设置
6# - settings.local.json ← 本地设置（如权限白名单）
7# - memory/            ← 记忆目录
8# - projects/          ← 项目相关数据

4.3 常用命令测试

1# 查看帮助
2claude --help
3
4# 查看当前版本
5claude --version
6
7# 进入某个项目
8claude C:\Users\你的用户名\Projects\my-project

五、常用命令速查

命令	说明
`claude`	在当前目录启动 Claude Code
`claude <路径>`	在指定项目目录启动
`claude --version`	查看版本
`claude --help`	查看帮助
`/quit` 或 `Ctrl+D`	退出 Claude Code
`/clear`	清空对话
`/model`	切换 AI 模型
`/config`	查看/修改配置
`/init`	初始化项目文档

六、卸载 Claude Code

6.1 通过 npm 卸载（推荐）

打开 PowerShell，执行：

1npm uninstall -g @anthropic-ai/claude-code

验证是否卸载成功：

1claude --version
2# 应该提示：claude : 无法将"claude"项识别为 cmdlet、函数、脚本文件或可运行程序的名称。

6.2 手动删除残留（如果 npm 卸载不完全）

1# 删除全局 npm 包中的 Claude Code（如果存在）
2Remove-Item -Recurse -Force "$env:APPDATA\npm\node_modules\@anthropic-ai\claude-code" -ErrorAction SilentlyContinue
3Remove-Item -Force "$env:APPDATA\npm\claude.cmd" -ErrorAction SilentlyContinue
4Remove-Item -Force "$env:APPDATA\npm\claude" -ErrorAction SilentlyContinue

七、完全清理残留

7.1 删除配置文件

1# 删除 Claude Code 配置目录（包含设置、记忆、权限等）
2Remove-Item -Recurse -Force "$env:USERPROFILE\.claude" -ErrorAction SilentlyContinue

⚠️ 警告：此操作会删除所有配置，包括：

settings.json（用户设置）
settings.local.json（本地权限白名单）
memory/（记忆文件）
projects/（项目数据）

7.2 删除环境变量（如果设置过）

1# 删除 API Key 环境变量（如果设置过）
2[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", $null, "User")
3[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "User")
4[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User")

7.3 清除 npm 缓存（可选）

1npm cache clean --force

7.4 完整卸载脚本（一键执行）

将以下内容保存为 uninstall-claude.ps1，右键「使用 PowerShell 运行」：

 1# Claude Code 完整卸载脚本 for Windows 11
 2Write-Host "正在卸载 Claude Code..." -ForegroundColor Yellow
 3
 4# 1. npm 卸载
 5Write-Host "[1/4] 通过 npm 卸载..."
 6npm uninstall -g @anthropic-ai/claude-code 2>$null
 7
 8# 2. 删除 npm 残留
 9Write-Host "[2/4] 删除 npm 残留..."
10Remove-Item -Recurse -Force "$env:APPDATA\npm\node_modules\@anthropic-ai" -ErrorAction SilentlyContinue
11Remove-Item -Force "$env:APPDATA\npm\claude.cmd" -ErrorAction SilentlyContinue
12Remove-Item -Force "$env:APPDATA\npm\claude" -ErrorAction SilentlyContinue
13
14# 3. 删除配置文件
15Write-Host "[3/4] 删除配置文件..."
16Remove-Item -Recurse -Force "$env:USERPROFILE\.claude" -ErrorAction SilentlyContinue
17
18# 4. 删除环境变量
19Write-Host "[4/4] 清理环境变量..."
20[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", $null, "User")
21[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "User")
22[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User")
23
24Write-Host "卸载完成！" -ForegroundColor Green
25Write-Host "已删除：npm 包、配置文件、环境变量"
26
27# 验证
28$claudePath = Get-Command claude -ErrorAction SilentlyContinue
29if (-not $claudePath) {
30    Write-Host "验证通过：claude 命令已移除" -ForegroundColor Green
31} else {
32    Write-Host "警告：claude 命令仍然存在，路径：$($claudePath.Source)" -ForegroundColor Red
33}
34
35Read-Host "按 Enter 键退出"

八、常见问题排查

8.1 安装失败：`EACCES: permission denied`

原因：npm 全局安装权限不足

解决：以管理员身份运行 PowerShell，或者修改 npm 全局目录：

1# 创建新的全局目录
2mkdir "$env:USERPROFILE\.npm-global"
3npm config set prefix "$env:USERPROFILE\.npm-global"
4
5# 将新目录加入 PATH
6[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:USERPROFILE\.npm-global\bin", "User")
7
8# 重启终端后重新安装
9npm install -g @anthropic-ai/claude-code

8.2 `claude` 命令无法识别

原因：npm 全局 bin 目录未加入 PATH

解决：

1# 查看 npm 全局 bin 路径
2npm bin -g
3# 输出示例：C:\Users\用户名\AppData\Roaming\npm
4
5# 确认该路径在 PATH 中
6$env:PATH -split ";" | Select-String "npm"
7
8# 如果不在，手动添加
9[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;C:\Users\用户名\AppData\Roaming\npm", "User")

8.3 登录时浏览器打不开

解决：

手动复制终端中的 URL 到浏览器
或者使用 API Key 方式登录：

1$env:ANTHROPIC_API_KEY = "sk-你的密钥"
2claude

8.4 网络连接问题（中国用户）

如果遇到 API 连接超时，可以：

1# 设置代理（如果使用了 clash/v2ray 等）
2$env:HTTP_PROXY = "http://127.0.0.1:7890"
3$env:HTTPS_PROXY = "http://127.0.0.1:7890"
4claude

或者配置国内兼容的 API 端点（如 DeepSeek / Moonshot）：

1# 示例：使用 DeepSeek
2$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
3$env:ANTHROPIC_AUTH_TOKEN = "sk-你的deepseek密钥"

8.5 更新 Claude Code

1npm update -g @anthropic-ai/claude-code

附录：相关链接

资源	链接
Node.js 官网	https://nodejs.org/
Claude Code 文档	https://docs.anthropic.com/en/docs/claude-code/overview
npm 淘宝镜像	https://registry.npmmirror.com
Anthropic Console	https://console.anthropic.com/

文档版本：2025-06-08 | 适用 Claude Code v0.2.x+

📡

👤 作者: One

🔗 链接: https://onedayxyy.cn/topics/hdhqd

🌐 版权: 本站文章除特别声明外，均采用 CC BY-NC-SA 4.0 协议，转载请注明来自 One Blog！

上一篇 one博客被骂哭了下一篇评测one博客

提问