asdfコマンド一覧

asdfバージョンマネージャーのコマンドをカテゴリ別にまとめたチートシート。プラグインの管理、バージョンの切り替え、環境設定などの操作をすばやく検索・コピーできます。

最終更新: 2026年3月25日

使い方

使い方を開く

1
コマンドを検索
検索欄にコマンド名を入力するか、カテゴリ（プラグイン管理、ツール管理など）でフィルタリングして目的のコマンドを見つけます。
2
オプションと使用例を確認
各コマンドの説明、よく使うオプション、実際の使用例を確認します。
3
コマンドをコピー
コピーボタンをクリックしてコマンドをクリップボードにコピーし、ターミナルですぐに実行できます。

asdf plugin add
プラグインを追加

よく使うオプション

<name>: プラグイン名を指定
<git-url>: カスタムリポジトリのURLを指定

使用例

asdf plugin add nodejs

Node.jsプラグインを追加

asdf plugin add python

Pythonプラグインを追加

asdf plugin add erlang https://github.com/asdf-vm/asdf-erlang.git

カスタムURLからプラグインを追加

asdf plugin list
インストール済みプラグインの一覧を表示

よく使うオプション

--urls: プラグインのリポジトリURLも表示
--refs: Gitリファレンス情報も表示

使用例

asdf plugin list

インストール済みプラグインを表示

asdf plugin list --urls

URL付きでプラグインを表示

asdf plugin list all
利用可能な全プラグインの一覧を表示

よく使うオプション

出力: プラグイン名とリポジトリURL

使用例

asdf plugin list all

利用可能な全プラグインを表示

asdf plugin remove
プラグインとそのバージョンをすべて削除

よく使うオプション

<name>: 削除するプラグイン名を指定

使用例

asdf plugin remove nodejs

Node.jsプラグインを削除

asdf plugin remove python

Pythonプラグインを削除

asdf plugin update
プラグインを最新版に更新

よく使うオプション

<name>: 更新するプラグイン名を指定
<git-ref>: 特定のGitリファレンスに更新

使用例

asdf plugin update nodejs

Node.jsプラグインを更新

asdf plugin update python

Pythonプラグインを更新

asdf plugin update --all
すべてのプラグインを最新版に更新

よく使うオプション

一括更新: インストール済みの全プラグインを更新

使用例

asdf plugin update --all

全プラグインを一括更新

asdf install
指定したバージョンをインストール

よく使うオプション

<name> <version>: プラグイン名とバージョンを指定
<name> latest: 最新の安定バージョンをインストール
引数なし: .tool-versionsファイルの全バージョンをインストール

使用例

asdf install nodejs 20.11.0

Node.js 20.11.0をインストール

asdf install nodejs latest

Node.jsの最新安定版をインストール

asdf install

.tool-versionsの全バージョンをインストール

asdf uninstall
指定したバージョンをアンインストール

よく使うオプション

<name> <version>: プラグイン名とバージョンを指定

使用例

asdf uninstall nodejs 18.0.0

Node.js 18.0.0をアンインストール

asdf uninstall python 3.9.0

Python 3.9.0をアンインストール

asdf set
ツールのバージョンを.tool-versionsに設定

よく使うオプション

<name> <versions...>: プラグイン名とバージョンを指定
-u: 親ディレクトリの.tool-versionsを更新
-p: カレントディレクトリの.tool-versionsのみを更新

使用例

asdf set nodejs 20.11.0

Node.jsのバージョンをカレントディレクトリに設定

asdf set -u nodejs 20.11.0

親ディレクトリの.tool-versionsを更新

asdf set python 3.12.0

Pythonのバージョンを設定

asdf current
現在使用中のバージョンを表示

よく使うオプション

<name>: 特定プラグインのバージョンを表示
引数なし: 全プラグインの現在のバージョンを表示

使用例

asdf current

全プラグインの現在のバージョンを表示

asdf current nodejs

Node.jsの現在のバージョンを表示

asdf list
インストール済みバージョンの一覧を表示

よく使うオプション

<name>: 特定プラグインのバージョンを表示
<name> <version>: バージョンをフィルタリング

使用例

asdf list nodejs

Node.jsのインストール済みバージョンを表示

asdf list nodejs 20

Node.js 20系のインストール済みバージョンのみ表示

asdf list all
利用可能な全バージョンの一覧を表示

よく使うオプション

<name>: プラグイン名を指定
<version>: バージョンをフィルタリング

使用例

asdf list all nodejs

Node.jsの利用可能な全バージョンを表示

asdf list all nodejs 20

Node.js 20系のバージョンのみ表示

asdf latest
最新の安定バージョンを表示

よく使うオプション

