Voltaがメンテナンス終了 - miseへの移行をどう進めるか

何が起きたか

Node.jsのバージョン管理ツールVoltaのメンテナーが、miseへの移行を推奨する声明を出した。

GitHub Issue #2080: Volta is unmaintained; we recommend migrating to mise
メンテナー自身が今はmiseを使っている
新機能の追加やバグ修正は期待できない

Volta自体が壊れたわけではないが、今後のNode.jsやWindowsのアップデートに追従しないため、いずれ問題が出る。

miseとは

mise（ミーズ）は、フランス語の "mise en place"（下ごしらえ）から来ている開発環境管理ツール。

Voltaとの比較

	Volta	mise
対象	Node.js + npmパッケージのみ	Node, Python, Go, Rust, Java 等、多言語対応
環境変数管理	なし	あり（direnv代替）
タスクランナー	なし	あり（make/npm scripts代替）
メンテナンス	停止	活発に開発中
設定ファイル	`package.json` の `volta` フィールド	`.mise.toml`
npmグローバルツール管理	あり（Node版ごとに隔離）	なし（Node版管理のみ）

最後の行が大事。Voltaは volta install @anthropic-ai/claude-code のようにグローバルCLIツールをNode バージョンごとに隔離管理できたが、miseにその機能はない。miseに移行したら、グローバルツールは普通に npm install -g で入れる形に戻る。

自分の環境の現状

Volta管理下のツール一覧（2026年3月時点）

Node.jsランタイム（11バージョン）:

[email protected], 12.22.12, 14.0.0, 14.19.3, 14.21.2,
16.0.0, 16.15.1, 18.16.0, 18.20.1, 19.5.0,
20.9.0, 20.10.0, 20.12.2, 20.17.0, 20.19.5,
22.6.0, 22.12.0, 22.15.1, 22.17.0, 22.22.0 (default)

パッケージマネージャー:

グローバルCLIツール（17個）:

@anthropic-ai/claude-code
@openai/codex
bun
ccusage
@google/clasp
dependency-cruiser
expo-cli
netlify-cli
opencommit
shadcn-ui
@squoosh/cli
tailwindcss
vercel
wrangler
@vue/cli
pnpm

PATHの構造

優先順4:  Volta/tools/image/npm/11.0.0/bin     ← npm本体
優先順6:  Volta/tools/image/node/22.22.0       ← nodeとnpm globalツール
優先順12: Program Files/Volta                   ← volta-shim.exe
優先順139: Volta/bin                            ← shim経由のツール群

全部Voltaの中。Node自体がVolta管理なので、claude-code、codex、npm、pnpmなど全ツールがVoltaの上に乗っている。

二重インストール問題

claude-codeが2箇所に存在する：

Volta/bin/claude.exe → volta-shim.exe へのシンボリックリンク（volta installで作成）
Volta/tools/image/node/22.22.0/claude → npm globalインストール（npm install -gで作成）

PATHの優先順で②が先に解決されるため、①のshimは実質使われていない。

壊れるタイムライン

Node 22 LTS のサポートは2027年4月まで → あと1年は大丈夫
Node 24 LTS（2025年10月〜）に上げたくなったときが分岐点
WindowsアップデートでshimやシンボリックリンクのAPI挙動が変わるリスクもある

「今すぐ壊れる」ではなく「Node 24に上げたくなったら困る」が正確。

移行方針

Phase 1: 今すぐやること（済）

現状を把握する。この記事がそれ。

Phase 2: miseを並行インストール

# Scoopは既にインストール済み
scoop install mise

# miseでNodeを管理開始
mise use --global node@22

この時点ではVoltaはまだPATHに残す。miseのshimsが先に来るようPATHを調整すれば、Node解決がmise経由に切り替わる。

Phase 3: グローバルツールの再インストール

miseのNode上で改めてインストール：

npm install -g @anthropic-ai/claude-code @openai/codex pnpm

他のツール（vercel, wrangler等）は必要になったタイミングで入れればよい。古いツール（@vue/cli, expo-cli, squoosh等）はもう使っていないなら入れない。

Phase 4: Voltaを外す

miseで安定動作を確認したら：

環境変数からVoltaのPATHエントリを削除
C:\Program Files\Volta をアンインストール
%LOCALAPPDATA%\Volta を削除

Windows固有の注意

miseのWindowsでの推奨モードはshimsモード（windows_shim_mode = "exe"）
mise activate bashはGit Bashなら動くが、shimsの方が安定
Windows固有のバグ修正は活発に進行中だが、Linux/macOSほど枯れていない

急ぐ必要はあるか

ない。Voltaは壊れたわけではなく「新機能が出ない」だけ。Node 22で動いていてclaude-codeやcodexが使えているなら、困るまで触らなくていい。

ただし新しいツールの追加はmise側でやり始めるのが現実的。Voltaに新しいものを積み増すメリットはもうない。