Skip to content

准备工作:安装 Node.js

Codex CLI、Claude Code、Gemini CLI、OpenClaw 都通过 npm 安装,所以先装 Node.js。已经装过的可以跳过本页。

1. 下载并安装

打开 nodejs.org,下载 LTS 长期支持版(页面左边那个,最稳定),安装时一路「下一步 / 继续」,默认配置不用改。

2. 验证是否安装成功

打开命令行工具:

  • Windows:CMD 或 PowerShell
  • macOS / Linux:终端

输入下面两条命令:

powershell
node -v   # 查看 Node.js 版本
npm -v    # 查看 npm 版本

只要都显示出版本号,就说明安装成功。

3. Windows 常见问题:无法加载脚本

PowerShell 报错:禁止运行脚本

出现上面这类"无法加载文件 … 因为在此系统上禁止运行脚本"的提示时,以管理员身份运行 PowerShell,执行:

powershell
Set-ExecutionPolicy RemoteSigned

然后重启终端再试。如果还不行,换成只对当前用户生效的写法:

powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

4. npm 源

安装 Claude Code 和 Gemini CLI 前,先确认 npm 源是官方源:

powershell
npm config get registry

返回的不是 https://registry.npmjs.org/ 时,改回来:

powershell
npm config set registry https://registry.npmjs.org/

OpenClaw 是例外

OpenClaw 的教程里用的是国内镜像 https://registry.npmmirror.com,装完 OpenClaw 后如果要再装其他工具,记得按上面的命令改回官方源。

准备好了,去配置客户端:Codex · Claude Code · Gemini CLI · OpenClaw

本教程与 api.solov.cc 同步更新;遇到问题请先看「错误码对照」,仍无法解决请联系客服。