Claude Code最新アップデートまとめ｜更新方法と破壊的変更対応【2026年7月】

結論：Claude Code Updateとは何か・いつ実行すべきか・自動化できるか

結論：Claude Code Updateは、AIコーディングアシスタント「Claude Code」を最新バージョンに更新するコマンドです。claude update または npm install -g @anthropic-ai/claude-code@latest の2系統で実行でき、2026年6月現在の最新版はv2.1.161です。

この記事の要点：

• 要点1：週1〜2本ペースでアップデートがリリースされ、破壊的変更はメジャー・マイナーのたびに混入するため「来たら即更新」では通用しない
• 要点2：Homebrew／npm／バイナリの3系統でコマンドが異なり、特にnpmはスペース入りパスワード問題を含む落とし穴がある
• 要点3：チーム・CI/CD・Bedrock経由など7パターンの運用を状況に合わせて使い分けることで、更新起因の障害をゼロに抑えられる

対象読者：Claude Codeを個人〜チームで活用中の開発者・IT担当者・企業のClaude Code管理者

読了後にできること：今日中に自分の環境に合ったアップデート戦略を選んでスクリプトを設置できる

「アップデートしたら突然 /workflow が効かなくなった……」

先日、Claude Codeを社内の開発チームに展開している顧問先から、こんな相談が来ました。詳しく聞くと、v2.1.160でコマンドが /workflow から /ultracode に名称変更されたのに、誰も知らないまま全員がそのまま使い続けていた、というケースでした。ツールの問題ではなく、アップデート管理の問題です。

Claude Codeは2026年6月時点でv2.1.161（参照日：2026-06-03）まで到達しており、300を超えるリリースが積み上がっています。週に1〜2本のペースでアップデートが降ってくる中で、「気が向いたら更新する」運用では、チームの環境がバラバラになり、破壊的変更を踏む確率が跳ね上がります。

この記事では、Claude Code Updateのコマンド完全解説から、個人開発・小規模チーム・大規模組織・Bedrock経由・CI/CD連動まで7パターンの実践的な運用方法を、コピペ可能なスクリプト5本つきで全公開します。破壊的変更の対応チェックリストと失敗パターンも併せて解説しますので、今日から使える形で持ち帰ってください。

Claude Code Updateコマンド完全解説

まず基礎から確認します。インストール方法によって使うコマンドが変わるため、自分の環境を先に特定してください。

現在のバージョンを確認する

# バージョン確認（全環境共通）
claude --version

# 健全性チェック（環境診断込み）
claude doctor

claude doctor を実行すると、CLIのバージョン・認証状態・モデル接続などをまとめてチェックできます。「なんか挙動が変だな」と感じたときはまずこれを実行するのがルーティンになっています。

アップデートコマンド（インストール方法別）

2026年1月以降、npmインストールは公式に非推奨（deprecated）となりました。Anthropicのネイティブインストーラー（Homebrew・バイナリ）が推奨されています。ただし、npmでも引き続き動作します。

claude update コマンドは全インストール方式で共通して使える便利コマンドです。設定した「リリースチャンネル」を尊重して更新するため、後述するstableチャンネル設定と組み合わせると非常に強力です。

特定バージョンへのpinとロールバック

# 特定バージョンをインストール（ロールバック用）
npm install -g @anthropic-ai/claude-code@2.1.158

# バージョン確認
claude --version

# 最新に戻す
npm install -g @anthropic-ai/claude-code@latest

Homebrewの場合は次のコマンドでロールバックできます。

# Homebrewで特定バージョンに固定（例：2.1.158）
brew install anthropic/claude/claude@2.1.158

# バージョンを固定（自動更新を止める）
brew pin claude

ここで重要なのは、ロールバック設計を事前に決めておくことです。実際に問題が起きてから「どのバージョンに戻せばいいか」を考えていると、本番環境で長時間のダウンタイムを招きます。後述のチェックリストで詳しく説明します。

Stableリリースチャンネルへの切り替え

毎週来るアップデートを全部追いかけるのが辛い場合は、stableチャンネルに切り替えると、主要なリグレッションを除外したバージョン（最新から約1週間遅れ）が届きます。

# settings.jsonでstableチャンネルを設定
# ~/.claude/settings.json
{
  "releaseChannel": "stable"
}

この設定を入れた上で claude update を実行すると、stableチャンネルの最新版が入ります。最速で新機能を使いたい個人開発者は latest（デフォルト）、チームや業務利用では stable を基本方針にするのが現時点のおすすめです（出典：Claude Code Changelog, code.claude.com, 参照日：2026-06-03）。

自動更新の仕組みと公式設定で更新を正確にコントロールする

