快速开始

阅读完本节后，你将会：

• 拥有 VibeAPI 的 API Key
• 安装好 CC Switch 并完成配置
• 安装好 Git、Node.js、Claude Code / Codex
• 可以直接开始 AI 编程

本节提供最简单直接的方式，让你从零开始用上 VibeAPI。

Windows 用户？ 直接从下面开始阅读。Mac/Linux 用户？ 点击跳转

Windows 用户

1. 注册并获取 API Key

1. 打开 https://www.vibeapi.cn ，点击右上角「注册」

2. 邮箱注册（无需手机号），登录后点击左侧菜单「充值」，先充 $5 测试

3. 点击左侧菜单「令牌」→ 右上角「添加令牌」

4. 分组选 default（所有模型都能用），点击「提交」

5. 立刻复制 显示的 sk- 开头密钥，粘贴到记事本保存

关闭后无法再次查看这个 Key！

2. 安装 CC Switch

CC Switch 帮你把 VibeAPI 配置一键写入 Claude Code / Codex，不需要手动编辑任何文件。

下载地址：CC Switch Windows 安装包

1. 点击上方链接下载 .msi 文件
2. 双击下载的文件，一路「下一步」完成安装

3. 从开始菜单打开 CC Switch

4. 点击「登录」，输入你的 VibeAPI 账号（和网站注册的是同一个）

5. 登录后自动同步配置，看到 VibeAPI 显示「已激活」就完成了

配置已写入！后面装完 Claude Code / Codex 直接就能用。

3. 安装 Git

下载地址：https://registry.npmmirror.com/-/binary/git-for-windows/v2.52.0.windows.1/Git-2.52.0-64-bit.exe

下载后双击安装，一直点「下一步」即可。

已安装过 Git 的可以跳过这一步。

4. 安装 Node.js

下载地址：https://npmmirror.com/mirrors/node/v24.13.0/node-v24.13.0-x64.msi

下载后双击安装，一直点「下一步」即可。

已安装过 Node.js 的可以跳过这一步。

5. 验证 Git 和 Node.js

按 Win + X，选择 终端 或 Windows PowerShell：

在终端中输入：

git --version
node -v

如果显示版本号，说明安装成功。如果提示「无法识别命令」，关闭终端重新打开再试。

PowerShell 执行策略错误？ 如果出现"禁止运行脚本"错误，以管理员身份打开 PowerShell，执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

6. 安装 Claude Code / Codex

在终端中执行：

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

如果你还需要 Codex，继续执行：

npm install -g @openai/codex

官方已推出原生安装方式（不需要 Node.js），但安装脚本需要访问 claude.ai（国内不通）。国内用户继续用 NPM 镜像安装即可。

7. 开始使用

在终端中输入：

claude

如果看到对话界面并能正常回复，恭喜你，配置完成！🎉

不要跟着提示登录 Anthropic 官方账号。CC Switch 已经配好了 VibeAPI，直接用就行。

提示「No suitable shell found」？ 这是 Git 没有正确安装。按 Win + S 搜索「环境变量」→ 编辑系统环境变量 → 环境变量 → 系统变量 → 新建：变量名 CLAUDE_CODE_GIT_BASH_PATH，变量值 C:\Program Files\Git\bin\bash.exe。保存后重启终端再试。

Mac/Linux 用户

1. 注册并获取 API Key

和 Windows 用户一样：

1. 打开 https://www.vibeapi.cn ，邮箱注册
2. 登录后充值 $5 测试
3. 左侧菜单「令牌」→「添加令牌」→ 分组选 default → 提交
4. 立刻复制 sk- 开头的密钥保存到备忘录

（截图同上方 Windows 部分）

2. 安装 CC Switch

macOS：

方法一（推荐）：直接下载安装包

下载地址：CC Switch macOS 安装包

下载后双击 .dmg 文件，将 CC Switch 图标拖入 Applications 文件夹。

方法二：Homebrew 安装

brew tap farion1231/ccswitch
brew install --cask cc-switch

Linux：

从 GitHub Releases 下载：

• Ubuntu/Debian：.deb（sudo dpkg -i xxx.deb）
• Fedora：.rpm（sudo rpm -i xxx.rpm）
• Arch：paru -S cc-switch-bin
• 其他：.AppImage

打开 CC Switch 并登录：

打开 CC Switch → 登录 VibeAPI 账号 → 自动同步配置 → 看到「已激活」即完成。

3. 安装 Git

macOS：

首次在终端输入 git 会提示安装 Xcode 命令行工具，点击「安装」即可。

或主动执行：

xcode-select --install

Linux：

# Ubuntu/Debian
sudo apt update && sudo apt install git -y

# CentOS/RHEL
sudo yum install git -y

# Fedora
sudo dnf install git -y

4. 安装 Node.js 和 Claude Code

macOS 一键脚本：

curl -fsSL https://cnb.cool/vibevibe/scripts/-/git/raw/main/init-node-mac.sh | sed 's/\r$//' | sh

Linux 一键脚本：

curl -fsSL https://cnb.cool/vibevibe/scripts/-/git/raw/main/init-node-linux.sh | sed 's/\r$//' | sh

脚本执行完成后，关闭并重新打开终端，然后安装 Claude Code：

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

如果还需要 Codex：

npm install -g @openai/codex

5. 验证

git --version
node -v
claude --version

如果都显示版本号，说明安装成功。

6. 开始使用

claude

如果看到对话界面并能正常回复，配置完成！🎉

不要跟着提示登录 Anthropic 官方账号。CC Switch 已经配好了 VibeAPI，直接用就行。

下一步

配置完成后，你可以继续了解：

• 分组与渠道说明 — Default / Ultra 分组的区别
• CC Switch 详细配置 — 模型映射、1M 上下文等高级功能
• Codex 配置 — Codex 的详细配置说明