安装 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 表示安装成功。

验证:
claude --version
不要直接运行 claude 登录官方账号。CC Switch 已经把 VibeAPI 配置写好了,直接运行 claude 即可对话,无需任何登录。
官方已推出原生安装方式(不需要 Node.js),但安装脚本需要访问 claude.ai(国内不通)。国内用户继续用 NPM 镜像安装即可。
VSCode 插件(可选)
如果你习惯在 VSCode 中工作,可以额外安装插件版:
- 打开 VSCode
- 按
Ctrl+Shift+X(macOS:Cmd+Shift+X)打开扩展面板 - 在搜索框输入
Claude Code - 找到 Anthropic 官方发布的扩展(注意认准发布者),点击「安装」

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

不要在插件中选择登录官方账号。如果插件强制要求登录,参见 VSCode 插件详细说明 中的解决方案。
还没装 VSCode?
- 访问 https://code.visualstudio.com ,点击蓝色下载按钮
- 双击安装,全程默认下一步
- 安装后按
Ctrl+Shift+P→ 输入Configure Display Language→ 选中文(简体)→ 重启
官方原生安装(备选,需要代理)
此方式需要终端能访问 claude.ai(国内需要代理)。如果你不确定,请使用上面的 NPM 方式。
macOS / Linux:
curl -fsSL https://claude.ai/install.sh | bashWindows(PowerShell):
irm https://claude.ai/install.ps1 | iex安装完成后,打开 CC Switch 确认 VibeAPI 已激活,不要走官方登录流程。