canonical_url: https://yycode.net/docs/zh-TW/nodejs-setup
lang: zh-TW
updated_at: 2026-07-04T13:33:48.616Z
source_html: https://yycode.net/docs/zh-TW/nodejs-setup

# Node.js 環境安裝指南

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

## Windows

- **方法一：官方下載（推薦）**
  前往 [Node.js 官網](https://nodejs.org/zh-cn/download/) 下載 LTS 版本，雙擊安裝包按提示完成安裝。
- ![](https://r2.bozhouai.com/dragoncode/file-20260317105358821.png)
下載以後，一直下一步直到安裝完成

- **方法二：使用 Chocolatey**
  ```bash
  choco install nodejs-lts
  ```
- **方法三：使用 Scoop**
  ```bash
  scoop install nodejs-lts
  ```

## macOS

- **方法一：使用 Homebrew（推薦）**
  ```bash
  brew install node
  ```
- **方法二：官方下載**
  前往 [Node.js 官網](https://nodejs.org/zh-cn/download/) 下載 macOS 安裝包。

## Linux

- **Ubuntu / Debian**
  ```bash
  curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
  sudo apt-get install -y nodejs
  ```
- **CentOS / RHEL**
  ```bash
  curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
  sudo yum install -y nodejs
  ```

## 驗證安裝

```bash
node --version
npm --version
```

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

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

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

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

驗證是否切換成功：

```bash
npm config get registry
```

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