Node.js 和 Git 是后续配置 Codex、Claude Code、CC-Switch 等工具时经常会用到的基础环境。建议优先安装 Node.js LTS 版本，并确认 Git 可以在终端中正常运行。

​
安装方法

Windows 新手可以优先使用图形界面安装。macOS、Linux 或熟悉命令行的用户，也可以直接用系统包管理器安装。

​
Windows 图形界面安装

​
安装 Node.js

打开 Node.js 官网，下载 LTS 版本安装包。 Node.js 中文下载页 安装包通常是 .msi 文件，双击运行后按默认选项继续即可。

​
安装 Git

打开 Git for Windows 下载页，下载安装包。 Git 官方 Windows 下载页 双击运行安装包，按默认选项完成安装即可。
安装完成后，建议重新打开一次 PowerShell 或终端窗口，再执行验证命令。

​
命令行安装

按你的操作系统选择对应命令。

​
Windows

Windows 10/11 可以使用 winget： 
winget install OpenJS.NodeJS.LTS
winget install Git.Git

​
macOS

macOS 推荐使用 Homebrew： 
brew install node git
如果还没有安装 Homebrew，可以先按 Homebrew 官网 的说明安装。 macOS 首次运行 git --version 时，如果系统提示安装 Command Line Tools，按提示安装即可。

​
Linux

Linux 推荐使用 nvm 安装 Node.js LTS，便于后续切换 Node 版本： 
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts
Git 按发行版选择对应命令： 
sudo apt install -y git

sudo dnf install -y git

sudo pacman -S git

​
验证安装

安装完成后，打开终端执行： 
node -v
npm -v
git --version
三条命令都能输出版本号，就说明 Node.js、npm 和 Git 已经可用。

​
常见问题

​
node 或 git 命令不存在

先关闭当前终端并重新打开。如果仍然提示命令不存在，通常是安装没有完成，或系统环境变量没有刷新。

​
应该安装哪个 Node.js 版本

优先安装 LTS 版本。除非某个工具明确要求特定版本，否则不建议安装过旧版本。

​
后续配置还需要什么

如果你准备用 Codex 或 Claude Code，请继续查看「创建和使用 APIKEY」，确认 API Key、Base URL 和令牌分组配置正确。