コンテンツにスキップ
HagiCodeHagicode Docs

言語の選択

現在の言語: 日本語

Node.jsのインストール

ページを編集

このページでは、Windows、macOS、Linux での Node.js のインストール方法を説明します。Desktop と Microsoft Store 版は Node.js を同梱しなくなり、システムにインストールされた node と npm をそのまま使用します。OpenSpec とほとんどの Agent CLI も Node.js に依存しています。

必要なバージョン

Node.js 24 以上 が必要です。最低要件も 24 です。通常は最新の LTS バージョンをインストールすれば問題ありません。npm は Node.js と一緒にインストールされるため、別途インストールする必要はありません。

Node.js が必要なインストール方法

  • Microsoft Store / Desktop: 必要です。システムの PATH から node と npm を見つけられる必要があります。

Node.js のインストール

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

  1. Node.js 公式サイト にアクセスします
  2. LTS (長期サポート) 版の Windows インストーラー (.msi ファイル) をダウンロードし、バージョン番号が 24 以上であることを確認します
  3. ダブルクリックしてインストーラーを実行します
  4. インストールウィザードの案内に従ってインストールを完了します。
    • ライセンス契約に同意する
    • インストール先のパスを選択する (既定のままで問題ありません)
    • 「Add to PATH」のチェックを入れたままにする
    • 「Install」をクリックしてインストールを開始する
  5. インストールが完了したら、「Finish」をクリックします

方法 2: winget を使用する

PowerShell またはコマンドプロンプトを開き、次のコマンドを実行します。

终端窗口
winget install OpenJS.NodeJS.LTS

インストール後は、変更を反映させるためにターミナルを開き直してください。

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

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

Desktop をお使いの方へ

macOS と Linux では、nvm や fnm などのツールは、通常シェルの設定ファイル (.bashrc、.zshrc など) の中でのみ PATH を設定します。Dock、アプリケーションメニュー、デスクトップのアイコンから起動した Desktop はこれらの設定を読み込まないため、node を見つけられないことがあります。バージョン管理ツールを使用している場合は、すでに node を実行できるターミナルから Desktop を起動するか、前述のシステム全体へのインストール方法に切り替えてください。

nvm (Node Version Manager)

Linux/macOS

nvm 公式リポジトリの README に記載されている最新のインストールコマンドをそのままコピーして使用してください。古いバージョンのインストールスクリプトのアドレスは使用しないでください。

インストール後、シェルの設定を再読み込みします。

终端窗口
source ~/.bashrc
# Zsh を使用している場合
source ~/.zshrc

Windows

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

  1. nvm-windows のリリースページ から最新の nvm-setup.exe をダウンロードします
  2. インストーラーを実行します
  3. コマンドプロンプトまたは PowerShell を開き直します

fnm (Fast Node Manager)

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

Linux/macOS

终端窗口
# curl を使用してインストール
curl -fsSL https://fnm.vercel.app/install | bash


# インストール後、シェルの設定を再読み込み
source ~/.bashrc
# Zsh を使用している場合
source ~/.zshrc

Windows

scoop または winget を使用します。

终端窗口
# scoop を使用
scoop install fnm


# または winget を使用
winget install Schniz.fnm

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

中国本土にお住まいの場合、Node.js や npm パッケージのダウンロードが遅くなることがあります。その場合は、国内のミラーを使用できます。

npm ミラー

终端窗口
# 一時的にミラーを使用してインストール
npm install --registry=https://registry.npmmirror.com


# ミラーを恒久的に設定
npm config set registry https://registry.npmmirror.com


# ミラーが正しく設定されたか確認
npm config get registry

Node.js インストーラーのミラー

Node.js のインストーラーにも、ミラーのダウンロードアドレスがあります: https://npmmirror.com/mirrors/node/。アクセスしたら、24 以上のバージョンを選択してダウンロードしてください。

Homebrew ミラー

中国本土で Homebrew を使用している場合は、bottle に中国科学技術大学 (USTC) のミラーを設定できます。

终端窗口
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles

インストールの確認

インストールが完了したら、新しく開いたターミナル で Node.js と npm が使用できることを確認します。

终端窗口
# Node.js のバージョンを確認 (v24.0.0 以上が必要)
node --version


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

成功した場合の出力は、次のようになります。

$ node --version
v24.3.0


$ npm --version
11.4.2

