Node.js 環境安裝指南

Claude Code、Gemini CLI、Codex 等工具均依賴 Node.js 執行環境，請先完成此步驟。

Windows

• 方法一：官方下載（推薦）
  前往 Node.js 官網 下載 LTS 版本，雙擊安裝包按提示完成安裝。

• 
  下載以後，一直下一步直到安裝完成

• 方法二：使用 Chocolatey

  choco install nodejs-lts
  

• 方法三：使用 Scoop

  scoop install nodejs-lts
  

macOS

• 方法一：使用 Homebrew（推薦）

  brew install node
  

• 方法二：官方下載
  前往 Node.js 官網 下載 macOS 安裝包。

Linux

• Ubuntu / Debian

  curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
  sudo apt-get install -y nodejs
  

• CentOS / RHEL

  curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
  sudo yum install -y nodejs
  

驗證安裝

node --version
npm --version

兩個指令均輸出版本號即表示安裝成功。

切換 npm 鏡像源（無科學上網環境）

如果安裝依賴時速度較慢或超時，執行以下指令切換到國內鏡像源：

npm config set registry https://registry.npmmirror.com

驗證是否切換成功：

npm config get registry

輸出 https://registry.npmmirror.com 即表示生效。