<name>: プラグイン名を指定
--all: 全パッケージの最新バージョンとインストール状況を表示

使用例

asdf latest nodejs

Node.jsの最新安定バージョンを表示

asdf latest --all

全パッケージの最新バージョンを一覧表示

asdf where
バージョンのインストールパスを表示

よく使うオプション

<name> <version>: プラグイン名とバージョンを指定
<name>: 現在のバージョンのパスを表示

使用例

asdf where nodejs 20.11.0

Node.js 20.11.0のインストールパスを表示

asdf where python

現在のPythonのインストールパスを表示

asdf which
実行ファイルのパスを表示

よく使うオプション

<command>: 実行ファイル名を指定

使用例

asdf which node

node実行ファイルのパスを表示

asdf which python

python実行ファイルのパスを表示

asdf help
プラグインとツールのドキュメントを表示

よく使うオプション

<name>: プラグイン名を指定
<version>: 特定バージョンのヘルプを表示

使用例

asdf help nodejs

Node.jsプラグインのヘルプを表示

asdf help python 3.12.0

Python 3.12.0のヘルプを表示

asdf exec
現在のバージョンのshimコマンドを実行

よく使うオプション

<command>: 実行するコマンド名
[args...]: コマンドに渡す引数

使用例

asdf exec node --version

現在のNode.jsバージョンを確認

asdf exec python -c "print('hello')"

現在のPythonでコマンドを実行

asdf env
shim実行環境でユーティリティを実行

よく使うオプション

<command>: 対象のコマンド名
[util]: 実行するユーティリティ（デフォルト: env）

使用例

asdf env node

node shimの実行環境変数を表示

asdf env python which python

Python shimの環境でwhichを実行

asdf info
asdfのシステム情報を表示（デバッグ用）

よく使うオプション

OS・シェル・asdfバージョン・プラグイン情報を出力

使用例

asdf info

asdfの環境情報を表示

asdf version
asdfのバージョンを表示

よく使うオプション

引数なし: インストールされているasdfのバージョンを表示

使用例

asdf version

asdfのバージョンを表示

asdf reshim
shimを再生成

よく使うオプション

<name> <version>: プラグイン名とバージョンを指定

使用例

asdf reshim nodejs 20.11.0

Node.js 20.11.0のshimを再生成

asdf reshim python 3.12.0

Python 3.12.0のshimを再生成

asdf shimversions
コマンドを提供するプラグインとバージョンの一覧を表示

よく使うオプション

<command>: 対象のコマンド名を指定

使用例

asdf shimversions node

nodeコマンドを提供するプラグインとバージョンを表示

asdf shimversions python

pythonコマンドを提供するプラグインとバージョンを表示

asdfコマンド一覧とは

asdfコマンド一覧は、asdfバージョンマネージャーの全コマンドをカテゴリ別にまとめた無料のチートシートです。プラグイン管理（plugin add/list/remove/update）からバージョンのインストール・切り替え（install/set）、実行環境の管理（exec/env/reshim）、ユーティリティ（info/version）まで、開発環境の構築と管理に必要な22コマンドを網羅しています。各コマンドの詳細説明、よく使うオプション一覧、実際の使用例をすぐに確認でき、ワンクリックでターミナルにコピーできます。Node.js・Python・Ruby・Go・Javaなど複数言語のバージョン管理をまとめて行えるasdfを最大限に活用するためのリファレンスです。

主な機能

22の主要asdfコマンドを収録（v0.18.x対応）
コマンドごとのオプション一覧と使用例
カテゴリ別フィルタリング（プラグイン管理、ツール管理、ユーティリティ）
リアルタイム検索機能
コマンドのワンクリックコピー

こんな場面で役立ちます

asdfの正しいコマンド構文を確認したいとき
プラグインの追加・削除方法を調べたいとき
プロジェクトごとのバージョン設定を行うとき（asdf set）
asdf初心者の学習リファレンスとして
チーム開発の環境構築手順を統一したいとき

よくある質問

asdf setはどのように使いますか？

asdf setは.tool-versionsファイルにバージョンを設定するコマンドです。例: asdf set nodejs 20.11.0 でカレントディレクトリに設定。-uオプションで親ディレクトリの.tool-versionsを更新、-pオプションでカレントディレクトリのみを更新します。旧コマンドのasdf global/local/shellはv0.15以降廃止され、asdf setに統合されました。

asdf reshimはなぜ必要ですか？

asdfはshimを使ってコマンドを正しいバージョンにルーティングします。npm install -gなどでグローバルパッケージをインストールした後、新しい実行ファイルを認識させるためにreshimが必要です。

.tool-versionsファイルとは何ですか？

