安装 Claude Code
本页只讲如何手动安装 Claude Code。新手如果想一次性安装并配置中转站,优先看 C+ 懒人安装法。
适合谁看
- 只想安装 Claude Code,不安装 Codex。
- 不想使用 C+ 自动安装器。
- 已经有自己的配置习惯,只需要 CLI 安装命令。
开始前准备
Claude Code 依赖 Node.js 和 npm。先打开终端检查:
bash
node -v
npm -v如果能看到版本号,继续下一步。如果提示命令不存在,先安装 Node.js LTS。
| 系统 | 建议 |
|---|---|
| Windows | 从 https://nodejs.org 下载 LTS 安装包 |
| macOS | 从官网安装,或使用 Homebrew 安装 Node.js |
Node.js 建议使用 18 或更高版本。
安装命令
bash
npm install -g @anthropic-ai/claude-codemacOS 如果遇到权限问题,不要急着反复加 sudo。先确认 Node.js 是否安装在当前用户环境;如果你确定要使用全局系统目录,再执行:
bash
sudo npm install -g @anthropic-ai/claude-codeWindows 如果提示权限不足,请右键 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 |