「最新版にしたい」「自動更新を止めたい」「業務環境で古いバージョンに落ちてほしくない」——アップデートまわりの要望は、Anthropic公式の設定キーを正しく使えば全部コントロールできます。ここでは公式ドキュメント（code.claude.com/docs/en/setup、参照日：2026-06-29）で実在を確認した設定だけに絞って整理します。

インストール方式ごとの自動更新の挙動

まず押さえるべきは、「自動更新するかどうかはインストール方式で決まる」という事実です。公式ドキュメントは次のように区別しています。

ネイティブインストーラーで入れた場合、Claude Codeは起動時と稼働中に定期的に更新をチェックし、ダウンロード・インストールはバックグラウンドで行われ、次回起動時に反映されます。直近の更新が成功したかどうかは claude doctor で確認できます（v2.1.162以降、claude doctor は最後の更新試行の結果を表示するようになりました。出典：Claude Code Changelog v2.1.162, code.claude.com, 参照日：2026-06-29）。

HomebrewやWinGetでも、Claude Codeにアップグレードコマンドを自動で実行させたい場合は CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE を 1 に設定します。新バージョンが出たときにバックグラウンドでアップグレードを走らせ、成功すると再起動を促すプロンプトが表示されます。

リリースチャンネルは autoUpdatesChannel で設定する

毎週来る更新を全部追うか、安定版で運用するかは autoUpdatesChannel 設定で制御します。これが自動更新と claude update の両方が従うチャンネル設定です。

# ~/.claude/settings.json
{
  "autoUpdatesChannel": "stable"
}

• "latest"（デフォルト）：リリースされ次第すぐに新機能を受け取る
• "stable"：主要なリグレッションを除外した、おおよそ1週間遅れのバージョンを使う

/config →「Auto-update channel」からGUIで切り替えることもできます。企業導入では管理者がmanaged settingsで組織全体に同じチャンネルを強制できます。

Homebrewだけは例外で、設定キーではなくcask名でチャンネルが決まります。claude-code がstable、claude-code@latest がlatestです。

なお、本記事の前半では旧来の表記として releaseChannel を紹介していますが、2026年6月時点の公式ドキュメントが採用しているキー名は autoUpdatesChannel です。これから設定する場合は autoUpdatesChannel を使ってください。

minimumVersionで「これより下に落とさない」床を作る

業務環境で困るのが、「stableに切り替えたら検証済みより古いバージョンに落ちてしまう」ケースです。これを防ぐのが minimumVersion です。バックグラウンドの自動更新と claude update は、この値より下のバージョンをインストールしなくなります。

