Claude Code 安装指南

Claude Code 是 Anthropic 官方推出的 AI 编程助手，可以在终端、IDE、桌面应用和浏览器中帮助你编写、理解和优化代码。

快速导航

⊞ Windows 版本
🍎 macOS 版本
🐧 Linux 版本
VSCode 中使用 Claude Code — 在 VSCode 中安装配置 Claude Code
🍒 Cherry Studio 配置教程 — 在 Cherry Studio 中使用 VBCode.io API
🤖 CodeX 配置教程 — 在 CodeX 中使用 VBCode.io API
🦞 OpenClaw 配置教程 — 在 OpenClaw 中使用 VBCode.io API

⊞ Windows 版本教程

步骤 1：安装 Node.js

方法一：使用官方安装包（推荐）

访问 https://nodejs.org
下载 LTS 版本的 Windows Installer (.msi)
运行安装程序，按默认设置完成安装
安装程序会自动添加到 PATH 环境变量

方法二：使用包管理器

使用 Winget（Windows 11 或 Windows 10 自带）：

powershell

winget install OpenJS.NodeJS.LTS

使用 Chocolatey：

powershell

choco install nodejs-lts

使用 Scoop：

powershell

scoop install nodejs-lts

验证安装：

bash

node --version
npm --version

提示

建议使用 LTS（长期支持）版本以获得最佳稳定性。安装完成后需重启命令行窗口。

步骤 2：安装 Claude Code

方法一：原生安装（推荐）

原生安装会自动在后台更新，保持最新版本。Windows 需要先安装 Git for Windows。

PowerShell：

powershell

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

CMD：

batch

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

方法二：WinGet

powershell

winget install Anthropic.ClaudeCode

注意

WinGet 安装不会自动更新，需要定期运行 winget upgrade Anthropic.ClaudeCode 获取最新版本。

验证安装：

bash

claude --version

步骤 3：配置 VBCode.io API

3.1 获取 Auth Token

访问 VBCode.io API 控制台进行以下操作：

点击「添加令牌」
名称: 随便填写方便自己区分即可
令牌分组: 根据实际需要选择, 分组有详细描述（必填项，不能留空）
额度建议：设置为无限额度
其他选项保持默认

3.2 配置环境变量

重要提示

请将下方的 ANTHROPIC_AUTH_TOKEN 替换为您在 https://vbcode.io/console/token 生成的 API 密钥！

settings.json 配置（推荐，永久生效）

配置位置：%USERPROFILE%\.claude\settings.json

举例：C:\Users\{你的用户名}\.claude\settings.json

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://www.vbcode.io"
  }
}

claude.json 配置（添加一个 key）

⚠️ 特别注意 - 请仔细阅读！

在 %USERPROFILE%\.claude.json 文件中添加：

json

{
  ... (其他现有配置保持不变)
  "hasCompletedOnboarding": true
}

❌ 不要看错文件！不要添加到 %USERPROFILE%\.claude\settings.json

这是两个不同的文件：

✅ 正确：%USERPROFILE%\.claude.json（根目录下的文件）
❌ 错误：%USERPROFILE%\.claude\settings.json（.claude 文件夹内的文件）

步骤 4：启动 Claude Code

配置完成后，先进入到工程目录：

bash

cd your-project-folder

然后，运行以下命令启动：

bash

claude

🍎 macOS 版本教程

步骤 1：安装 Node.js

方法一：使用 Homebrew（推荐）

如果尚未安装 Homebrew：

bash

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

使用 Homebrew 安装 Node.js：

bash

brew install node

方法二：使用官方安装包

访问 https://nodejs.org
下载 LTS 版本的 macOS Installer (.pkg)
运行安装程序，按默认设置完成安装

验证安装：

bash

node --version
npm --version

步骤 2：安装 Claude Code

方法一：原生安装（推荐）

原生安装会自动在后台更新，保持最新版本。

bash

curl -fsSL https://claude.ai/install.sh | bash

方法二：Homebrew

bash

brew install --cask claude-code

注意

Homebrew 安装不会自动更新，需要定期运行 brew upgrade claude-code 获取最新版本。

验证安装：

bash

claude --version

步骤 3：配置 VBCode.io API

3.1 获取 Auth Token

访问 VBCode.io API 控制台进行以下操作：

点击「添加令牌」
名称: 随便填写方便自己区分即可
令牌分组: 根据实际需要选择, 分组有详细描述（必填项，不能留空）
额度建议：设置为无限额度

