Claude CodeのBash環境でnvmが動かない問題の解決策

Claude CodeのBashツールで nvm use 22 を実行したら nvm: command not found ——この問題に複数のプロジェクトで繰り返し遭遇しました。

本記事では、原因と回避策を簡潔にまとめます。

発生する問題

Claude CodeのBash環境でnvmコマンドを実行すると、以下のエラーが出ます。

1
$ nvm use 22
2
zsh: command not found: nvm

1
$ nvm --version
2
zsh: command not found: nvm

通常のターミナルでは問題なく動作するnvmが、Claude Codeのシェルセッションでは認識されません。

nvmは関数（シェル関数）としてロードされる仕組みです。通常、.zshrc や .bashrc に以下のような初期化コードが記述されています。

1
export NVM_DIR="$HOME/.nvm"
2
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

Claude CodeのBashツールは、各コマンド実行時にシェルを起動しますが、対話型シェルとしての完全な初期化プロセスを経ないケースがあります。その結果、nvmのシェル関数がロードされず、command not found になります。

nvmを経由せず、Node.jsのバイナリパスを直接 PATH に追加します。

1
export PATH="$HOME/.nvm/versions/node/v22.18.0/bin:$PATH"

これで node、npm、npx がClaude CodeのBash環境から使えるようになります。

1
$ export PATH="$HOME/.nvm/versions/node/v22.18.0/bin:$PATH"
2
$ node --version
3
v22.18.0
4
$ npm --version
5
10.x.x  # ※バージョンはインストール時期による

Claude Codeへの指示で、Node.jsを使うコマンドの前に export PATH を付けます。

1
export PATH="$HOME/.nvm/versions/node/v22.18.0/bin:$PATH" && npm install

1
export PATH="$HOME/.nvm/versions/node/v22.18.0/bin:$PATH" && npx astro build

プロジェクトの CLAUDE.md に明記しておけば、Claude Codeが自動的にPATH設定を含めてコマンドを実行してくれます。

1
## 環境設定
2

3
Node.jsの利用時は以下のPATH設定が必要:
4
export PATH="$HOME/.nvm/versions/node/v22.18.0/bin:$PATH"

nvm自体を使いたい場合は、初期化スクリプトを明示的にsourceします。

1
source "$HOME/.nvm/nvm.sh" && nvm use 22

ただし、これはnvmの読み込みに時間がかかるため、PATH直接指定のほうが高速です。

nvmでインストール済みのバージョン一覧は、ファイルシステムを直接確認すれば分かります。

1
ls ~/.nvm/versions/node/
2
# v18.20.0  v20.15.0  v22.18.0

現在のデフォルトバージョンは ~/.nvm/alias/default で確認できます。

1
cat ~/.nvm/alias/default
2
# 22

以下のようなケースで遭遇しやすいです。

結論として、PATHにNode.jsのバイナリパスを直接指定するのが最もシンプルで確実な回避策です。nvmの「バージョン切替」機能が必要な場面はClaude Code内では少ないため、固定パスで十分なケースがほとんどです。