通过 npm 安装 Codex、Gemini CLI 前的 Node.js 环境准备
什么时候需要
通过 npm 安装 Codex 或 Gemini CLI 时,需要先安装 Node.js。以下情况可以跳过本页- 只使用 Claude Code(官方安装脚本、Homebrew、WinGet 均不依赖 Node.js)
- 使用 Homebrew 安装 Codex、Gemini CLI,或使用官方安装脚本安装 Codex
配置步骤
步骤一:安装 Node.js
通过 npm 安装 Codex 和 Gemini CLI 需要 Node.js 18 或更高版本。Claude Code 使用官方安装脚本、Homebrew 或 WinGet 安装,不依赖 Node.js[!NOTE] 如果你已安装 Node.js 18 或更高版本,可跳过本步骤 需要更详细的安装教程?参考 菜鸟教程 - Node.js 安装配置macOS 方法一:使用 Homebrew(推荐)
- 访问 Node.js 官网
- 下载 LTS 版本的
.pkg安装包 - 运行安装程序并按照提示完成安装
- 访问 Node.js 官网
- 下载 LTS 版本的 Windows Installer
.msi - 运行安装程序,按默认设置完成安装
- 安装程序会自动添加到 PATH 环境变量
步骤二:确认环境已就绪
验证安装:- 显示已安装的全局包列表(没有任何内容也没关系)
- 如果提示「命令未找到」,说明 Node.js 未正确安装或未添加到环境变量
下一步
Node.js 环境配置完成后,安装你要使用的 CLI 工具Codex 安装和配置 Codex
Claude Code 安装和配置 Claude Code
Gemini CLI 安装和配置 Gemini CLI安装完成后,可以使用 CC-Switch 通过图形界面管理配置