Claude Codeバージョンの確認・固定・ダウングレード手順

今使っているバージョンを確認する

回帰(リグレッション)が疑われるとき、組織で導入するバージョンをそろえたいとき、CIの実行環境と手元の環境を一致させたいとき、いずれの場面でもまず必要なのは、今のバージョンを正確に把握することです。ターミナルで次のコマンドを実行します。

claude --version

2.1.89 (Claude Code) のようにバージョン番号とプロダクト名が1行で表示されます。短縮形の claude -v でも同じ結果が得られます。インストール形態や自動更新チャネル、設定の状態まで含めて確認したい場合は claude doctor を使います。読み取り専用の診断コマンドで、セッションを開始せずに結果だけ出力します。

claude doctor

セッション内から確認したい場合は /status でも、バージョン・モデル・アカウント・接続状況を表示するSettings画面が開きます。

特定バージョンをインストールする

ネイティブインストーラーは、バージョン番号かチャネル名(latest / stable)を引数に取ります。インストール時に選んだチャネルは、そのまま以後の自動更新の既定にもなります。

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

Windows PowerShellでは次の形です。

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

すでにClaude Codeを導入済みの環境で、後からバージョンを指定し直したい場合は claude install サブコマンドが使えます。バージョン番号のほか stable ・latest も受け付け、ネイティブバイナリの再インストールに相当します。

claude install 2.1.118

npm経由でインストールしている場合は、パッケージのバージョン指定でそのまま切り替えられます。

npm install -g @anthropic-ai/claude-code@2.1.89

どの方法でも、切り替え後は claude --version で意図したバージョンになっているかを必ず確認します。ネイティブインストーラーは、渡したバージョン番号をそのまま claude --version の出力に反映します。

Homebrew経由の場合は、claude-code (安定版チャネル)と claude-code@latest (最新版チャネル)という2つのcaskを切り替えることでしかチャネルを制御できず、任意のバージョン番号を指定する手順は公式には案内されていません。Homebrew環境で特定バージョンへ厳密に固定したい場合は、ネイティブインストーラーかnpmでの導入に切り替えるのが確実です。

ダウングレードで気をつけること

回帰調査などで意図的に古いバージョンへ戻す場合、2つの落とし穴があります。

1つ目は minimumVersion の床(フロア)です。これはバックグラウンドの自動更新と claude update が、設定した値より古いバージョンをインストールしないようにする下限です。autoUpdatesChannel を "stable" に切り替えても、すでに新しい "latest" ビルドに乗っていればダウングレードされない安全弁として働きます。個人設定でこの値を古いバージョン以上に設定していると、claude update 経由のダウングレードは拒否されます。この場合は設定を緩めるか、claude install <バージョン> のように明示的なバージョン指定で再インストールする経路を使います。

2つ目は、ダウングレード後に何もしないと元に戻ってしまう点です。 autoUpdatesChannel が "latest" のままで minimumVersion も未設定だと、ダウングレードした古いバージョンより新しい版が存在する限り、次回の自動更新チェックで元のバージョンへ引き上げられます。意図的に古いバージョンへ留めたい場合は、ダウングレードとあわせて minimumVersion をそのバージョンに設定するか、DISABLE_AUTOUPDATER で自動更新自体を止める必要があります。

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.89"
}

Enterprise向けのmanaged settingsを使っているチームでは、さらに強い2つのキーがあります。requiredMinimumVersion は実行中のバージョンがこれより古いと起動時にClaude Code自体が終了する管理者専用のハードな下限で、minimumVersion (更新の下限)とは別物です。逆に上限を強制したい場合は requiredMaximumVersion を使い、これより新しいバージョンで起動しようとすると同様に終了します。どちらも claude update ・claude install ・claude doctor は範囲外でも動作を続けるため、ユーザー自身で承認済みバージョンへ復旧できます。

目的別に使う機能を選ぶ

バージョン固定・ダウングレードは目的によって使う機能が変わります。個人の一時対応か、組織全体への強制か、CIでの再現性確保かで、最適な手段は違います。

CI/CDでバージョンを固定して再現性を保つ

CIパイプラインでは、チャネルを "latest" のまま指定なしで導入すると、ビルドのたびに異なるバージョンのClaude Codeが使われる可能性があります。テストで確認したバージョンとCIで動くバージョンがずれると、ローカルでは再現しない失敗の原因になります。

対策は単純で、CIのセットアップスクリプトでインストールコマンドにバージョン番号を明記します。

