Node.js は Claude Code に必要か｜18以上とネイティブ版

Claude Code に Node.js は必要か

結論から言うと、必須ではありません。Anthropic の公式ドキュメントは、現在ネイティブインストーラーを推奨方式としており、この方式は Node.js を必要とせず、バックグラウンドで自動更新されます。

一方で、以前から使われてきた npm install -g @anthropic-ai/claude-code による導入では、Node.js が前提になります。つまり「Node.js が必要かどうか」は、どの導入方法を選ぶかで決まります。

かつて Claude Code は Node.js で動く CLI というイメージが強く、「node js claude code」で検索する人の多くはこの前提を確認したいはずです。しかし 2025 年後半以降はネイティブバイナリ方式が主流となり、npm 版すら内部的には同じネイティブバイナリを配布する形に変わりました。公式は「インストールされた claude バイナリ自体は Node を呼び出さない」と明記しています。

出典: Claude Code Advanced setup(公式ドキュメント)

Node.js が要るケース・要らないケース

判断を迷わないよう、必要・不要を整理します。

• 不要: ネイティブインストーラー(推奨)/ Homebrew / WinGet / apt・dnf・apk などのパッケージマネージャで入れる場合
• 必要: npm install -g @anthropic-ai/claude-code で入れる場合(Node.js 18 以上)

もう一つ見落としがちなのが「Claude Code で開発する対象」の話です。Claude Code 自体は Node.js に依存しなくても、あなたが Node.js / JavaScript / TypeScript のプロジェクトを Claude Code に触らせるなら、そのプロジェクトを動かすための Node.js は当然必要です。これは Claude Code の要件ではなく、開発対象の要件である点に注意してください。

推奨は Node.js 18 以上

npm 版を選ぶ場合、公式が求めるのは Node.js 18 以降 です。手元の Node.js がこれを満たすかは、次のコマンドで確認できます。

node --version

v18.0.0 以上が表示されれば npm 版の前提を満たしています。それより古い場合は Node.js を更新するか、そもそも Node.js 不要のネイティブ版に切り替えるのが手っ取り早い解決策です。

出典: Node.js 公式ダウンロード

Node.js の入れ方(npm 版を使う場合)

あえて npm 版を使いたい、あるいは既に Node.js プロジェクトで開発しているなら、以下の順で Node.js を用意します。バージョンを切り替えやすい nvm 経由が扱いやすくおすすめです。

Step 1: nvm を入れる

macOS / Linux / WSL では nvm(Node Version Manager)を導入します。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

Windows ネイティブ環境では nvm-windows か、Node.js 公式インストーラーを使います。

Step 2: Node.js 18 以上を入れる

nvm で LTS(長期サポート版)を導入し、既定にします。

nvm install --lts
nvm use --lts

Step 3: バージョンを確認する

node --version で v18 以上になっていることを確認します。

Step 4: Claude Code を入れる

Node.js が整ったら、グローバルパッケージとして導入します。

npm install -g @anthropic-ai/claude-code

このとき sudo を付けてはいけません。公式は「sudo npm install -g は権限問題とセキュリティリスクにつながる」と警告しています。権限エラーが出る場合は nvm 配下に導入するか、ネイティブ版へ切り替えてください。

Node.js なしで入れる(推奨のネイティブ版)

Node.js を一切用意したくないなら、ネイティブインストーラーが最短です。OS ごとにコマンドが分かれます。

• macOS / Linux / WSL:

curl -fsSL https://claude.ai/install.sh | bash

• Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

導入後は次のコマンドで起動・確認できます。

claude --version
claude doctor

claude doctor はインストールと設定を診断してくれるので、うまく動かないときの最初の一手として便利です。ネイティブ版は起動時と稼働中に自動で更新チェックが走り、バックグラウンドで最新版に保たれます。

npm 版とネイティブ版の違い

「どちらでもいいなら何が違うの?」という疑問には、次のように整理できます。

• 配布物は同じ: npm 版もネイティブ版も、実体は同じネイティブバイナリです。npm 版は @anthropic-ai/claude-code-darwin-arm64 のようなプラットフォーム別の optional dependency 経由でバイナリを取得し、postinstall でリンクします。
• Node.js への依存: ネイティブ版は Node.js 不要。npm 版は導入時に Node.js 18 以上が必要ですが、導入後の claude バイナリ自体は Node を呼び出しません。
• 更新方法: ネイティブ版は自動更新。npm 版は npm install -g @anthropic-ai/claude-code@latest で手動更新します(npm update -g は元の semver 範囲に縛られ最新へ動かないことがあるため避けます)。

これから新規に入れるなら、自動更新と公式サポートの手厚さからネイティブ版が無難です。

つまずきやすいポイント

最後に、Node.js まわりでよくある詰まりどころを挙げておきます。

1. Native binary not found: npm 版導入後にバイナリが見つからない場合、パッケージマネージャが optional dependency を許可しているか確認します。対応プラットフォームは darwin-arm64 linux-x64 win32-x64 などです。
2. node --version が古い: v18 未満なら nvm で LTS に更新するか、ネイティブ版に切り替えます。
3. PATH が通らない: claude が command not found になるときは、claude doctor で導入状態を診断します。
4. 権限エラー: sudo npm install -g は使わない。nvm 配下に入れるか、ネイティブ版を使うと回避できます。

なお、Claude Code の利用には Pro / Max / Team / Enterprise いずれかのアカウントが必要で、無料の Claude.ai プランでは使えません。この点は Node.js の有無とは別の前提として押さえておきましょう。

出典: Claude Code Advanced setup(公式ドキュメント)

まとめ

「node js claude code」で調べたときの答えはシンプルです。ネイティブインストーラーを使えば Node.js は不要で、curl 一発で導入できます。Node.js が必要になるのは npm で入れる場合(18 以上)か、Node.js / TypeScript のプロジェクトを Claude Code に開発させる場合だけです。手元の Node.js が古くても慌てず、まずはネイティブ版を試すのが最短ルートです。