Claude Codeバージョンの確認・固定・ダウングレード手順
Claude Codeの現在バージョンの確認方法、特定バージョンへの固定、ダウングレードの手順と注意点をまとめます。3種類ある版数制御キーの違いも扱います。
今使っているバージョンを確認する
回帰(リグレッション)が疑われるとき、組織で導入するバージョンをそろえたいとき、CIの実行環境と手元の環境を一致させたいとき。いずれの場面でも、最初に必要なのは今のバージョンの正確な把握です。
claude --versionv2.1.286で実行すると、出力は次の1行でした。バージョン番号とプロダクト名が並びます。
2.1.286 (Claude Code)claude -v でも同じ出力が得られることを、同じバージョンで確認しています。claude --help のオプション一覧にも -v, --version Output the version number として載っています。
インストール形態や自動更新の状態まで見たいときは claude doctor を使います。--help の説明は次のとおりです。
Usage: claude doctor [options]
Check the health of your Claude Code installation. Reads settings files in the
current directory without a trust prompt. For a full checkup that can also fix
issues, run /doctor in a session.注目したいのは2点です。ターミナルから叩く claude doctor は、現在のディレクトリの設定ファイルを信頼確認なしで読みます。修復まで含めた診断はセッション内の /doctor が担当します。バージョン固定の検証では、前者の読み取り専用の側が使いやすい道具です。
自動更新を止めた環境では Auto-updates の行が disabled (set by env: DISABLE_AUTOUPDATER) になります。固定が効いているかを確かめる目印として使えます。
バージョン不足でエラーになる場面もあります。たとえば thinking.type.enabled is not supported for this model は、機能自体は存在するのにバージョンが足りずに弾かれる例です。モデル別の必要バージョンは「thinking.type.enabled」エラーの原因と対処法にまとめました。
症状から選ぶ:何を使えばバージョンが固定できるか
固定・ダウングレードの手段は、困りごとによって変わります。個人の一時対応なのか、組織への強制なのか、CIの再現性なのかで選ぶ道具が違います。
| 困りごと | 使う機能 | 効く範囲 |
|---|---|---|
| 回帰調査でとりあえず古いバージョンに戻したい | 使う機能claude install <バージョン> | 効く範囲その端末のみ |
| 更新は受けたいが、特定バージョンより下げたくない | 使う機能minimumVersion | 効く範囲個人設定またはmanaged settings |
| 組織で最低バージョンを強制したい | 使う機能requiredMinimumVersion | 効く範囲managed settingsのみ、起動をブロック |
| 未検証の最新版を組織から締め出したい | 使う機能requiredMaximumVersion | 効く範囲managed settingsのみ、起動をブロック |
| 自動更新そのものを止めたい | 使う機能DISABLE_AUTOUPDATER / DISABLE_UPDATES | 効く範囲環境変数を設定した端末 |
| CIの再現性を確保したい | 使う機能インストールコマンドにバージョンを明記 | 効く範囲そのCIジョブのみ |
特定バージョンをインストールする
ネイティブインストーラーは、バージョン番号かチャネル名(latest / stable)を引数に取ります。インストール時に選んだチャネルが、以後の自動更新の既定になります。stable は、約1週間遅れのバージョンで、重大な回帰のあるリリースが飛ばされるチャネルです。
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89Windows PowerShellでは次の形です。
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89すでにClaude Codeを導入済みの環境では、claude install サブコマンドで後からバージョンを指定し直せます。claude install --help の実際の出力は次のとおりです。
Usage: claude install [options] [target]
Install Claude Code native build. Use [target] to specify version (stable,
latest, or specific version)
Options:
--force Force installation even if already installed
-h, --help Display help for command引数 [target] に stable / latest / 具体的なバージョン番号を渡せます。--force は、すでにインストール済みの場合でも実行させるオプションです。claude install stable と claude install latest は、指定したチャネルを自動更新のチャネルとしても保存します。
claude install 2.1.118一方、claude update の --help は次の内容です。バージョンを指定する引数は存在しません。
Usage: claude update|upgrade [options]
Check for updates and install if available
Options:
-h, --help Display help for commandつまり「古いバージョンを狙って入れる」のは claude install、「設定のルールに従って最新化する」のは claude update です。この役割の違いが、次の節で話す minimumVersion との関係を決めます。
npm経由の場合は、パッケージのバージョン指定でそのまま切り替えます。
npm install -g @anthropic-ai/claude-code@2.1.89どの方法でも、切り替えたら claude --version で意図したバージョンになっているかを確認します。
Homebrewは事情が違います。claude-code(stableチャネル)と claude-code@latest(latestチャネル)という2つのcaskのどちらを入れるかでチャネルを選ぶ方式で、任意のバージョン番号を指定する手順はドキュメントに載っていません。Homebrew環境で厳密に固定したい場合は、ネイティブインストーラーかnpmでの導入に切り替える道があります。Homebrewは自動更新が既定で無効です。CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE を 1 にしていない限り、brew upgrade を実行しないと上がりません。旧バージョンはディスクに残るので、brew cleanup を定期的に実行して回収します。
ダウングレードの手順と、戻らないようにする設定
意図的に古いバージョンへ戻すときの流れを、判断の分かれ目つきで並べます。
ダウングレードして、その場に留める流れ
- 1
今のバージョンと設定を確認する
claude --versionで現在のバージョンを控えます。claude doctorでAuto-updatesの行と、minimumVersionが入っていないかを見ます。 - 2
claude install で戻したいバージョンを入れる
claude install <バージョン>を実行します。claude updateは設定の下限より古いバージョンを入れないので、ダウングレードの道具にはなりません。 - 3
もう一度 claude --version で確認する
意図した番号になっていなければ、PATH上に別経路のバイナリが残っていないかを疑います(つまずきの節で扱います)。
- 4
自動更新で元に戻らないように設定する
DISABLE_AUTOUPDATERを"1"にして、バックグラウンドの更新チェックを止めます(理由は次の小節で扱います)。あわせてminimumVersionを戻したバージョンにしておくと、claude updateを手で実行したときに、それより古いバージョンへ下がるのを防げます。
minimumVersionは「下限」であって「固定」ではない
minimumVersion は、バックグラウンドの自動更新と claude update が、設定した値より古いバージョンを入れないための下限です。"stable" チャネルへ切り替えても、すでに新しい "latest" のビルドに乗っていればダウングレードされません。この下限は、その安全弁として働きます。
/config でlatestからstableへ切り替えると、今のバージョンに留まるか、ダウングレードを許すかを尋ねられます。留まる方を選ぶと、minimumVersion が今のバージョンに設定されます。latestへ戻すと、この値は消えます。チャネルの選び方はautoUpdatesChannelのstableとlatestにまとめています。
{
"autoUpdatesChannel": "stable",
"minimumVersion": "2.1.89"
}ここで混同しやすい点があります。minimumVersion が拒否するのは自動更新と claude update で、claude install <バージョン> はドキュメント上その対象に入っていません。
ダウングレード後に何もしないと元に戻る
DISABLE_AUTOUPDATER を設定していない限り、チャネルの版が戻したバージョンより新しければ、次の更新チェックで引き上げられます。minimumVersion は下限なので、この引き上げは止めません。更新はバックグラウンドでダウンロードとインストールまで済み、次に起動したときに反映されます。更新チェックは起動時と実行中の定期的なタイミングで走ります。
留めておきたいバージョンがあるなら、自動更新を止める道が2つあります。違いは「手動の更新まで止まるかどうか」です。
更新を止める2つの環境変数
DISABLE_AUTOUPDATER
"1" を設定すると、バックグラウンドの自動更新が止まります。claude update と claude install は引き続き動くので、必要なときに手で上げ下げできます。
DISABLE_UPDATES
claude update と claude install を含む、すべての更新経路をブロックします。自社の配布経路でバージョンを管理し、利用者に自己更新させたくない場合の設定です。
DISABLE_AUTOUPDATER は settings.json の env キーに書けます。
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}戻したあとにバックグラウンドセッションが残るとき
claude --bg で起動したバックグラウンドセッションを使っている場合は、切り替え後に claude agents で一覧を見ておくと安心です。v2.1.286の claude --help には、claude respawn --all が「すべてのセッションを再起動して、現在のClaude Codeバージョンで動かす」コマンドとして載っています。
古いバージョンのまま動いているセッションに限って必要になる操作かどうかは、手元では確認していません。再起動はセッションに影響するため、実行前に何が動いているかを確かめてください。
組織全体でバージョンを強制する
Enterprise向けのmanaged settingsを使っているチームには、更新だけでなく起動そのものを制御するキーがあります。
3つのバージョン制御キー
minimumVersion
下限より古いバージョンへの更新を拒否します。個人設定にも、managed settingsにも書けます。managed settingsに置くと、ユーザー設定やプロジェクト設定で上書きできない組織共通の下限になります。
requiredMinimumVersion
実行中のバージョンがこの値より古いと、起動時にClaude Code自体が終了します。managed settings専用で、v2.1.163以降で使えます。
requiredMaximumVersion
この値より新しいバージョンでは起動時に終了します。さらに、自動更新と claude update もこの上限を超えるバージョンを入れません。managed settings専用で、こちらもv2.1.163以降です。
requiredMinimumVersion と requiredMaximumVersion を範囲外で起動すると終了しますが、claude update ・claude install ・claude doctor は範囲外でも動きます。利用者が自力で承認済みバージョンへ復旧できるように、という設計です。DISABLE_UPDATES と組み合わせると、この復旧経路自体が塞がれる点にも注意が要ります。
組織の運用では、「更新の下限」と「起動の可否」を分けて考えます。更新だけ縛る minimumVersion は、すでに古いバージョンに乗っている端末を止めません。起動を止めたいのか、新しい版へ自然に追随させたいのかで、キーを選びます。
CI/CDでバージョンを固定して再現性を保つ
チャネルを "latest" のまま指定なしで導入すると、ビルドのたびに異なるバージョンのClaude Codeが使われる可能性があります。テストで確認したバージョンとCIで動くバージョンがずれると、ローカルでは再現しない失敗の原因になります。
対策は、CIのセットアップスクリプトでインストールコマンドにバージョン番号を明記することです。
# CI設定でバージョンを明示する例
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.150npmでCIに組み込む場合も同様に、@anthropic-ai/claude-code@2.1.150 のようにバージョンを固定します。長時間起動したままのコンテナやセルフホストランナーでは、実行中にバックグラウンドの自動更新が走るのを避けるため、DISABLE_AUTOUPDATER もあわせて設定しておく選択肢があります。
共有ストレージにClaude Codeを置く構成には、別の注意点があります。ネイティブインストーラーは ~/.local/share/claude/versions/ から古いバージョンを自動で削除します。起動用のランチャーが指すバージョンと、同じマシンで実行中のバージョンに加えて、新しい2つのバージョンを残して、残りを消す動きです。別のマシンのセッションが、消されたバージョンを実行中だとバイナリを失います。
また、npmのグローバルインストールを npm install -g で上書きすると、以前のバイナリが削除されます。共有ストレージで複数のマシンが同じバイナリを使っている場合に影響します。こうした構成では、DISABLE_UPDATES を設定して自前のツールで新バージョンを入れる運用が案内されています。
開発者個人のマシン群まで含めて組織全体で統一したい場合は、CIの明示的なバージョン指定に加えて、requiredMinimumVersion と requiredMaximumVersion をmanaged settingsに設定します。v2.1.163以降の端末なら、検証済みの範囲から外れた時点で起動が止まります。GitHub Actionsへの具体的な組み込み方はClaude CodeをGitHub Actionsに組み込むにまとまっています。
どのバージョンへ戻すかの判断材料
ダウングレード先を決める材料は、リリース履歴です。各バージョンの変更点はClaude Code v2.1.234のリリースノートのような個別記事で確認できます。月単位でまとめたClaude Codeアップデートまとめ2026年7月も使えます。
特定の不具合を避けたいときは、不具合が入ったバージョンの1つ前まで戻すのが基本の考え方です。番号の前後関係を正確に追いたい場合は、GitHubのリリースページと公式changelogに当たります。
npmで入れている環境なら、候補のバージョン番号はレジストリから引けます。
npm view @anthropic-ai/claude-code versions公開済みのすべてのバージョン番号が一覧で返ります。ネイティブインストーラーの claude install には、一覧を出すサブコマンドが --help 上に見当たりません。そのため、戻す先の番号は、リリース履歴かこの npm view で先に調べてから指定する流れになります。
よくあるつまずき
claude --versionの表示が更新後も変わらない
更新はバックグラウンドで入り、次回起動時に反映されます。更新直後のセッションは古いバージョンのままです。Claude Codeを終了して起動し直してから確認します。
managed settingsで固定したつもりが効いていない
古いバージョンの端末が動き続けるのは、minimumVersion がすでに入っているバージョンの起動を止めない仕様のためかもしれません。起動を止めたいなら requiredMinimumVersion です。反映のタイミングや値の決め方はClaude CodeのrequiredMinimumVersionで古いバージョンの起動を止めるで扱っています。
npmで指定したバージョンに上がらない
セットアップのドキュメントは、npm版の更新に npm update -g を使わないよう案内しています。元のインストール時のsemver範囲に縛られて、最新リリースへ移らないことがあるためです。バージョンを指定するときは、@<バージョン番号> を付けた npm install -g を使います。
インストールしたのに古いバイナリが動く
過去に複数の方法(npm・ネイティブ・OSのパッケージ管理)で入れた環境では、新旧のバイナリが混在することがあります。which -a claude(Windowsは where.exe claude)でPATH上の重複を確認し、使いたい経路だけ残して他を削除します。
自作のランチャーを置いている
macOSとLinuxのネイティブインストールでは、~/.local/bin/claude が ~/.local/share/claude/versions/ へのシンボリックリンクです。このパスを自分のスクリプトやシンボリックリンクに置き換えていると、更新で新しいバージョンが versions/ に入っても、どれを実行するかはランチャー次第です。Claude Codeは、どのバージョンが必要か判断できないので、入れたバージョンをすべてディスクに残します。ランチャーをClaude Codeに任せ直すには、~/.local/bin/claude を削除して claude update を実行します。claude doctor は、ネイティブインストーラーが作っていないランチャーを検知して報告します。
まとめ
ダウングレードの要点は、claude update ではなく claude install <バージョン> で戻し、そのあと自動更新で引き上げられない設定を入れることです。端末単位なら DISABLE_AUTOUPDATER(手動の更新まで止めるなら DISABLE_UPDATES)、組織単位なら起動まで縛る requiredMinimumVersion と requiredMaximumVersion が候補になります。日常の更新運用はClaude Codeアップデートの方法に書きました。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。