バージョン不一致で起動できない時
16. トラブルシューティングコマンド / 機能
requiredMinimumVersion / requiredMaximumVersion管理者設定によるバージョン範囲制限
概要
組織の管理者設定（managed settings）で requiredMinimumVersion / requiredMaximumVersion が指定されている場合、その範囲外の Claude Code バージョンでは起動がブロックされます。「バージョンが古すぎる/新しすぎる」というエラーが出た場合はこの設定が原因です。
設定例
# エラー例
# Error: Claude Code version 2.0.50 does not satisfy
# required version range >=2.1.0 <=2.1.208
# 現在のバージョンを確認
claude --version
# 許可された範囲にアップデート
claude install stable
# 特定バージョンを指定してインストール
claude install 2.1.208こんな時に使う
- 「バージョンが要件を満たさない」エラーで起動できない時
- 組織のバージョンポリシーに合わせたい時
使い方
- 1エラーメッセージに表示される許可バージョン範囲を確認
- 2claude install stable または特定バージョンで範囲内に合わせる
- 3管理者に requiredMinimumVersion/requiredMaximumVersion の設定を確認してもらう
Tips
- この設定はユーザー側では変更できない（管理者/Enterprise設定）
- forceRemoteSettingsRefresh が有効だと起動のたびに最新のポリシーを取得する
- CI環境では claude install <固定バージョン> でバージョンを揃えておくと安全