Volta から mise へ移行する方法（2026年版・メンテナンス終了対応）

なぜ Volta から mise へ？

Volta は Node.js のバージョン管理ツールとして広く使われてきたが、メンテナンスが事実上終了している。メンテナー自身が GitHub Issue で「mise への移行を推奨する」と明言しており、新機能の追加やバグ修正は期待できない状態。

Volta 自体が今すぐ壊れるわけではないが、今後の Node.js / Windows のアップデートに追従しないため、いずれ何かしらの問題に当たる。新規環境ならもう mise で始める方が無難。

「volta から mise への移行」というテーマは、計画と実作業で詰まりどころが分かれる。1本の長い記事にすると読みづらいので、目的別に3本に分けて書いた。このページはその索引。

知りたいこと	該当記事
そもそも何が起きたのか・移行方針をどう立てたか	Voltaがメンテナンス終了 - miseへの移行をどう進めるか
実際に移行作業で詰まったポイント	Volta から mise への移行完了 - Claude Code を入れ直すまでに詰まった5つの落とし穴
Volta 環境のままで OpenAI Codex を入れる/更新する	OpenAI Codex インストール・アップデート手順（Volta環境）

詳細は上記の各記事に譲るとして、最短経路だけ書くとこうなる。

# 公式インストーラー（Scoop が入っていれば一発）
scoop install mise

# Scoop なしの場合は winget
winget install jdx.mise

システム環境変数の編集 で、VOLTA_HOME の参照と %VOLTA_HOME%\bin を PATH から削除する。

⚠️ Windows の落とし穴: 環境変数画面は 2047文字制限 があり、長すぎる PATH を保存しようとすると無言で拒否される。Path を一旦テキストエディタにコピーして整理してから戻すのが安全。

mise use -g node@22  # 例: 最新LTSを入れる
mise install

npm i -g で入っていた CLI は mise の shims 経由になるので、もう一度入れ直す必要がある。

mise exec -- npm i -g @anthropic-ai/claude-code
mise exec -- npm i -g @openai/codex

⚠️ ただし Claude Code は 公式のネイティブインストーラー版が推奨される時期があった（npm 版が「移行のお知らせ」だけのスクリプトだった等）。詳細は移行完了記事を参照。

node --version    # mise 経由になっているか
which node        # mise の shims を指していること
mise current      # 現在のバージョン

PowerShell に which がない場合は Get-Command node で代用する。

実作業で詰まりどころを5つ書き出した（詳細記事）。

「だったら fnm や nvm-windows でもよくない？」という疑問に対しては、現状（2026年6月時点）こう答えられる。

ツール	状況	Windows 対応	多言語対応
mise	活発に開発中。Volta 公式が後継として推奨	◎	◎（Python/Ruby/Go なども管理）
fnm	活発に開発中。Node 専用で軽量	◎	✕
nvm-windows	開発は継続しているが mise/fnm より遅め	○	✕
Volta	メンテナンス終了	○	△（限定的）

「Node 以外も管理したい」「将来 Python のバージョン切り替えも欲しい」場合は mise が無難。「Node だけ軽くやりたい」なら fnm も悪くない。