# CI設定でバージョンを明示する例
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.150

npmでCIに組み込む場合も同様に、package.json の依存関係やインストールコマンドで @anthropic-ai/claude-code@2.1.150 のようにバージョンを固定します。長時間起動したままのコンテナやセルフホストランナーでは、実行中にバックグラウンドの自動更新が走って意図せずバージョンが変わる事態を避けるため、DISABLE_AUTOUPDATER もあわせて設定しておくと安全です。開発者個人のマシン群まで含めて組織全体で統一したい場合は、CIの明示的なバージョン指定に加えて requiredMinimumVersion ・requiredMaximumVersion をmanaged settingsに設定し、検証済みの範囲から外れた端末を起動時点で締め出す構成にします。GitHub Actionsへの具体的な組み込み方はClaude CodeをGitHub Actionsに組み込むにまとまっています。

どのバージョンへ戻すかの判断材料

ダウングレード先をどこにするか決める材料は、公式のリリース履歴です。各バージョンで何が変わったかはClaude Code v2.1.234のリリースノートのような個別のバージョン記事や、月単位でまとめたClaude Codeアップデートまとめ2026年7月から確認できます。特定の不具合を避けたい場合は、その不具合が入った版の1つ前まで戻すのが基本方針です。バージョン番号の前後関係を正確に追いたいときは、GitHubのリリースページと公式changelogを一次情報として当たります。

よくあるつまずき

claude --version の表示が更新後も変わらない。ネイティブインストールの自動更新は次回起動時に反映されるため、更新直後のセッションでは古い表示のままのことがあります。一度Claude Codeを終了して起動し直してから確認します。

組織のmanaged settingsで固定したつもりが効いていない。minimumVersion はユーザー設定・プロジェクト設定でも書けるキーです。個人環境の設定がmanaged settingsの値を上書きしていないか、claude doctor の設定診断で確認します。組織全体で確実に強制したい場合は requiredMinimumVersion ・requiredMaximumVersion を検討します。

npmで指定したバージョンが反映されない。npm install -g ではなく npm update -g を使うと、インストール時のsemver範囲に縛られて意図したバージョンに上がらないことがあります。バージョンを明示するときは常に @<バージョン番号> を付けた npm install -g を使います。

claude --version の結果が想定と違う。過去に複数の方法(npm・ネイティブ・OSのパッケージ管理)でインストールした環境では、新旧のバイナリが混在してPATH上のどちらが実行されているか分からなくなることがあります。which -a claude(Windowsは where.exe claude)で重複を確認し、使いたい経路のバイナリだけを残して他を削除すると解消します。

よくある質問

インストール済みの旧バージョンは自動で削除されますか

ネイティブインストールは ~/.local/share/claude/versions/ 配下に各バージョンを保持する構成のため、明示的な削除操作をしない限り旧バージョンのファイルは残ります。Homebrewも同様に旧バージョンをディスクに残すため、brew cleanup で回収します。

claude install と claude update はどう違いますか

claude update は現在の設定(チャネル・フロア)に従って最新化するコマンドです。claude install [バージョン] はバージョン番号を明示してネイティブバイナリを再インストールするコマンドで、ダウングレードを含む任意のバージョンへの切り替えに使います。

npmで公開されているバージョン一覧を確認できますか

npm view @anthropic-ai/claude-code versions を実行すると、npmレジストリに公開されている全バージョン番号が一覧表示されます。ダウングレード先の候補を洗い出す際に使えます。

ダウングレード自体は無料でできますか

はい。バージョンの切り替えに追加費用は発生しません。利用にはPro以上のサブスクリプションかConsoleアカウントが必要な点はどのバージョンでも共通です。

まとめ

バージョンの確認は claude --version または claude doctor 、切り替えは claude install <バージョン> かnpmの @<バージョン> 指定で行います。ダウングレードするときは、minimumVersion の下限設定に阻まれていないかと、切り替え後に自動更新で元に戻らないようチャネルとフロアを設定したかの2点を必ず確認してください。組織全体でバージョンを強制したい場合は、更新だけを縛る minimumVersion と、起動自体を止める requiredMinimumVersion ・requiredMaximumVersion の違いを踏まえて設計します。CIパイプラインでは、インストールコマンドにバージョン番号を明記するだけで再現性の問題の多くが解消します。日常の更新運用についてはClaude Codeアップデートの方法にまとめています。