VibeAPI

安装 Claude Code

Claude Code 的多种安装方式:NPM、VSCode 插件、原生安装

如果你还没有完成前置环境配置(Git、Node.js、CC Switch),请先阅读 快速开始


NPM 命令行版(推荐)

打开终端(Windows: Win+X → 终端;macOS: Cmd+Space 搜索 Terminal),依次输入:

# 配置国内镜像(只需执行一次)
npm config set registry https://registry.npmmirror.com

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

等待 1-2 分钟,看到 added x packages 表示安装成功。

终端显示安装进度,最后出现 added x packages 表示安装成功

验证:

claude --version

终端输出版本号,如 1.x.x

不要直接运行 claude 登录官方账号。CC Switch 已经把 VibeAPI 配置写好了,直接运行 claude 即可对话,无需任何登录。

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


VSCode 插件(可选)

如果你习惯在 VSCode 中工作,可以额外安装插件版:

  1. 打开 VSCode
  2. Ctrl+Shift+X(macOS: Cmd+Shift+X)打开扩展面板
  3. 在搜索框输入 Claude Code
  4. 找到 Anthropic 官方发布的扩展(注意认准发布者),点击「安装」

VSCode 扩展面板:搜索 Claude Code,认准 Anthropic 发布者,点击「安装」按钮

  1. 安装完成后,打开任意项目文件,点击右上角 Spark ✨ 图标即可开始对话

VSCode 编辑器右上角:点击 Spark ✨ 图标打开 Claude Code 面板

不要在插件中选择登录官方账号。如果插件强制要求登录,参见 VSCode 插件详细说明 中的解决方案。

还没装 VSCode?

  1. 访问 https://code.visualstudio.com ,点击蓝色下载按钮
  2. 双击安装,全程默认下一步
  3. 安装后按 Ctrl+Shift+P → 输入 Configure Display Language → 选 中文(简体) → 重启

官方原生安装(备选,需要代理)

此方式需要终端能访问 claude.ai(国内需要代理)。如果你不确定,请使用上面的 NPM 方式

macOS / Linux:

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

Windows(PowerShell):

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

安装完成后,打开 CC Switch 确认 VibeAPI 已激活,不要走官方登录流程


如果误操作登录了官方账号

请参考 FAQ:已登录官方账号怎么切回 VibeAPI