安装 Claude Code

本页只讲如何手动安装 Claude Code。新手如果想一次性安装并配置 Elucid Relay，优先看 Elucid 一键安装法。

适合谁看

• 只想安装 Claude Code，不安装 Codex。
• 不想使用一键安装器。
• 已经熟悉命令行，只需要确认安装和验证步骤。

开始前准备

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

node -v
npm -v

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

系统	建议
Windows	从 https://nodejs.org 下载 LTS 安装包
macOS	从官网安装，或使用 Homebrew 安装 Node.js
Linux	使用系统包管理器或 NodeSource 安装 Node.js

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

安装命令

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

macOS 或 Linux 如果遇到权限问题，先确认 Node.js 是否安装在当前用户环境。确实需要系统权限时再使用：

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

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

验证安装

claude --version

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

下一步配置中转

安装成功后，还需要写入 Elucid Relay 的 API Key 和 Base URL。

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

常见问题

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