# ~/.claude/settings.json
{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

managed settingsに書けば、ユーザー設定・プロジェクト設定で上書きできない組織全体の最低バージョンを強制できます。

ただし minimumVersion はあくまで「更新の下限」を縛るだけです。指定したバージョン範囲の外ではClaude Code自体を起動させたくない場合は、managed settingsの requiredMinimumVersion と requiredMaximumVersion を使います。更新は requiredMaximumVersion の上限も尊重します（出典：Claude Code Docs – Advanced setup, code.claude.com, 参照日：2026-06-29）。

自動更新を完全に止める2段階の方法

自動更新を止めたい場合、目的に応じて2つのキーを使い分けます。これも公式に定義された環境変数です。

# ~/.claude/settings.json — バックグラウンドの自動チェックだけ止める
{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

DISABLE_AUTOUPDATER はバックグラウンドの自動チェックだけを止めます。claude update や claude install による手動更新は引き続き動きます。手動も含めてすべての更新経路をブロックしたい場合は、代わりに DISABLE_UPDATES を設定します。自社の配布チャンネルでClaude Codeを配り、ユーザーを指定バージョンに固定したいときに使う、と公式は説明しています。

アップデートできない・失敗したときのトラブルシューティング

「claude update しても上がらない」「自動更新が走らない」「更新したら command not found になった」——アップデート起因のトラブルは、原因が数パターンに収束します。公式トラブルシュート（code.claude.com/docs/en/troubleshoot-install、参照日：2026-06-29）で確認した順に切り分けます。

ステップ1：まず claude doctor で更新結果を見る

# 最後の更新試行の結果・環境診断をまとめて確認
claude doctor

v2.1.162以降、claude doctor は最後の更新試行の結果を表示します。さらにv2.1.161で自動アップデータが改善され、一時的なネットワーク障害をリトライし、失敗時には具体的なエラーカテゴリとOSエラーコードを返すようになりました（出典：Claude Code Changelog v2.1.161/v2.1.162, code.claude.com, 参照日：2026-06-29）。「なぜ上がらないのか」をまず claude doctor に語らせるのが最短ルートです。

ステップ2：npmグローバルの書き込み権限を疑う

npmでグローバルインストールしている場合、npmのグローバルディレクトリに書き込み権限がないと自動更新できません。このときClaude Codeは起動時に一度だけ通知を出し、claude doctor が利用可能な対処法を列挙します（v2.1.153以降）。

npm特有の権限エラーにハマっているなら、公式が推奨する最もクリーンな解決策は、ネイティブインストーラーへの乗り換えです。

# npm版から公式ネイティブインストーラーへ移行（macOS/Linux/WSL）
curl -fsSL https://claude.ai/install.sh | bash

sudo npm install -g は権限問題とセキュリティリスクを招くため使わないこと、と公式ドキュメントは明確に警告しています。

ステップ3：二重インストールを潰す

「更新したはずなのに古いバージョンが動く」ときの典型原因が、Claude Codeの多重インストールです。PATH上に複数の claude があると、意図しない方が呼ばれます。

# PATH上の全 claude を列挙（macOS/Linux）
which -a claude

# 3つの設置場所を個別に確認
ls -la ~/.local/bin/claude      # ネイティブインストーラー
ls -la ~/.claude/local/         # 古いローカルnpmインストール（レガシー）
npm -g ls @anthropic-ai/claude-code 2>/dev/null  # npmグローバル

複数見つかったら1つだけ残します。公式が推奨するのはネイティブインストール（~/.local/bin/claude）です。余分なものは次のように削除します。

# npmグローバル版を削除
npm uninstall -g @anthropic-ai/claude-code

# レガシーなローカルnpmインストールを削除
rm -rf ~/.claude/local

Windowsでは where.exe claude で複数の claude を確認できます。古いClaude Desktopが WindowsApps に Claude.exe を登録し、CLIより優先されてしまうケースもあるため、その場合はClaude Desktopを最新版に更新します。

ステップ4：更新後に command not found になったらPATHを確認

インストールは成功したのに claude が見つからない場合、インストール先がPATHに入っていません。ネイティブインストーラーは ~/.local/bin/claude（Windowsは %USERPROFILE%.localbinclaude.exe）に配置します。

# インストール先がPATHに含まれるか確認（macOS/Linux）
echo $PATH | tr ':' 'n' | grep -Fx "$HOME/.local/bin"

# 含まれていなければ追加（zshの例）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 反映確認
claude --version

ステップ5：WinGetの「実行中ロック」とパッケージマネージャの既知の挙動

WinGetでは、Claude Code稼働中はWindowsが実行ファイルをロックするためアップグレードが失敗することがあります。このときClaude Codeは手動コマンドを案内します。Claude Codeを終了してから winget upgrade Anthropic.ClaudeCode を再実行してください。

また公式が「既知の問題」として明記しているとおり、パッケージマネージャ側にバージョンが反映される前にClaude Codeが更新通知を出すことがあります。アップグレードが失敗したら、少し待ってから再試行するのが正解です（出典：Claude Code Docs – Advanced setup, code.claude.com, 参照日：2026-06-29）。Homebrewは古いバージョンをディスクに残すため、brew cleanup を定期実行すると容量を回収できます。

Claude Codeアップデートの7パターン運用

環境・チーム規模・セキュリティ要件によって最適な運用は変わります。7パターンを状況別に解説します。

Claude Codeの全体像や基本的な活用方法については、AIエージェント導入完全ガイドでも体系的にまとめています。アップデート運用と合わせて参照してください。

パターン1：個人開発（最速・最新追いかけ型）

推奨設定：releaseChannel = latest / 手動 or 自動更新

# ~/.claude/settings.json
{
  "releaseChannel": "latest",
  "env": {
    "CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE": "1"
  }
}

個人開発で新機能をいち早く試したい場合はこの設定で。CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 を設定すると、Claude Codeセッション起動時に自動チェック・更新が走ります（Homebrew・npm・WinGet共通対応、v2.1.129以降、参照日：2026-06-03）。

ただし、自動更新は「壊れたら自分で直す覚悟がある人向け」です。本番に近い作業をしているなら次のパターン2以降を検討してください。

パターン2：小規模チーム（週次更新・Slack通知型）

推奨設定：releaseChannel = stable / 週次手動更新 / 更新前後にSlack通知

#!/bin/bash
# update-claude-code.sh — 小規模チーム向け週次更新スクリプト
# cronで毎週月曜朝9時に実行: 0 9 * * 1 /path/to/update-claude-code.sh

BEFORE=$(claude --version 2>/dev/null | grep -oE '[0-9]+.[0-9]+.[0-9]+')
npm install -g @anthropic-ai/claude-code@latest 2>&1
AFTER=$(claude --version 2>/dev/null | grep -oE '[0-9]+.[0-9]+.[0-9]+')

if [ "$BEFORE" != "$AFTER" ]; then
  # Slack通知
  curl -s -X POST "$SLACK_WEBHOOK_URL" 
    -H "Content-Type: application/json" 
    -d "{"text":"Claude Code更新: v${BEFORE} → v${AFTER}nCHANGELOG: https://code.claude.com/docs/en/changelog"}"
fi

このスクリプトをチームの共有マシンまたはCI環境で週1回走らせ、バージョン変更があればSlackに通知する構成です。5人以下の小規模チームで、「更新があった事実と変更先バージョンをメンバー全員が把握できる状態を作る」のが目的です。

パターン3：大規模組織（バージョン固定・段階ロールアウト型）

推奨設定：特定バージョンをpinして全員に配布 / 検証済みバージョンのみ全社展開

#!/bin/bash
# pin-claude-code.sh — 全社統一バージョン配布スクリプト
# 管理者がテスト後に APPROVED_VERSION を更新してチームに配布

APPROVED_VERSION="2.1.158"  # 社内テスト済みバージョン

current=$(claude --version 2>/dev/null | grep -oE '[0-9]+.[0-9]+.[0-9]+')
if [ "$current" = "$APPROVED_VERSION" ]; then
  echo "Already on approved version $APPROVED_VERSION"
  exit 0
fi

echo "Installing Claude Code v$APPROVED_VERSION..."
npm install -g @anthropic-ai/claude-code@$APPROVED_VERSION

# バージョン固定（自動更新を防ぐ）
cat > ~/.claude/settings.json << EOF
{
  "releaseChannel": "stable",
  "env": {
    "CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE": "0"
  }
}
EOF

echo "Claude Code pinned to v$APPROVED_VERSION"

大規模組織では「最新 = 最良」ではなく、「検証済み = 安全」が優先されます。リリースサイクルが速いClaude Codeでは、1本のリリースで複数の破壊的変更が入る場合もあります。IT部門が1〜2週間かけて検証し、承認済みバージョンを全社配布する形が堅いです。

パターン4：セキュリティ要件が高い環境（エアギャップ・監査ログ型）

推奨設定：自動更新OFF / 変更管理プロセス必須 / OTEL監査ログ

# ~/.claude/settings.json（セキュリティ強化版）
{
  "releaseChannel": "stable",
  "env": {
    "CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE": "0",
    "OTEL_RESOURCE_ATTRIBUTES": "deployment.environment=production,team=engineering",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "https://your-otel-collector:4318"
  }
}

v2.1.161でMCPシークレットの意図しない露出が修正されています（${VAR} 参照が展開されなくなり、クレデンシャルが自動伏せ字になった）。セキュリティ要件が高い環境では、このような修正が含まれるリリースを確認してから適用するプロセスが重要です（出典：Claude Code Changelog v2.1.161, code.claude.com, 参照日：2026-06-03）。

OpenTelemetry経由で監査ログを自社コレクターに流すことで、プロンプト・ツール呼び出し・ドキュメント参照をセキュリティチームが一元管理できます。

パターン5：モノレポ・複数プロジェクト（プロジェクト別バージョン分離型）

推奨設定：プロジェクトごとの .claude/settings.json + バージョンpin

#!/bin/bash
# check-version-drift.sh — モノレポのバージョン分散チェック
# 各プロジェクトのsettings.jsonを読んでバージョン不一致を警告

PROJECTS=("frontend" "backend" "infra" "data-pipeline")

echo "=== Claude Code バージョン棚卸し $(date +%Y-%m-%d) ==="
for proj in "${PROJECTS[@]}"; do
  if [ -f "./${proj}/.claude/settings.json" ]; then
    pinned=$(python3 -c "import json; d=json.load(open('./${proj}/.claude/settings.json')); print(d.get('pinnedVersion','未設定'))")
    echo "  ${proj}: ${pinned}"
  else
    echo "  ${proj}: settings.json なし (latest自動追従)"
  fi
done

モノレポで複数プロジェクトが共存する場合、「Aプロジェクトはv2.1.155でOK、Bプロジェクトはv2.1.160の破壊的変更を踏んでいる」という状態が生まれやすいです。定期的にこのスクリプトで棚卸しをすることで、バージョン分散を早期に検知できます。

パターン6：CI/CD連動（プルリク前自動テスト型）

推奨設定：PR作成時にClaude Codeの動作テストを自動実行 / バージョン変更をCIで検知

# .github/workflows/claude-code-version-check.yml
name: Claude Code Version Check

on:
  pull_request:
    paths:
      - '.claude/**'
      - '.npmrc'
      - 'package.json'

jobs:
  version-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install pinned Claude Code version
        run: npm install -g @anthropic-ai/claude-code@${{ vars.APPROVED_CLAUDE_CODE_VERSION }}
      - name: Verify version
        run: |
          ACTUAL=$(claude --version | grep -oE '[0-9]+.[0-9]+.[0-9]+')
          EXPECTED="${{ vars.APPROVED_CLAUDE_CODE_VERSION }}"
          if [ "$ACTUAL" != "$EXPECTED" ]; then
            echo "Version mismatch: expected $EXPECTED, got $ACTUAL"
            exit 1
          fi
      - name: Smoke test
        run: claude --version && claude doctor
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

CI/CDパイプラインにClaude Codeのバージョン検証を組み込むことで、「誰かが settings.json を変更してバージョンがずれた」状態をプルリク段階で検知できます。

パターン7：Amazon Bedrock経由（企業版・モデル固定型）

推奨設定：CLAUDE_CODE_USE_BEDROCK=1 でBedrock接続 / Anthropic直接APIを使わない

# ~/.claude/settings.json（Bedrock接続版）
{
  "releaseChannel": "stable",
  "env": {
    "CLAUDE_CODE_USE_BEDROCK": "1",
    "ANTHROPIC_MODEL": "us.anthropic.claude-opus-4-8-20260601-v1:0",
    "AWS_REGION": "us-east-1"
  }
}

Amazon BedrockではモデルのバージョンがAPIモデルIDで固定できるため、Anthropic APIを直接使うより「使っているモデルバージョンが変わった」という問題が起きにくいです。2026年6月時点でClaude Opus 4.8がBedrock上で利用可能です（出典：AWS, 参照日：2026-06-03）。

ただし、CLIツール自体（Claude Code本体）のバージョン管理は必要で、Bedrock接続でもパターン3・4の考え方は適用されます。

5ステップ実装フロー（即日導入版）

1. 現状確認：claude --version と claude doctor で現在のバージョン・健全性を確認する
2. パターン選択：個人／小規模チーム／大規模組織の3軸で上記7パターンから自分の環境に合うものを選ぶ
3. settings.json設定：releaseChannel・自動更新フラグ・環境変数を決めて ~/.claude/settings.json に書く
4. スクリプト設置：本記事のコピペ可能スクリプト（週次更新・Slack通知・棚卸し等）を環境に合わせて配置・cronに登録する
5. ロールバック計画を文書化：「問題が起きたらどのバージョンにどのコマンドで戻すか」をチームドキュメントに一行追記して完了

コピペ可能スクリプト5選

スクリプト1：バージョンpin + settings.json生成

#!/bin/bash
# setup-claude-code-pin.sh
# 使い方: bash setup-claude-code-pin.sh 2.1.158

VERSION="${1:-2.1.161}"

echo "Installing Claude Code v${VERSION}..."
npm install -g @anthropic-ai/claude-code@${VERSION}

mkdir -p ~/.claude
cat > ~/.claude/settings.json << EOF
{
  "releaseChannel": "stable",
  "env": {
    "CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE": "0"
  }
}
EOF

echo "Done. Version pinned to ${VERSION}"
claude --version

スクリプト2：週次更新 + Slack通知

#!/bin/bash
# weekly-update.sh
# cron: 0 9 * * 1 SLACK_WEBHOOK_URL=https://... /path/to/weekly-update.sh

BEFORE=$(claude --version 2>/dev/null | grep -oE '[0-9]+.[0-9]+.[0-9]+')
npm install -g @anthropic-ai/claude-code@latest --quiet

AFTER=$(claude --version 2>/dev/null | grep -oE '[0-9]+.[0-9]+.[0-9]+')

if [ "$BEFORE" != "$AFTER" ]; then
  MSG="Claude Code updated: v${BEFORE} -> v${AFTER}nnCHANGELOG: https://code.claude.com/docs/en/changelognn:warning: 破壊的変更がないか確認してください"
  curl -s -X POST "$SLACK_WEBHOOK_URL" 
    -H "Content-Type: application/json" 
    -d "{"text":"${MSG}"}"
  echo "Updated and notified: v${BEFORE} -> v${AFTER}"
else
  echo "Already latest: v${AFTER}"
fi

スクリプト3：CIブランチ前スモークテスト

#!/bin/bash
# pre-commit-claude-check.sh
# .git/hooks/pre-commit に配置して使う

set -e

echo "Claude Code version check..."
claude --version || { echo "Claude Code not installed"; exit 1; }
claude doctor || { echo "Claude Code health check failed"; exit 1; }

# settings.jsonが存在するか確認
if [ ! -f ~/.claude/settings.json ]; then
  echo "WARNING: ~/.claude/settings.json が見つかりません。バージョン管理されていない可能性があります"
fi

echo "Claude Code check passed"

スクリプト4：ロールバック実行スクリプト

#!/bin/bash
# rollback-claude-code.sh
# 使い方: bash rollback-claude-code.sh 2.1.155

TARGET_VERSION="${1}"

if [ -z "$TARGET_VERSION" ]; then
  echo "Usage: $0 "
  echo "Example: $0 2.1.155"
  echo ""
  echo "Available versions: https://github.com/anthropics/claude-code/releases"
  exit 1
fi

CURRENT=$(claude --version 2>/dev/null | grep -oE '[0-9]+.[0-9]+.[0-9]+')
echo "Current: v${CURRENT} -> Target: v${TARGET_VERSION}"

npm install -g @anthropic-ai/claude-code@${TARGET_VERSION}

RESULT=$(claude --version 2>/dev/null | grep -oE '[0-9]+.[0-9]+.[0-9]+')
if [ "$RESULT" = "$TARGET_VERSION" ]; then
  echo "Rollback successful: v${RESULT}"
else
  echo "ERROR: Rollback may have failed. Got v${RESULT}, expected v${TARGET_VERSION}"
  exit 1
fi

スクリプト5：全プロジェクト棚卸しレポート

#!/bin/bash
# audit-versions.sh — チームのClaude Code利用状況を棚卸しする

echo "=== Claude Code Version Audit ==="
echo "Date: $(date '+%Y-%m-%d %H:%M')"
echo "==================================="

# 現在の環境
echo "【このマシン】"
claude --version 2>/dev/null || echo "Claude Code not installed"
echo ""

# プロジェクトディレクトリを走査
echo "【プロジェクト別settings.json】"
find . -name "settings.json" -path "*/.claude/*" 2>/dev/null | while read f; do
  proj=$(echo "$f" | sed 's|/.claude/settings.json||' | sed 's|^./||')
  channel=$(python3 -c "import json; d=json.load(open('${f}')); print('channel:', d.get('releaseChannel','未設定'))" 2>/dev/null || echo "parse error")
  echo "  ${proj}: ${channel}"
done

echo ""
echo "【最新リリース確認】"
echo "Changelog: https://code.claude.com/docs/en/changelog"
echo "GitHub Releases: https://github.com/anthropics/claude-code/releases"

破壊的変更対応チェックリスト（メジャー→マイナー更新時必須）

2026年に入ってから実際に起きた破壊的変更を軸に、アップデート前後に確認すべき項目をまとめました。

アップデート前の確認

• □ 公式Changelog（code.claude.com/docs/en/changelog）で変更内容を確認した
• □ Breaking Changes セクションに自分たちの使い方に影響する変更がないか確認した
• □ カスタムコマンド（/hogehoge）の名称が変更されていないか確認した（例：v2.1.160で /workflow→/ultracode）
• □ settings.json のキー名が変更されていないか確認した（例：v2.1.133で worktree.baseRef デフォルト変更）
• □ ロールバック用バージョンとコマンドをメモした（「何かあったら npm install -g @anthropic-ai/claude-code@X.X.X」）
• □ 業務利用の本番環境では更新を月曜朝など業務時間内に行う（週末・深夜は避ける）

アップデート後の確認

• □ claude --version で意図したバージョンになっているか確認した
• □ claude doctor で健全性チェックがPASSしているか確認した
• □ よく使うカスタムコマンド・エイリアスが動くか実際に試した
• □ .claude/settings.json のキー・バリューが引き続き正しく読まれているか確認した
• □ MCP接続・プラグインが正常動作しているか確認した（v2.1.143以降、プラグイン依存関係の強制チェックが入っているため）

2026年実際に起きた主な破壊的変更（要注意事項）

出典：Claude Code Changelog, code.claude.com, 参照日：2026-06-03

よくある失敗パターンと回避策

100社以上のAI研修・導入支援の現場で実際に見てきた失敗を、再現性の高いもの4パターンに絞って解説します。

失敗1：本番環境で直接アップデートして動作が壊れた

❌ よくある間違い：金曜夕方に「ちょっと更新しとこう」と本番環境の共有マシンで npm install -g @anthropic-ai/claude-code@latest を実行。月曜朝に「コマンドが動かない」と全員がハマる。

⭕ 正しいアプローチ：本番更新は必ず業務時間中・平日に行う。更新前にロールバック先バージョンをメモ。チームへの事前告知をSlackに投稿してから実行する。

なぜ重要か：Claude Codeは週に1〜2本リリースが来るため、「来たら即更新」を本番でやると、月曜朝のトラブルが週次で発生するようになります。

失敗2：settings.jsonの設定がアップデートで上書きされた

❌ よくある間違い：~/.claude/settings.json にこだわりの設定をたくさん書いていたが、更新後に設定が消えていた、あるいはキー名が変わって効かなくなっていた。

⭕ 正しいアプローチ：settings.json はGitで管理するか、チームのドキュメントに最新版をコピーしておく。更新後は必ず claude doctor で動作確認する。

Claudeの公式ドキュメントによると、~/.claude/ 配下の設定・認証・カスタムコマンドはバージョン変更をまたいで保持されるとされています（出典：Claude Code Docs, code.claude.com, 参照日：2026-06-03）。ただし、キー名の変更（v2.1.133の worktree.baseRef 等）は自動移行されないため、CHANGELOGの確認は必要です。

失敗3：チームメンバーのバージョンが分散してデバッグが困難に

❌ よくある間違い：「各自で好きなバージョンを使って」と運用放置。Aさんはv2.1.155、Bさんはv2.1.160、サーバーはv2.1.150。「自分の環境では動いたのに」状態が頻発。

⭕ 正しいアプローチ：チームで使うバージョンを settings.json のpinnedVersionで統一。スクリプト5（棚卸しレポート）を月1回実行して分散を早期発見する。

失敗4：ロールバック設計がなく障害時に長時間ダウン

❌ よくある間違い：「問題が起きてから考えよう」でロールバック手順を用意していなかった。問題発生後にどのバージョンに戻せばいいかわからず、調査に数時間かけた。

⭕ 正しいアプローチ：更新前に必ず現バージョンをメモし、スクリプト4（ロールバック実行スクリプト）を手元においておく。「問題が起きたらこのコマンドを実行」という1行を、チームのRunbookに先に書いておく。

公式リリースノートの購読方法

破壊的変更を事前に把握する一番の近道は、公式情報を直接購読することです。3つのチャンネルを使い分けています。

1. 公式Changelog（最も正確）

URLをブックマーク：https://code.claude.com/docs/en/changelog

各バージョンのリリースノートが掲載されています。Breaking Changesセクションが最重要で、ここを週1回チェックするだけでも大半の問題を事前回避できます（参照日：2026-06-03）。

2. GitHub Releases（エンジニア向け詳細情報）

URL：https://github.com/anthropics/claude-code/releases

GitHubアカウントがあれば「Watch → Releases only」でメール通知を受け取れます。リポジトリの星（スター）数は2026年6月時点で13万を超えており、コミュニティのリアクションも確認できます（参照日：2026-06-03）。

3. ReleaseBot（自動通知サービス）

URL：https://releasebot.io/updates/anthropic/claude-code

SlackやDiscord、メールで新リリースを自動通知するサービスです。GitHub通知が多すぎる場合の代替として使えます。

チームでの運用でおすすめなのは、「Slackの専用チャンネルを作ってGitHub ReleaseのwebhookまたはReleaseBotを設定する」構成です。これだけで、誰かが気づいた順番に情報が共有されるプル型から、全員に等しく情報が届くプッシュ型に切り替わります。

Claude Code 2026年7月の新機能まとめ

ここからは、2026年6月中旬〜7月中旬にリリースされた機能のうち、実務での使いどころが大きいものを5つ厳選して解説します。すべて公式ChangelogおよびWeekly digestで確認できる内容です（参照日：2026-07-15）。「何ができるようになったか」だけでなく「業務でどう使うか」までセットで押さえてください。

1. デスクトップ版に内蔵ブラウザが搭載（v2.1.202〜v2.1.206・2026年7月6日週）

Claude Codeのデスクトップアプリに、サイトを閲覧できる内蔵ブラウザが追加されました。ローカル開発サーバーのプレビューを操作するのと同じ感覚で、公式ドキュメントやデザインカンプ、社内Wikiなど外部サイトを開いて読み込み・クリック操作までClaudeにさせられます。ブラウザはサンドボックス化されており、セッションを跨いで閲覧状態を残すかどうかは設定で選べ、外部サイト上でのアクションは安全性分類器がレビューする仕組みです。

使いどころ：「このAPIの最新仕様を見ながら実装して」と頼めば、Claudeが公式ドキュメントを自分で開いて確認しながらコードを書けるようになります。Figma等のデザインをブラウザで開かせて、実装との差分をチェックさせる用途にも使えます。

2. /doctorが「診断だけ」から「自動修理」へ進化（v2.1.203〜v2.1.206・2026年7月7〜9日）

これまで読み取り専用のレポートだった/doctorが、問題を見つけてその場で修理提案までできるコマンドに変わりました。インストール状態のヘルスチェックに加えて、使っていないskills・MCPサーバー・pluginsをコンテキストコストと突き合わせて検出し、ローカルのCLAUDE.mdとリポジトリにコミット済みのCLAUDE.mdの重複を洗い出し、Claudeがコードベースから導出できる記述を削って軽量化する提案も行います。実行すると、まず所見を一覧表示してから確認を取り、その後に変更する2段階方式です。エイリアスは/checkup。

使いどころ：「最近コンテキストの消費が早い」「起動がもっさりする」と感じたら、まず/doctorを実行するだけで、読み込みっぱなしになっている不要skill・MCPの候補が可視化されます。研修の場でも「困ったら/doctor」だけで自己診断が回るようになりました。

3. Agent Teamsの標準化とツール単位の権限制御（v2.1.178・2026年6月15日）

環境変数CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1を設定すると、セッションごとに「暗黙のチーム」が1つ自動生成されるようになりました。従来必要だったTeamCreate／TeamDeleteによるセットアップ手順は廃止され、Agentツールのnameパラメータを指定するだけで、チームメイトを直接spawnできます。あわせてTool(param:value)構文が追加され、Agent(model:opus)のようにツールの入力パラメータ単位で許可・拒否・確認ルールを組めるようになりました（*ワイルドカード対応）。トークン消費が大きい実験的機能のため、環境変数を明示的に設定した場合のみ有効です。

使いどころ：調査役・実装役・レビュー役のように複数エージェントへ役割分担する並列作業を、事前のチーム作成コマンドなしにすぐ始められます。「Opusモデルのサブエージェントだけ禁止する」といった細かいガバナンスルールも、settings.jsonの権限ルールに1行足すだけで実現できます。

4. ネストされた.claude/skillsの自動読み込みとスキル連続起動（v2.1.178／v2.1.199・2026年6月15日・7月2日）

ネストした.claude/skillsディレクトリ内のskillは、そのディレクトリ配下のファイルを操作している時に自動で読み込まれるようになりました（名前が衝突する場合は<ディレクトリ名>:<skill名>という形式で両方とも使えます）。さらに、/skill-a /skill-b do XYZのようにスラッシュ区切りでskillを並べて呼び出すと、先頭から最大5個までのskillをまとめて読み込めるようになりました（それまでは先頭の1個しか読み込まれませんでした）。

使いどころ：モノレポでパッケージごとに専用skillを配置し、作業中のディレクトリに応じて自動的にコンテキストを絞り込む運用が組めます。「まずレビュー観点skillを読み込んでから、リファクタskillを実行する」といった複数skillの合わせ技も1回の呼び出しで指示できます。

5. スクリーンリーダーモード（v2.1.208・2026年7月14日）

claude --ax-screen-readerの実行、環境変数CLAUDE_AX_SCREEN_READER=1の設定、またはsettings.jsonに"axScreenReader": trueを追記するいずれかの方法で、スクリーンリーダー利用者向けのプレーンテキストレンダリングをオプトインできるようになりました。装飾的なグリフは非表示になり、トランスクリプトの記号は短いラベルとして読み上げられ、ネストされた表は「見出し: 値」の行として読み上げられます。権限モードをShift+Tabで切り替えた際も、音声で通知されます。

使いどころ：視覚に障害のあるエンジニアや、アクセシビリティ要件を持つ組織がClaude Codeを導入する際、追加ツールを組み合わせなくても標準機能でスクリーンリーダー対応ができるようになりました。

あわせて読みたい（Claude Code関連）

• Claude Code インストール完全ガイド｜導入から初期設定まで
• Claude Code 最新アップデート機能まとめ｜新機能の使いどころ
• Claude Code チーム導入5ステップ｜10名規模の展開フロー

まとめ：今日から始める3つのアクション

1. 今日やること：claude --version で現在のバージョンを確認し、~/.claude/settings.json に "releaseChannel": "stable" を追記する（5分でできます）

2. 今週中：本記事のスクリプト2（週次更新+Slack通知）を環境に合わせて設置し、毎週月曜朝のcronに登録する

3. 今月中：チームメンバーのバージョンをスクリプト5（棚卸しレポート）で確認し、分散があれば統一バージョンを決めてpinするプロセスを導入する

あわせて読みたい

• Claude Codeをチームに展開する5ステップ【2026年版】 — 全社導入時の承認フローと研修設計
• Claude Code Windowsインストール完全ガイド2026 — Windows環境での特有のトラブルシュート

参考・出典

• Changelog – Claude Code Docs — Anthropic（参照日: 2026-06-03）
• Releases · anthropics/claude-code — GitHub（参照日: 2026-06-03）
• Claude Opus 4.7 is now available in Amazon Bedrock — AWS（参照日: 2026-06-03）

著者

：佐藤傑（さとう・すぐる）
株式会社Uravation代表取締役。X（@SuguruKun_ai）フォロワー約10万人。
100社以上の企業向けAI研修・導入支援。著書『AIエージェント仕事術』（SBクリエイティブ）。
SoftBank IT連載7回執筆（NewsPicks最大1,125ピックス）。

ご質問・ご相談は お問い合わせフォーム からお気軽にどうぞ。