11月20日、Nirmataが「How to control Claude Code auto-updates across a team」と題した記事を公開した。NirmataはKubernetes向けポリシー管理を主力とするベンダーであり、エンタープライズ環境でのツール統制・ガバナンスを専門領域としている。その知見を背景に、チーム全体でClaude Codeの自動アップデートを制御するための設定方法を体系的にまとめた内容だ。
Claude CodeはAnthropicが提供するAIコーディングエージェントで、企業のエンジニアチームへの導入が進んでいる。しかし「気づいたらバージョンが変わっていた」「共有ストレージで他のメンバーのバイナリが消えた」といった問題は、自動アップデートの挙動を把握していないと起こりうる。バージョン統制はセキュリティポリシーやCI再現性にも直結する問題であり、個人ツールとしてではなくチーム資産として管理する視点が必要だ。
まず押さえるべき:インストール方法でアップデート挙動が変わる
Claude Codeのアップデート挙動はインストール方法によって大きく異なる。これを理解しないまま設定を入れても意味がない。
| インストール方法 | 自動アップデート | 手動更新コマンド |
|---|---|---|
| ネイティブ(curl / PowerShell) | あり | claude update |
| npm(@anthropic-ai/claude-code) | あり | npm install -g @anthropic-ai/claude-code@latest |
| Homebrew | デフォルトなし | brew upgrade claude-code |
| WinGet | デフォルトなし | winget upgrade Anthropic.ClaudeCode |
| apt / dnf / apk | Claude Code経由ではなし | 各パッケージマネージャーで実施 |
自動アップデートが発生するのはネイティブインストールとnpmのみ。HomebrewとWinGetはCLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEを1に設定した場合のみClaude Codeがアップグレードを実行する。Linuxのパッケージマネージャー経由では、Claude Code自体がアップデートをトリガーすることはない。
まず全マシンのインストール方法とバージョンをインベントリとして記録することを記事は推奨している。
claude --version
claude doctor
claude doctorを実行すると、Auto-updatesの行にアップデートの有効・無効状態が表示される。
肝となる2つの環境変数
記事の核心は**DISABLE_AUTOUPDATERとDISABLE_UPDATESの使い分け**だ。
DISABLE_AUTOUPDATER:バックグラウンド更新のみ止める
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
起動時・実行中の自動チェックとバックグラウンドインストールを止める。ただしclaude updateによる手動更新は引き続き可能だ。設定後にclaude doctorを実行し、Auto-updatesの行がdisabled (set by env: DISABLE_AUTOUPDATER)になっていることで確認できる。
DISABLE_UPDATES:手動更新も含めて完全にブロック
{
"env": {
"DISABLE_UPDATES": "1"
}
}
claude updateもclaude installもすべてブロックする、より厳格な設定だ。記事が特に強調しているのが共有ホームディレクトリ(ネットワークストレージ)の場合。この環境ではDISABLE_AUTOUPDATERだけでは不十分で、ユーザーが手動でclaude updateを実行するとnpmの自動アップデートがバイナリをその場で上書きし、同じバイナリを使っている他のマシンのプロセスが壊れる可能性がある。こうした環境ではDISABLE_UPDATESを設定した上で、バージョン管理は自前のツールで行うべきとされている。
リリースチャンネルとバージョンフロア
アップデートを止めるだけでなく、どのバージョンを使うかも制御できる。
autoUpdatesChannelでstableを選ぶと、latestより遅れてバージョンが配信されるとされており(元記事に記載)、重大なリグレッションを含むリリースをスキップできる。ただし注意点がある。stableチャンネルに切り替えると、現在より古いstableバージョンへのダウングレードが発生する可能性がある。これを防ぐためにminimumVersionを併用する。
{
"autoUpdatesChannel": "stable",
"minimumVersion": "2.1.323"
}
minimumVersionはあくまで下限(フロア)であり、上限(ピン止め)ではない。特定バージョンに完全固定したい場合は、DISABLE_UPDATESを使って自前で配布する方法しかドキュメントには記載されていない。上限を設けたい場合は、マネージド設定(後述)のrequiredMaximumVersionキーを使う。
チーム全体への展開:マネージド設定が要
リポジトリに.claude/settings.jsonをコミットすれば全員に適用されると思いがちだが、記事はこれを明確に否定している。共有のsettings.jsonにあるenvの値は、各メンバーがそのフォルダを「信頼」するまで有効にならない。一部のキーはリポジトリファイルからは永遠に適用されない。
組織全体に強制するにはマネージド設定(managed settings)を使う。マネージド設定はユーザー設定・プロジェクト設定よりも優先順位が高く、minimumVersionやrequiredMaximumVersionを組織全体のポリシーとして強制できる。配置先のファイルパスはOS・デプロイ方式によって異なり、たとえばmacOSでは/Library/Application Support/ClaudeCode/managed-settings.json、Linuxでは/etc/claude-code/managed-settings.jsonが一般的な例として挙げられている(詳細は元記事および公式ドキュメントを確認のこと)。設定例は以下のようになる。
{
"minimumVersion": "2.1.323",
"requiredMaximumVersion": "2.2.0",
"autoUpdatesChannel": "stable"
}
変更後はパイロットセッションを再起動し、/statusのSetting sourcesで正しいファイルがロードされているか確認する。
ロールアウトの手順
記事が提示する推奨手順は以下の通りだ。
- 全マシンのインストール方法とバージョンをインベントリ化
- リリースチャンネルを決定。ダウングレード不可のマシンには
minimumVersionを設定 - ネイティブ・npmマシンに
DISABLE_AUTOUPDATERを設定。自前配布環境にはDISABLE_UPDATESを設定 - 必須の制御をマネージド設定に移し、パイロットセッションを再起動
claude doctorと/statusでパイロットマシンを確認後、展開対象を広げる- リリースのたびにセットアップページと環境変数ページを再確認する
この順序には意味がある。インベントリ化を先に行うのは、インストール方法によって有効な制御手段が異なるためだ。マネージド設定の適用をパイロット検証の後にするのではなく、パイロット機で先に検証してから展開する流れになっている点も、設定ミスによる組織全体への影響を最小化するうえで理にかなっている。
最後の点は実践的な注意喚起だ。キー名やデフォルト値はドキュメントが更新されることがあるため、アップデートのたびに公式セットアップページと環境変数リファレンスを再確認することを記事は推奨している。
詳細はHow to control Claude Code auto-updates across a teamを参照していただきたい。