Node.js セットアップ

chroでは、Claude CodeやOpenAI Codexなどの AIコーディングツールを実行するために Node.js 18以上 が必要です。

既存のインストール確認

まず、Node.jsがすでにインストールされているか確認します：

node -v
npm -v

両方のコマンドでバージョン番号（Node.js 18以上）が表示されれば、準備完了です。そうでない場合は、以下のインストール手順に従ってください。

---

macOS

方法1: Homebrew（推奨）

HomebrewはmacOSで最も人気のあるパッケージマネージャーです。

1. Homebrewをインストール（未インストールの場合）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Node.jsをインストール：

brew install node@22

3. インストールを確認：

node -v  # v22.x.x と表示されるはず
npm -v   # 10.x.x 以降と表示されるはず

方法2: fnm（Fast Node Manager）

fnmを使うと、複数のNode.jsバージョンを簡単に管理できます。

1. Homebrew経由でfnmをインストール：

brew install fnm

2. シェルにfnmを追加（~/.zshrcまたは~/.bashrcに追加）：

eval "$(fnm env --use-on-cd)"

3. ターミナルを再起動するか、以下を実行：

source ~/.zshrc  # または source ~/.bashrc

4. Node.js 22をインストールして使用：

fnm install 22
fnm use 22
fnm default 22

方法3: 公式インストーラー

Node.js公式サイトからmacOSインストーラーをダウンロードします。

1. LTSバージョン（推奨）またはCurrentバージョンをダウンロード
2. .pkgファイルを開き、インストールウィザードに従う
3. インストール後、ターミナルを再起動

---

Windows

方法1: winget（推奨）

wingetはWindowsの公式パッケージマネージャーで、Windows 11にはプリインストールされており、Windows 10でも利用可能です。

1. PowerShellまたはターミナルを開く

2. Node.jsをインストール：

winget install OpenJS.NodeJS.LTS

注意: UAC（ユーザーアカウント制御）のプロンプトが表示されたら、「はい」をクリックしてインストールを許可してください。

3. ターミナルを再起動（重要！）

4. インストールを確認：

node -v
npm -v

方法2: 公式インストーラー

Node.js公式サイトからWindowsインストーラーをダウンロードします。

1. LTSバージョンの.msiインストーラーをダウンロード
2. インストーラーを実行し、ウィザードに従う
3. インストール時に「Add to PATH」にチェックが入っていることを確認
4. インストール後、ターミナルを再起動

方法3: nvm-windows

nvm-windowsを使うと、Windows上で複数のNode.jsバージョンを管理できます。

1. nvm-windowsをダウンロード：

リリースページから最新のインストーラーをダウンロードします。

2. nvm-windowsをインストール：

インストーラーを実行し、プロンプトに従います。

3. Node.jsをインストールして使用：

nvm install 22
nvm use 22

---

インストールの確認

インストール後、すべてが正常に動作しているか確認します：

# Node.jsのバージョンを確認（18以上であること）
node -v

# npmのバージョンを確認
npm -v

# グローバルパッケージの場所を確認してnpmをテスト
npm root -g

トラブルシューティング

”command not found: node”（macOS/Linux）

• Node.jsがPATHに含まれていることを確認
• ターミナルを再起動
• fnmを使用している場合、シェル設定にeval行が追加されていることを確認

”node は認識されていません”（Windows）

• ターミナル/PowerShellを再起動
• Node.jsがシステムPATHに含まれているか確認：
  • システムのプロパティ > 詳細設定 > 環境変数 を開く
  • Path変数にNode.jsがあるか確認

npm 権限エラー（macOS/Linux）

グローバルパッケージのインストール時にEACCES権限エラーが表示される場合：

# グローバルパッケージ用のディレクトリを作成
mkdir ~/.npm-global

# npmがそれを使用するように設定
npm config set prefix '~/.npm-global'

# ~/.zshrcまたは~/.bashrcにPATHを追加
export PATH=~/.npm-global/bin:$PATH

プロキシの問題（企業ネットワーク）

企業プロキシの背後にいる場合：

npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

---

次のステップ

Node.jsがインストールされたら、次に進んでください：

• Git & GitHub セットアップ - バージョン管理のセットアップ
• AIコーディングツールのセットアップ - Claude CodeまたはOpenAI Codexをインストール