文書の過去の版を表示しています。
<markdown> # volta
voltaはnodeのバージョン管理ツール。
* [Volta - The Hassle-Free JavaScript Tool Manager](https://volta.sh/)
## インストール
公式サイトにある通りにインストールする
```bash # install Volta curl https://get.volta.sh | bash
# install Node volta install node
# start using Node node ```
バージョンを指定してインストール
``` volta install node@24 ```
## アンインストール
`uninstall`というサブコマンドはあるもののnodeのアンインストールは未サポートと出る。ファイルシステムから直接消せばOK
``` $ volta list node ⚡️ Node runtimes in your toolchain:
v14.20.0 v16.16.0 v18.14.0 v18.16.0 (default)
$ cd ~/.volta/tools/image/node $ rm -rf 14.20.0 $ rm -rf 16.16.0 ```
## volta自身のアップデート
v1.1.1時点ではvolta自身をアップデートするコマンドは用意されていないが、再インストールすれば最新になる
``` curl https://get.volta.sh | bash ```
## デフォルトの変更
以下のファイルを修正する
``` ~/.volta/tools/user/platform.json ```
## 使い方
nodeプロジェクトでnode v16を使用するには以下を実行する
``` volta pin node@v16 ```
package.jsonにvoltaという項目が追加される。
```json
"volta": {
"node": "16.16.0"
}
```
voltaインストール済みで、16.16.0がインストールされてなければ、nodeを実行すると自動的に対象のバージョンがインストールされる。
プロジェクトメンバー間でのバージョン合わせや、特定ブランチのみバージョン変更といったケースに柔軟に対応できる
### インストール済みnodeを確認
``` volta list node ```
### 一時的に別のバージョンで実行する
``` $ node -v v18.16.0
$ volta run –node v12.22.5 node -v v12.22.5 ```
### npmライブラリのインストール
npm管理されているコマンド類のインストール。`npm install -g`の代替
```bash volta install @anthropic-ai/claude-code ```
インストール済みライブラリはlistサブコマンドで見れる
```bash volta list ```
npmでグローバルインストールされたコマンドは、その時点のnodeのバージョンに紐付けられているためnodeをアップデートすると使えなくなるが、`volta install`でインストールしたコマンドはvolta管理下のnodeであればどのバージョンでも呼び出し可能。
volta管理下での`npm install -g`は`volta install`と同等
### npmライブラリのアンインストール
```bash volta uninstall agent-browser ```
`volta list`でリストされる名前ではなく、install時に指定する名前空間付きの名称を指定する
## 補完を有効にする
独自の補完ファイル置き場（`~/.zsh/completion`など）を作成
``` mkdir -p ~/.zsh/completion ```
`.zshrc`でfpathに追加する
```zsh if completion; then
fpath=(~/.zsh/completion $fpath)
fi ```
補完ファイルを作成する
```sh volta completions zsh -o ~/.zsh/completion/_volta ```
シェルを再起動して有効にする </markdow n>