.tool-versionsはプロジェクトで使用するランタイムのバージョンを定義するファイルです。このファイルをリポジトリにコミットすることで、チーム全員が同じバージョンを使用できます。asdf installコマンドでファイルに記載された全バージョンを一括インストールできます。

asdf whereとasdf whichの違いは何ですか？

asdf whereはバージョンのインストールディレクトリを返します（例: ~/.asdf/installs/nodejs/20.11.0）。asdf whichは実行ファイルの具体的なパスを返します（例: ~/.asdf/installs/nodejs/20.11.0/bin/node）。

asdfでPythonをインストールするには？

まずプラグインを追加します: asdf plugin add python。次にasdf list all pythonで利用可能なバージョンを確認し、asdf install python 3.12.0でインストール、asdf set python 3.12.0でバージョンを設定します。Node.js・Ruby等も同じ手順です。

asdfはnvmやpyenvと何が違いますか？

asdfは1つのツールでPython・Node.js・Ruby・Go・Javaなど複数のランタイムを統一インターフェースで管理できます。nvmはNode専用、pyenvはPython専用ですが、asdfなら.tool-versionsファイル1つで全言語のバージョンを共有できます。

asdf自体をアップデートするには？

v0.15以降、asdf updateコマンドは廃止されました。Homebrew（brew upgrade asdf）やAPTなどのOSパッケージマネージャーを使用してアップデートしてください。

asdfコマンド一覧

使い方

コマンドを検索

オプションと使用例を確認

コマンドをコピー

asdf plugin addプラグインを追加

よく使うオプション

使用例

asdf plugin listインストール済みプラグインの一覧を表示

よく使うオプション

使用例

asdf plugin list all利用可能な全プラグインの一覧を表示

よく使うオプション

使用例

asdf plugin removeプラグインとそのバージョンをすべて削除

よく使うオプション

使用例

asdf plugin updateプラグインを最新版に更新

よく使うオプション

使用例

asdf plugin update --allすべてのプラグインを最新版に更新

よく使うオプション

使用例

asdf install指定したバージョンをインストール

よく使うオプション

使用例

asdf uninstall指定したバージョンをアンインストール

よく使うオプション

使用例

asdf setツールのバージョンを.tool-versionsに設定

よく使うオプション

使用例

asdf current現在使用中のバージョンを表示

よく使うオプション

使用例

asdf listインストール済みバージョンの一覧を表示

よく使うオプション

使用例

asdf list all利用可能な全バージョンの一覧を表示

よく使うオプション

使用例

asdf latest最新の安定バージョンを表示

よく使うオプション

使用例

asdf whereバージョンのインストールパスを表示

よく使うオプション

使用例

asdf which実行ファイルのパスを表示

よく使うオプション

使用例

asdf helpプラグインとツールのドキュメントを表示

よく使うオプション

使用例

asdf exec現在のバージョンのshimコマンドを実行

よく使うオプション

使用例

asdf envshim実行環境でユーティリティを実行

よく使うオプション

使用例

asdf infoasdfのシステム情報を表示（デバッグ用）

よく使うオプション

使用例

asdf versionasdfのバージョンを表示

よく使うオプション

使用例

asdf reshimshimを再生成

よく使うオプション

使用例

asdf shimversionsコマンドを提供するプラグインとバージョンの一覧を表示

よく使うオプション

使用例

asdfコマンド一覧とは

主な機能

こんな場面で役立ちます

よくある質問

関連ツール

asdf plugin add
プラグインを追加

asdf plugin list
インストール済みプラグインの一覧を表示

asdf plugin list all
利用可能な全プラグインの一覧を表示

asdf plugin remove
プラグインとそのバージョンをすべて削除

asdf plugin update
プラグインを最新版に更新

asdf plugin update --all
すべてのプラグインを最新版に更新

asdf install
指定したバージョンをインストール

asdf uninstall
指定したバージョンをアンインストール

asdf set
ツールのバージョンを.tool-versionsに設定

asdf current
現在使用中のバージョンを表示

asdf list
インストール済みバージョンの一覧を表示

asdf list all
利用可能な全バージョンの一覧を表示

asdf latest
最新の安定バージョンを表示

asdf where
バージョンのインストールパスを表示

asdf which
実行ファイルのパスを表示

asdf help
プラグインとツールのドキュメントを表示

asdf exec
現在のバージョンのshimコマンドを実行

asdf env
shim実行環境でユーティリティを実行

asdf info
asdfのシステム情報を表示（デバッグ用）

asdf version
asdfのバージョンを表示

asdf reshim
shimを再生成

asdf shimversions
コマンドを提供するプラグインとバージョンの一覧を表示