3.2 配置环境变量

重要提示

请将下方的 ANTHROPIC_AUTH_TOKEN 替换为您在 https://vbcode.io/console/token 生成的 API 密钥！

settings.json 配置（推荐，永久生效）

配置位置：~/.claude/settings.json

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://www.vbcode.io"
  }
}

claude.json 配置（添加一个 key）

⚠️ 特别注意 - 请仔细阅读！

在 ~/.claude.json 文件中添加：

json

{
  ... (其他现有配置保持不变)
  "hasCompletedOnboarding": true
}

❌ 不要看错文件！不要添加到 ~/.claude/settings.json

这是两个不同的文件：

✅ 正确：~/.claude.json（用户根目录下的文件）
❌ 错误：~/.claude/settings.json（.claude 文件夹内的文件）

步骤 4：启动 Claude Code

配置完成后，先进入到工程目录：

bash

cd your-project-folder

运行以下命令启动：

bash

claude

🐧 Linux 版本教程

步骤 1：安装 Node.js

Ubuntu/Debian：

bash

sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS/RHEL/Fedora：

bash

sudo dnf install nodejs npm
# 或者
sudo yum install nodejs npm

Arch Linux：

bash

sudo pacman -S nodejs npm

验证安装：

bash

node --version
npm --version

步骤 2：安装 Claude Code

原生安装（推荐）

原生安装会自动在后台更新，保持最新版本。

bash

curl -fsSL https://claude.ai/install.sh | bash

验证安装：

bash

claude --version

步骤 3：配置 VBCode.io API

3.1 获取 Auth Token

访问 VBCode.io API 控制台进行以下操作：

点击「添加令牌」
名称: 随便填写方便自己区分即可
令牌分组: 根据实际需要选择, 分组有详细描述（必填项，不能留空）
额度建议：设置为无限额度

3.2 配置环境变量

重要提示

请将下方的 ANTHROPIC_AUTH_TOKEN 替换为您在 https://vbcode.io/console/token 生成的 API 密钥！

settings.json 配置（推荐，永久生效）

配置位置：~/.claude/settings.json

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://www.vbcode.io"
  }
}

claude.json 配置（添加一个 key）

⚠️ 特别注意 - 请仔细阅读！

在 ~/.claude.json 文件中添加：

json

{
  ... (其他现有配置保持不变)
  "hasCompletedOnboarding": true
}

❌ 不要看错文件！不要添加到 ~/.claude/settings.json

这是两个不同的文件：

✅ 正确：~/.claude.json（用户根目录下的文件）
❌ 错误：~/.claude/settings.json（.claude 文件夹内的文件）

步骤 4：启动 Claude Code

配置完成后，先进入到工程目录：

bash

cd your-project-folder

运行以下命令启动：

bash

claude

Claude Code 安装指南 ​

⊞ Windows 版本教程 ​

步骤 1：安装 Node.js ​

步骤 2：安装 Claude Code ​

步骤 3：配置 VBCode.io API ​

3.1 获取 Auth Token ​

3.2 配置环境变量 ​

步骤 4：启动 Claude Code ​

🍎 macOS 版本教程 ​

步骤 1：安装 Node.js ​

步骤 2：安装 Claude Code ​

步骤 3：配置 VBCode.io API ​

3.1 获取 Auth Token ​

3.2 配置环境变量 ​

步骤 4：启动 Claude Code ​

🐧 Linux 版本教程 ​

步骤 1：安装 Node.js ​

步骤 2：安装 Claude Code ​

步骤 3：配置 VBCode.io API ​

3.1 获取 Auth Token ​

3.2 配置环境变量 ​

步骤 4：启动 Claude Code ​

Claude Code 安装指南

⊞ Windows 版本教程

步骤 1：安装 Node.js

步骤 2：安装 Claude Code

步骤 3：配置 VBCode.io API

3.1 获取 Auth Token

3.2 配置环境变量

步骤 4：启动 Claude Code

🍎 macOS 版本教程

步骤 1：安装 Node.js

步骤 2：安装 Claude Code

步骤 3：配置 VBCode.io API

3.1 获取 Auth Token

3.2 配置环境变量

步骤 4：启动 Claude Code

🐧 Linux 版本教程

步骤 1：安装 Node.js

步骤 2：安装 Claude Code

步骤 3：配置 VBCode.io API

3.1 获取 Auth Token

3.2 配置环境变量

步骤 4：启动 Claude Code