# vk-claude-code-Install

**Repository Path**: vk168/vk-claude-code-install

## Basic Information

- **Project Name**: vk-claude-code-Install
- **Description**: 一键安装claude code脚本
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-20
- **Last Updated**: 2026-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code 安装教程

---

## 环境要求

- Windows 10 / Windows 11 系统，或 Linux / Mac 系统
- 能正常上网

---

## Windows 安装

### 方式一：一键安装（推荐）

下载下方安装包，双击运行，跟着提示操作即可自动完成所有安装步骤：

**下载地址：** [点我下载 ClaudeCodeInstaller.exe](https://gitee.com/vk168/vk-claude-code-install/releases/download/1.0.0/ClaudeCodeInstaller.exe)

> **注意：** 启动时会弹出 UAC 管理员权限确认框，请点击「是」允许运行。如果被 Windows Defender 拦截，请点击「更多信息」→「仍要运行」。

使用步骤：
1. 双击运行 `ClaudeCodeInstaller.exe`
2. 点击「开始安装」，工具会自动下载并配置 NVM、Node.js、Claude Code
3. 遇到 NVM / CC-Switch / Git 安装程序时，**手动点击 Next 完成安装**，然后回到工具点击「继续」
4. 全部完成后，打开 cmd 输入 `claude` 即可使用

> 如果自动安装遇到问题，请使用下方「方式二：手动安装」

---

### 方式二：手动安装

如果你更喜欢手动操作，或者自动安装遇到问题，请按以下步骤操作：

#### 第一步：下载安装 NVM

NVM（Node Version Manager）是一个管理 Node.js 版本的工具，我们需要用它来安装 Node.js，也方便切换 Node.js 版本

1. 点击下方链接下载安装包：

   **下载地址：** [点我下载](https://gitee.com/vk168/vk-claude-code-install/releases/download/1.0.0/nvm-setup.exe)

2. 双击下载好的 `nvm-setup.exe`，一路狂点 **Next** 直到安装完成即可，所有选项保持默认。

如果安装完成后出来这个页面，直接关掉即可

![](README_files/13.jpg)

---

#### 第二步：安装 Node.js 22

1. 按 `Win + R` 键，输入 `cmd`，回车，打开 **命令提示符**（黑窗口，不要用 PowerShell，用 cmd）。

![](README_files/14.jpg)

2. 在黑窗口中依次输入以下命令

- 2.1 输入以下命令，然后回车：

```
nvm node_mirror https://npmmirror.com/mirrors/node/
```

- 2.2 输入以下命令，然后回车：

```
nvm npm_mirror https://npmmirror.com/mirrors/npm/
```

- 2.3 输入以下命令，然后回车：

```
nvm install 22
```

等待下载安装完成，看到类似 `Downloading node.js version 22.x.x...` 和 `Installation complete.` 的提示就说明成功了。

![](README_files/15.jpg)

3. 接着输入以下命令，切换使用 Node.js 22：

```
nvm use 22
```

看到 `Now using node v22.x.x` 就说明切换成功了。

![](README_files/16.jpg)

> **注意：** 如果提示 `nvm` 不是内部命令，请**关闭当前黑窗口，重新打开一个新的 cmd 窗口**再试。

---

#### 第三步：验证 Node.js 版本

在 cmd 中输入：

```
node -v
```

确保输出的版本号是以 `v22` 开头的，例如：

```
v22.22.3
```

![](README_files/17.jpg)

如果版本号正确，继续下一步。如果版本号不对，请回到第二步重新执行 `nvm use 22`。

---

#### 第四步：安装 Claude Code

在 cmd 中输入以下命令（整个复制粘贴）：

```
npm install -g @anthropic-ai/claude-code@2.1.150 --registry https://registry.npmmirror.com
```

![](README_files/24.jpg)

等待安装完成，没有报红色 `ERR!` 就说明成功了。

当页面显示 `added 2 packages in 11s` 类似这样的文字时，代表成功了，可以关闭这个窗口了

---

#### 第五步：下载安装 CC-Switch

CC-Switch 是一个帮助你管理 API Key 的工具。

1. 点击下方链接下载安装包：

   **下载地址：** [点我下载](https://gitee.com/vk168/vk-claude-code-install/releases/download/1.0.0/CC-Switch-v3.15.0-Windows.msi)

2. 双击下载好的 `CC-Switch-v3.15.0-Windows.msi`，一路狂点 **Next** 直到安装完成。

---

#### 第六步：配置 API Key

1. 打开刚安装好的 **CC-Switch** 软件。

![](README_files/1.jpg)

![](README_files/2.jpg)

![](README_files/3.jpg)

2. 在软件中填入你的 `API Key` 和 `请求地址`。

> 如果你还没有 API Key，可以联系 QQ：370725567 购买获取

![](README_files/4.jpg)

![](README_files/5.jpg)

![](README_files/6.jpg)

![](README_files/7.jpg)

![](README_files/8.jpg)

打开设置后，鼠标滚轮向下滚，看到下面的页面

![](README_files/9.jpg)

---

#### 第七步：启动 Claude Code

1. 按 `Win + R` 键，输入 `cmd`，回车，打开一个新的命令提示符窗口。

2. 输入以下命令：

```
claude
```

![](README_files/10.jpg)

3. 如果看到 Claude Code 的欢迎界面，恭喜你，安装成功！你可以开始使用了（如下图所示）

![](README_files/11.jpg)

4. 输入你是谁，测试是否真的可以使用，如下图，AI 回答了问题，代表可以使用了。

![](README_files/12.jpg)

---

#### 第八步：实战，在指定项目启动 Claude Code

一般不在系统默认目录运行 Claude Code，你应该先创建你的项目目录，比如项目在 `D://my-project` （注意：项目名最好用全英文，不要使用中文命名）

1. 右键指定文件夹，点【在终端中打开】

![](README_files/19.jpg)

2. 输入以下命令：

```
claude
```

![](README_files/20.jpg)

![](README_files/21.jpg)

3. 可以开始愉快的指挥 AI 干活了，我们以写一个坦克大战的网页小游戏为例

![](README_files/22.jpg)

![](README_files/23.jpg)

写完后，我们可以让 AI 帮我们运行这个游戏，如果发现运行不起来，那就是 AI 写的有问题，让他自己检查或者你把当前的运行现状告诉 AI，让他自己分析错误原因。

最终游戏页面如下

![](README_files/26.jpg)

是不是很简单？

**以前写这样一个小游戏程序员大概需要花半天到一天时间左右，而现在 AI 5 分钟就搞定了，你还可以不断指挥 AI 让他给你加新功能**

---

## Linux / Mac 一键安装

打开终端，执行以下命令即可自动完成安装：

**基础安装（安装后手动配置 API Key）：**

```bash
bash <(curl -fsSL https://gitee.com/vk168/vk-claude-code-install/raw/master/install.sh)
```

**安装并自动配置 API Key：**

```bash
bash <(curl -fsSL https://gitee.com/vk168/vk-claude-code-install/raw/master/install.sh) --key=你的API密钥
```

**安装并自动配置 API Key + 自定义 API 地址：**

```bash
bash <(curl -fsSL https://gitee.com/vk168/vk-claude-code-install/raw/master/install.sh) --key=你的API密钥 --url=https://你的API地址
```

> 如果你还没有 API Key，可以联系 QQ：370725567 购买获取

---

## 安装 git 代码版本控制软件

一般大部分 Windows 电脑都是 x86 架构（下载第一个），如果你的是 arm 架构，则下载第二个

在 cmd 命令窗口输入

```bash
echo %PROCESSOR_ARCHITECTURE%
```

如果返回 `AMD64`，则下载第一个，如果返回 `ARM64`，则下第二个

**注意：系统必须是 64 位操作系统**

[AMD64 架构 Git-2.54.0-64-bit.exe](https://gitee.com/vk168/vk-claude-code-install/releases/download/1.0.0/Git-2.54.0-64-bit.exe)
[ARM64 架构 Git-2.54.0-arm64.exe](https://gitee.com/vk168/vk-claude-code-install/releases/download/1.0.0/Git-2.54.0-arm64.exe)

只需要安装成功，如何使用 git 可以直接让 AI 操作

比如直接在 Claude Code 里输入 `提交git`，ai 就会提交代码，输入 `还原git`，ai 就会还原代码

## 常见问题

### Q：输入 `nvm` 提示不是内部或外部命令？

**A：** 安装完 NVM 后需要重新打开 cmd 窗口才能生效。请关闭当前的 cmd，重新按 `Win + R` 输入 `cmd` 打开一个新窗口再试。

### Q：`nvm use 22` 报错？

**A：** 请确保你是用 **管理员身份** 运行 cmd。方法：在开始菜单搜索 `cmd`，右键点击它，选择 **"以管理员身份运行"**，然后再执行命令。

### Q：`npm install -g claude-code` 安装很慢或失败？

**A：** 确保你复制了完整的命令（`npm install -g claude-code --registry https://registry.npmjs.org`）。如果网络不好可以多试几次。

### Q：输入 `claude` 没有任何反应？

**A：** 请确认前六步骤都成功了。另外请确保使用的是新打开的 cmd 窗口。

### Q：`node -v` 显示的版本不是 22？

**A：** 执行 `nvm use 22` 后再检查。如果还是不对，执行 `nvm list` 看看有没有安装成功 22 版本。

---

## 完整命令速查

把以下命令按顺序一条一条在 cmd 中执行即可：

```bash
# 第1步已经通过下载安装包完成了，从第2步开始

# 第2步：安装并切换 Node.js 22
nvm install 22
nvm use 22

# 第3步：确认版本（应该是 v22.x.x）
node -v

# 第4步：安装 Claude Code
npm install -g claude-code --registry https://registry.npmjs.org

# 第5步已经通过下载安装包完成了
# 第6步通过 CC-Switch 软件配置 API Key

# 第7步：启动
claude
```