node --version に表示されるバージョンが 24 より低い場合は、上記の方法で再インストールするか、バージョン管理ツールで 24 以上に切り替えてください。

npm グローバルディレクトリの設定

Desktop は、Agent CLI などの管理対象パッケージを、お使いのマシンの npm のグローバルディレクトリにインストールします。グローバルディレクトリが管理者権限を必要とする場所にあると、インストール時に EACCES の権限エラーが発生することがあります。システムのディレクトリの権限を変更するのではなく、グローバルディレクトリをユーザーのディレクトリに変更することをおすすめします。

终端窗口
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

そのうえで、~/.npm-global/bin (Windows では npm のグローバルディレクトリそのもの) をシステムの PATH に追加し、ターミナルと Desktop を再起動します。nvm や fnm を使用している場合は、グローバルディレクトリがすでにユーザーのディレクトリ内にあるため、この手順は不要です。

トラブルシューティング

Windows の問題

インストール後に node や npm コマンドが使えない場合は、次を試してください。

  1. コマンドプロンプトまたは PowerShell を再起動する
  2. それでも使えない場合は、Node.js を PATH に手動で追加する
    • 「環境変数」を検索して、「システム環境変数の編集」を開く
    • 「環境変数」をクリックする
    • 「システム環境変数」の中から「Path」を探し、「編集」をクリックする
    • Node.js のインストールパスを追加する (既定: C:\Program Files\nodejs\)
    • 「OK」をクリックして変更を保存する
  3. Desktop を完全に終了してから、起動し直す

macOS の問題

グローバルの npm パッケージをインストールする際に権限エラーが発生した場合は、前述の npm グローバルディレクトリの設定 を参照するか、nvm / fnm に切り替えてください。

Linux の問題

グローバルの npm パッケージをインストールする際に権限エラーが発生した場合は、前述の npm グローバルディレクトリの設定 を参照するか、nvm / fnm を使用してください。sudo でグローバルパッケージをインストールするのは避けてください。

環境の確認

確認に失敗する場合は、次の内容を確認してください。

终端窗口
# Node.js が PATH にあるか確認
where node


# インストールパスを確認
Get-Command node

次のステップ

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

インストールガイドに戻るGit などの前提条件を引き続き済ませ、ご自身に合ったインストール方法を選びます。
OpenSpec の紹介OpenSpec の独立したドキュメントサイトで、インストール方法、基本概念、仕様駆動のワークフローを確認できます。
AI Agent CLI のインストール現在サポートされている Agent CLI の公式インストール入口を確認し、ワンクリックインストールと手動インストール / 認証の違いを把握できます。

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

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

  1. Node.js 公式ドキュメント にアクセスする
  2. Desktop が Node 環境を使用する方法 を確認する
  3. HagiCode 製品概要 で、現在の製品と関連ツールチェーンの説明を確認する

HagiCode

HagiCode はエージェント型コーディングワークスペースです。豊富で便利な UI インタラクションにより、計画・エージェント実行・プロジェクト作業を始めやすく、進めやすくし、開発をより魅力的な体験にします。

豊富で便利な UI インタラクションで、計画からプロジェクト作業までを分かりやすく進められます。

HagiCode を見るドキュメントを読む
  • スマートOpenSpec ワークフローが意図を、提案・設計・タスクから変更のリリースまで実行可能な道筋にします。
  • 効率的マルチエージェント実行で調査・実装・レビューを並行して進め、複数リポジトリや使い慣れた Agent CLI にも対応します。
  • 興味深い豊富で便利な UI インタラクションにより、計画・エージェント実行・プロジェクト作業を始めやすく、進めやすくします。

Windows 版をダウンロード

Microsoft Store で入手すべてのダウンロード

アイデアを、出荷できるソフトウェアへ。

HagiCode はエージェント型コーディングワークスペースです。OpenSpec ワークフローで変更を計画し、マルチエージェント実行で進め、Hero Scenario で長い作業の進み具合を見える化して、アイデアを出荷できるソフトウェアにします。

HagiCode をダウンロード製品ドキュメント
スマート
OpenSpec ワークフローが、意図を提案からリリースまでの実行可能な道筋にします。
効率的
マルチエージェント実行で、調査・実装・レビューを並行して進めます。
楽しい
使いやすい UI で、計画・Agent 実行・プロジェクト作業を進めやすくします。

© 2026 HagiCode | Powered By hagilight-starlight@0.20.0 | Branch: main | Commit: 0dde182 | Built: