Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

マネージド設定に requiredMinimumVersion と requiredMaximumVersion を追加 — バージョンが許容範囲外の場合、Claude Code は起動を拒否し、承認済みバージョンへのアップデートをユーザーに案内します。

原文（英語） ​

Added requiredMinimumVersion and requiredMaximumVersion managed settings — Claude Code refuses to start if its version is outside the allowed range and directs the user to an approved version

概要 ​

組織の管理者がマネージド設定で requiredMinimumVersion および requiredMaximumVersion を設定できるようになりました。Claude Code のバージョンが指定範囲外の場合、起動が拒否され、ユーザーは承認済みバージョンへのアップデートを促されます。セキュリティパッチの適用漏れや、未検証バージョンの使用を組織レベルで防ぐための機能です。

基本的な使い方 ​

マネージド設定ファイル（通常は組織の MDM またはポリシー配布経由で配置）に以下を追加します：

json
{
  "requiredMinimumVersion": "2.1.100",
  "requiredMaximumVersion": "2.1.163"
}

この設定により、Claude Code はバージョン 2.1.100 以上 2.1.163 以下でのみ起動します。

実践例 ​

最低バージョンのみを指定（セキュリティパッチ強制） ​

重大なセキュリティ修正が含まれるバージョン以降の使用を義務付ける場合：

json
{
  "requiredMinimumVersion": "2.1.150"
}

バージョン 2.1.149 以下のユーザーは起動時にアップデートを促されます。

最大バージョンのみを指定（動作保証済み範囲に制限） ​

組織で検証済みのバージョンに制限する場合：

json
{
  "requiredMaximumVersion": "2.1.163"
}

両方を指定（厳密なバージョン範囲管理） ​

特定のバージョン範囲のみを許可する場合：

json
{
  "requiredMinimumVersion": "2.1.140",
  "requiredMaximumVersion": "2.1.163"
}

注意点 ​

  • この設定はマネージド設定（managed_settings.json）でのみ有効です。ユーザー設定（settings.json）からは設定できません。
  • バージョン範囲外の場合、Claude Code は起動せずにエラーメッセージを表示します。ユーザーは承認済みバージョンへの更新方法を案内されます。
  • requiredMinimumVersion と requiredMaximumVersion はどちらか一方のみでも、両方同時でも設定可能です。
  • 個人ユーザーではなく、組織の IT 管理者・セキュリティチームが使用する設定です。

関連情報 ​