Skip to content

安装 Claude Code

本页只讲如何手动安装 Claude Code。新手如果想一次性安装并配置中转站,优先看 C+ 懒人安装法

适合谁看

  • 只想安装 Claude Code,不安装 Codex。
  • 不想使用 C+ 自动安装器。
  • 已经有自己的配置习惯,只需要 CLI 安装命令。

开始前准备

Claude Code 依赖 Node.js 和 npm。先打开终端检查:

bash
node -v
npm -v

如果能看到版本号,继续下一步。如果提示命令不存在,先安装 Node.js LTS。

系统建议
Windowshttps://nodejs.org 下载 LTS 安装包
macOS从官网安装,或使用 Homebrew 安装 Node.js

Node.js 建议使用 18 或更高版本。

安装命令

bash
npm install -g @anthropic-ai/claude-code

macOS 如果遇到权限问题,不要急着反复加 sudo。先确认 Node.js 是否安装在当前用户环境;如果你确定要使用全局系统目录,再执行:

bash
sudo npm install -g @anthropic-ai/claude-code

Windows 如果提示权限不足,请右键 PowerShell 或 Windows Terminal,选择“以管理员身份运行”后重试。

验证安装

bash
claude --version

能显示版本号,就说明 Claude Code 安装成功。

下一步配置中转站

安装成功后,还需要写入 c-api 的 API Key 和 Base URL。

推荐用 ccswitch 导入配置适合大多数用户,少改文件,后续切线路也方便。备用手动配置 Claude Codeccswitch 不生效时,直接修改 settings.json。

常见问题

现象处理方式
npm 不存在重新安装 Node.js LTS,并重新打开终端
安装很慢换网络环境后重试
权限不足Windows 用管理员终端;macOS 先检查 Node 安装方式
claude --version 不存在关闭终端重开,或检查 npm 全局目录是否在 PATH