Node.jsのインストール

このガイドでは、Windows、macOS、および Linux での Node.js のインストールについて説明します。 Node.js は、OpenSpec、フロントエンドツール、およびいくつかの開発者 CLI を含む、HagiCode ローカルツールの重要な依存関係です。

Node.jsのインストール

方法 1: 公式インストーラー (推奨)

にアクセスしてください。 Node.js 公式ウェブサイト
LTS (長期サポート) バージョンの Windows インストーラーをダウンロードします (.msi ファイル)
ダブルクリックしてインストーラーを実行します
インストールウィザードのプロンプトに従ってインストールを完了します。
- ライセンス契約に同意する
- インストールパスを選択します（デフォルトで問題ありません）
- 「必要なツールを自動的にインストールする」にチェックが入っていることを確認します
- 「インストール」をクリックしてインストールを開始します
インストールが完了したら、「完了」をクリックします

方法 2: winget を使用する

PowerShell またはコマンドプロンプトを開いて次を実行します。

winget install OpenJS.NodeJS.LTS

インストール後、変更を有効にするためにターミナルを再度開きます。

方法 1: 公式インストーラー (推奨)

にアクセスしてください。 Node.js 公式ウェブサイト
LTS (長期サポート) バージョンの macOS インストーラーをダウンロードします (.pkg ファイル)
ダブルクリックしてインストーラーを実行します
インストールウィザードのプロンプトに従ってインストールを完了します。
- 「続行」をクリックします
- ライセンス契約に同意する
- インストールディスクの選択
- 「インストール」をクリックし、管理者パスワードを入力します
インストールが完了したら「閉じる」をクリックします

方法 2: Homebrew を使用する

持っている場合自作インストールされている場合は、ターミナル経由で Node.js をインストールできます。

brew install node

:::ヒント Homebrew は自動的に Node.js を PATH に追加します。コマンドが使用できない場合は、ターミナルを再起動するか、次のコマンドを実行します。

eval "$(/opt/homebrew/bin/brew shellenv)"

:::

NodeSource リポジトリの使用 (推奨)

これは、最新の Node.js バージョンを入手する最良の方法です。

# Use curl to download the installation script
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

apt パッケージマネージャーの使用

最新バージョンが必要ない場合は、デフォルトの Ubuntu リポジトリを使用できます。

sudo apt-get update
sudo apt-get install -y nodejs npm

:::メモデフォルトリポジトリの Node.js バージョンは古い可能性があります。インストール後、バージョンをチェックして、Node.js >= 18.0 の要件を満たしていることを確認します (Node.js 24 以降を推奨します)。 :::

NodeSource リポジトリの使用 (推奨)

# Use curl to download the installation script
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

yumパッケージマネージャーの使用

sudo yum install -y nodejs npm

dnf パッケージマネージャーの使用

sudo dnf install -y nodejs npm

:::ヒント Fedora のソフトウェアリポジトリには通常、新しいバージョンの Node.js が含まれており、dnf 経由で直接インストールできます。 :::

バージョン管理ツールの使用

複数の Node.js バージョン間で切り替える必要がある場合は、バージョン管理ツールを使用できます。

Linux/macOS

# Install using curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Or install using wget
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

インストール後、シェル構成をリロードします。

source ~/.bashrc
# Or for Zsh users
source ~/.zshrc

窓

Windows では、次の使用をお勧めします。 nvm-windows:

最新のものをダウンロード nvm-setup.exe から nvm-windows リリース
インストーラーを実行する
コマンドプロンプトまたはPowerShellを再度開きます

nvm をインストールした後、それを使用して Node.js バージョンのインストールと管理を行うことができます。

# Install the latest LTS version (recommended)
nvm install --lts

# Install Node.js 24 (recommended version)
nvm install 24

# Install a specific Node.js version
nvm install 18.20.0

# List installed versions
nvm list

# Switch to a specified Node.js version
nvm use 24

# Set default version
nvm alias default 24

# Windows nvm-windows syntax is slightly different
nvm install 24
nvm use 24

fnm (高速ノードマネージャー)

fnm は、Rust で構築された、より高速かつシンプルな Node.js バージョン管理ツールです。

Installing fnm
Using fnm

Linux/macOS

# Install using curl
curl -fsSL https://fnm.vercel.app/install | bash

# After installation, reload shell configuration
source ~/.bashrc
# Or for Zsh users
source ~/.zshrc

窓

使用するスコップまたはウィンゲット:

# Use scoop
scoop install fnm

# Or use winget
winget install Schniz.fnm

# Install the latest LTS version (recommended)
fnm install --lts

# Install Node.js 24 (recommended version)
fnm install 24

# Install a specific Node.js version
fnm install 18.20.0

# List installed versions
fnm list

# Switch to a specified Node.js version
fnm use 24

# Set default version
fnm default 24

中国本土ユーザー向けの高速化

中国本土にお住まいの場合、Node.js および npm パッケージのダウンロードが遅くなる可能性があります。ここでは加速ソリューションをいくつか紹介します。

国内ミラーソースの使用

npm タオバオミラー (推奨)

# Temporarily use Taobao mirror
npm install --registry=https://registry.npmmirror.com

# Permanently set Taobao mirror
npm config set registry https://registry.npmmirror.com

# Verify mirror is set successfully
npm config get registry

nrm を使用したミラーソースの管理

nrm (npm レジストリマネージャー) は、npm ミラーソースをすばやく切り替えるのに役立ちます。

# Install nrm
npm install -g nrm

# List available mirror sources
nrm ls

# Switch to Taobao mirror
nrm use taobao

# Test mirror source speed
nrm test

Node.js インストーラーのダウンロードを高速化する

Taobao Node.js Mirror
FastGit Acceleration

Taobao では、Node.js インストーラーのミラーダウンロードを提供しています。

ダウンロードアドレス: https://npmmirror.com/mirrors/node/

上記のアドレスにアクセスし、ダウンロードする必要があるバージョンを選択してください。

GitHub からの nvm またはその他のツールのダウンロードが遅い場合は、FastGit ミラーを使用できます。

# Use FastGit to accelerate nvm installation
curl -o- https://fastgit.org/nvm-sh/nvm/raw/master/install.sh | bash

:::メモ FastGit のサービスは変更される場合がありますので、公式情報をご確認ください。 :::

国産自作ミラー

中国本土で Homebrew を使用する場合、加速のために国内ミラーを構成できます。

# Install Homebrew using domestic mirror
/bin/bash -c "$(curl -fsSL https://gitee.com/ineo6/homebrew-install/raw/master/install.sh)"

# Or use USTC mirror
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles

中国本土固有のパッケージマネージャー

CNPM

cnpm は、淘宝網チームによって提供される npm クライアントで、デフォルトで淘宝網ミラーを使用します。

# Install cnpm
npm install -g cnpm --registry=https://registry.npmmirror.com

# Use cnpm to install packages
cnpm install <package-name>

:::ヒント cnpm は npm コマンドとほぼ互換性があり、直接の置き換えとして使用できます。 :::

ミラー加速効果の検証

ミラーを設定した後、次の方法で確認します。

# Test download speed
time npm install express --registry=https://registry.npmmirror.com

# Compare with official source speed
time npm install express --registry=https://registry.npmjs.org

インストールの検証

インストール後、Node.js と npm が正しくインストールされていることを確認します。

# Check Node.js version
node --version

# Check npm version
npm --version

:::メモ Node.js バージョンが 18.0 以上であることを確認してください (Node.js 24 以降を推奨)。バージョンが低すぎる場合は、上記の方法を使用して再インストールするか、バージョン管理ツールを使用して正しいバージョンをインストールしてください。 :::

サンプル検証出力

検証が成功すると、出力は次のようになります。

$ node --version
v24.3.0

$ npm --version
10.2.3

トラブルシューティング

Windowsの問題

Command Not Available
PowerShell Execution Policy

もし node または npm インストール後はコマンドが使用できなくなります。

コマンドプロンプトまたはPowerShellを再起動します
それでも利用できない場合は、Node.js を PATH に手動で追加します。
- 「環境変数」を検索し、「システム環境変数の編集」を開きます。
- 「環境変数」をクリックします。
- 「システム環境変数」で「パス」を見つけて「編集」をクリックします。
- Node.js インストールパスを追加します (デフォルト: C:\Program Files\nodejs\)
- 「OK」をクリックして変更を保存します

nvm の使用時に実行ポリシーエラーが発生した場合:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

macOS の問題

Permission Errors
Command Not Available

グローバル npm パッケージのインストール時に権限エラーが発生した場合:

# Fix npm permissions
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

インストール後にコマンドが使用できない場合は、ターミナルを再起動するか、手動で PATH (通常は /usr/local/bin).

Linuxの問題

Permission Errors
Version Too Old

グローバル npm パッケージをインストールするときに権限エラーが発生した場合は、システムパッケージマネージャーの代わりに Node.js バージョン管理ツール (nvm や fnm など) を使用することをお勧めします。

環境の確認

検証が失敗した場合は、次のことを確認してください。

# Check if Node.js is in PATH
where node

# Check installation path
Get-Command node

# Check if Node.js is in PATH
which node

# Check installation path
ls -l $(which node)

# Check if Node.js is in PATH
which node

# Check installation path
ls -l $(which node)

# Check version details
node -v

次のステップ

Node.js のインストールが完了したら、次の手順に進むことができます。

Install OpenSpec Install the OpenSpec specification-driven development tool to manage proposals, specs, and changes.

Install AI Agent CLI Use one registry for the official install entries for Claude Code, Codex, Gemini, GitHub Copilot, CodeBuddy, OpenCode, Kimi, QoderCLI, and Kiro.

Return to Installation Guide Return to the main installation guide to continue configuring other dependencies.

さらにサポートが必要ですか?

ここで説明されていない問題が発生した場合は、次の手順を実行してください。

にアクセスしてください。 Node.js 公式ドキュメント
を確認してくださいハギコード製品概要現在の製品とツールのコンテキストに合わせて
にアクセスしてください。ハギコードウェブサイト最新のサポートエントリポイントについては、

Node.jsのインストール