Claude Codeのリリースノートの読み方と更新判断

Claude Codeの変更点をすべて確かめられる公式の記録は、GitHubのCHANGELOG.mdから生成されるchangelogです。日本語のURLを開いても中身は英語のままで、日本語で読めるのは週1回の「新機能」ダイジェストだけです。ダイジェストは目立つ機能の抜粋なので、「急に挙動が変わった」「どの版で直ったのか」を調べるときはchangelogを見ます。

2026年9月23日時点で、npmのタグはlatestが2.1.280（9月22日）、stableが2.1.267（9月9日）です。changelogには0.2.21（2025年4月2日）から2.1.280までの402件が並び、2026年だけでも9月22日までに226件、月に20〜28件のペースで増えています。1か月更新しないだけで20件以上の差が開くので、全文を上から読むより、自分の版より新しい部分だけを切り出すほうが早く済みます。

調べる順番は次のとおりです。

1. claude --versionで自分のバージョンを確認する
2. changelogから、それより新しい版の変更だけを取り出す
3. 困っている挙動のキーワードと「regression in」で、壊れた版と直った版を探す
4. 直っていれば更新し、直っていなければstableに切り替えるか、一時的に前の版へ戻す

疑問ごとに見る公式の記録

公式の記録は複数あり、それぞれ答えられる疑問が違います。

「新機能」の各週には対象バージョンが書かれています。たとえばWeek 37（2026年9月7〜11日）はv2.1.263〜v2.1.269が対象で、目玉はclaude plugin evalでした。自分の版がどの週に当たるかを見れば、日本語で大きな変化だけ先に押さえられます。ただしバグ修正や小さな改善はchangelogにしか載らないと、ページ自体に書かれています。

日付が1日ずれて見えるのは、記録ごとに時間の扱いが違うためです。changelogはタイムゾーンなしの日付だけ、GitHub ReleasesはUTCの時刻を表示します。v2.1.280の公開は2026-09-22T16:38:14Zなので、日本時間では9月23日1時38分です。

自分のバージョン以降の変更を一覧する

changelogは新しい版が上に並ぶので、ファイルの先頭から自分の版の見出しまでを切り出せば「自分の版より新しい変更」だけが残ります。curlとawkが使えるmacOS、Linux、WSLで次のように実行します。

# 1. 自分のバージョンを確認する（例: 2.1.275 (Claude Code)）
claude --version

# 2. changelogの元ファイルを保存する
curl -fsSL -o CHANGELOG.md https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md

# 3. 自分の版の見出しに達するまでを表示する
awk -v mine="2.1.275" '/^## /{ if ($2==mine) exit } {print}' CHANGELOG.md

mineにはclaude --versionの数字部分だけを入れ、(Claude Code)は付けません。2026年9月23日時点のファイルで2.1.275を指定すると、2.1.280、2.1.278、2.1.277、2.1.276の見出しと、204行の箇条書きが表示されます。

うまくいかないときは次の2点を見ます。

• curlの出力を直接awkに流さない。 curl ... | awk ...とつなぐと、awkが途中で終了した時点でcurl: (56) Failure writing outputが出ます。いったんファイルに保存してから読みます。
• ファイル全体が出てきたら、版の指定が一致していない。 awkは## 2.1.xという見出しの2語目を比べています。数字の打ち間違いや(Claude Code)の付け忘れ・付けすぎのほか、Anthropicが見出しの書式を変えた場合もこの形になります。

箇条書きはAdded、Changed、Fixed、Improved、Removedなどの動詞で始まり、VS Code拡張だけの変更には[VSCode]が付きます。「前と動きが違う」という疑問なら、仕様の変更を表すChangedとRemovedに絞ると早く見つかります。

awk -v mine="2.1.275" '/^## /{ if ($2==mine) exit } {print}' CHANGELOG.md | grep -E '^- (Changed|Removed)'

2.1.275から見ると、この中に2.1.280の「ProとTeam Standardプランの既定モデルをSonnetからOpusに変更」が含まれます。ProかTeam Standardプランで、モデルが急にOpusになったと感じた場合は、この行が理由です。

バージョン番号は連番ではありません。2.1.279はchangelogにもnpmにもGitHubのリリースにも存在せず、2.1.xの範囲だけで57個の番号に記載がありません。番号が飛んでいても、見落としではありません。

挙動が変わった版と直った版を突き止める

特定の挙動がいつ変わったかは、キーワード検索で探します。grep -n -i "wezterm" CHANGELOG.mdでも行番号は分かりますが、どの版の項目かを一緒に出すほうが読みやすくなります。

awk '/^## /{v=$2} tolower($0) ~ /wezterm/ {print v": "$0}' CHANGELOG.md

/wezterm/の部分を、困っている機能の英単語（小文字）に置き換えます。出力は2.1.269: - Fixed F1/F2/F4 not working in kitty-protocol terminals ...のように、行頭に版が付きます。

「regression in」の記載を読む

回帰（リグレッション）とは、以前の版で動いていた機能が更新で壊れることです。changelogでは、回帰を直した項目の末尾に「(regression in 2.1.x)」と壊れた版が書かれることがあり、2026年9月23日時点で24項目にこの記載があります。一覧は次のコマンドで出せます。

awk '/^## /{v=$2} /regression in/{print v": "$0}' CHANGELOG.md

行頭の版が「直った版」、かっこ内が「壊れた版」です。最近の例を読むと、次のようになります。

2.1.269で表の下2行の症状が出ていたなら、2.1.275以降に更新すれば両方とも直ります。このように、困っている症状がすでに修正済みなら、版を戻す必要はありません。

ただし、すべての回帰にこの記載があるわけではありません。2.1.258の「macOS 12で起動しない」修正のように、「a regression introduced in 2.1.255」と別の言い回しになっている項目もあるので、regressionだけで広めに探せば漏れが減ります。記載がないことは、回帰がなかった証拠にはなりません。

2026年に挙動が大きく変わった主な版

「新しいバージョンでXが変わった」と聞いたときの手がかりとして、2026年の主な変更をchangelogの記載から抜き出します。

2.1.280に更新した後、Opus 5.5で以前選んだeffortが効いていないように見えるのは、この変更のためです。/effortで選び直します。料金や移行時の確認点は「Claude Opus 5.5の料金と使い方：Opus 5からの移行で確認すること」、Fable 5.1は「Claude Fable 5.1：料金・API変更・移行ガイド」で確認できます。

版の変更ではありませんが、Week 32のダイジェストによると、Pro、Max、Teamプランでは2026年8月14日から新しいセッションの既定の権限モードがauto modeになっています。確認のダイアログが急に減ったと感じたら、これが理由の可能性があります。どこまで確認を省くかの考え方は「Claude CodeのAuto modeとbypassPermissions：確認を減らす前に決める境界」で扱っています。

latestのまま、stable、下限の設定、版戻しのどれを選ぶか

changelogで原因が分かったら、次はどの版を使い続けるかを決めます。

stableチャンネルの遅れ方

公式ドキュメントでは、stableは「通常は1週間ほど前の版を使い、大きな回帰のあるリリースを飛ばす」と説明されています。1週間は目安で、2026年9月23日時点のnpmのタグでは、stableの2.1.267（9月9日）とlatestの2.1.280（9月22日）の差は13日、公開済みのリリースで12件（2.1.268〜2.1.278と2.1.280）ありました。

この時点のstableには、2.1.269のclaude plugin eval、2.1.277のAGENTS.md対応、2.1.280のOpus 5.5はまだ入っていません。一方で、2.1.269で入った回帰も受けていません。新機能が遅れて届く代わりに、こうした回帰を避けられるのがstableです。

stableの遅れ方は一定ではありません。aptのstableリポジトリに残っている版を公開日順に見ると、2.1.236（8月19日公開）の次は2.1.267（9月9日公開）で、その間の2.1.237〜2.1.266は1つも入っていません。このため、2.1.257でmacOS 12上のClaude Codeが起動しなくなった不具合は、apt stableの利用者には届きませんでした。日付は各版の公開日で、stableに昇格した日ではありません。また、ネイティブ版のstableがaptと同じ版をたどったかどうかは公開情報からは分かりません。

今のstableとlatestがどの版かは、npmのタグと、ネイティブ版のインストーラーが参照している版の置き場所で確かめられます。

# npmのタグ
npm view @anthropic-ai/claude-code dist-tags

# ネイティブ版のインストーラーがstableとして取得する版
curl -fsSL https://downloads.claude.ai/claude-code-releases/stable

2026年9月23日時点では、claude-code-releases/stableが2.1.267、claude-code-releases/latestが2.1.280を返し、npmのタグと一致していました。ただし、このURLはインストーラーが内部で使っているもので、ドキュメントには説明がなく、予告なく変わる可能性があります。npmとネイティブ版の一致もその日に見た結果で、常に同じ版を指すという保証ではありません。

チャンネルは/configのAuto-update channelで切り替えるか、settings.jsonに書きます。

{
  "autoUpdatesChannel": "stable"
}

/configでlatestからstableに切り替えると、今の版にとどまるか、古い版へのダウングレードを許すかを聞かれます。とどまる方を選ぶとminimumVersionに今の版が入り、latestに戻すとその設定は消えます。

minimumVersionは「固定」ではなく下限

英語のドキュメントではminimumVersionをpinと呼んでいますが、働きは下限です。自動更新とclaude updateはこの値より古い版を入れなくなりますが、新しい版への更新は止めません。

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

latestで2.1.280を使っている人がstableに移っても、下限があれば2.1.267に戻されず、stableが追いつくまで今の版を使い続けられます。版を一定の範囲に収めたい組織は、管理設定のrequiredMinimumVersionとrequiredMaximumVersionを使います。範囲外では起動しなくなり、更新も上限を超えなくなります。

インストール方法ごとの更新と版の指定

同じ「更新」でも、インストール方法によって自動更新の有無とコマンドが違います。まずclaude doctorで、自分の環境と直近の更新結果を確かめてください。

npmのタグ指定、WinGetの--version、apt・dnf・apkでの版の指定は、それぞれのツールの標準の書き方です。Anthropicのドキュメントには載っておらず、下に示すWinGetとLinuxのコマンドも、WindowsやLinux上で実行した結果に基づくものではありません。

ネイティブインストール

起動時と実行中に更新を確認し、バックグラウンドでダウンロードして、次に起動したときに切り替わります。すぐ反映したいときはclaude updateを実行します。更新されるとSuccessfully updated from <old version> to version <new version>、最新ならClaude Code is up to date (<version>)と表示されます。

特定の版やstableを入れるときは、インストーラーに引数を渡します。インストール時に選んだチャンネルが、その後の自動更新の既定になります。

# macOS / Linux / WSL：stableを入れる
curl -fsSL https://claude.ai/install.sh | bash -s stable

# macOS / Linux / WSL：版を指定する
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 --versionを実行すると、2.1.89 (Claude Code)のように指定した版が表示されます。

npm

更新にはnpm install -g @anthropic-ai/claude-code@latestを使います。npm update -gは最初に入れたときのバージョン範囲に従うため、最新版まで上がらないことがあります。特定の版は、npmの通常の書き方でnpm install -g @anthropic-ai/claude-code@2.1.267と指定します。

v2.1.198以降のnpm版はNode.js 22以上を求めます。古いNode.jsではEBADENGINEの警告が出ますが、インストールは完了し、claudeも動きます。npm版も中身はネイティブ版と同じバイナリです。

Homebrew、WinGet、Linuxのパッケージマネージャー

この3種類は既定では自動更新されません。

• Homebrew：caskのclaude-codeがstable、claude-code@latestがlatestを追います。入れた方に合わせてbrew upgrade claude-codeかbrew upgrade claude-code@latestを実行します。
• WinGet：winget upgrade Anthropic.ClaudeCodeを実行します。Claude Codeの実行中はWindowsがファイルをロックするため、失敗することがあります。
• apt、dnf、apk：リポジトリにstableとlatestがあり、URLで選びます。更新はsudo apt update && sudo apt upgrade claude-code、sudo dnf upgrade claude-code、apk update && apk upgrade claude-codeです。

HomebrewとWinGetでは、環境変数CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEを1にすると、Claude Codeが更新コマンドを代わりに実行します。なお、Claude Codeが更新を知らせても、パッケージマネージャー側にまだ新しい版が届いていないことがあります。その場合は時間をおいて再実行します。

特定の版に戻せるかどうかは、パッケージマネージャーによって違います。2026年9月23日時点の状況は次のとおりです。

• Homebrew：caskはclaude-code（2.1.267）とclaude-code@latest（2.1.280）の2つだけで、任意の版を入れるcaskはありません。Homebrewのままでは特定の版に戻せないので、戻す必要があるときはネイティブ版かnpm版を使います。
• WinGet：パッケージはAnthropic.ClaudeCodeの1つで、登録元のmicrosoft/winget-pkgsには2.1.252、2.1.267、2.1.268など過去の版が残っています。登録は自動生成ツールで行われていて、この日の最新は2.1.268でした。stable（2.1.267）ともlatest（2.1.280）とも一致していません。WinGetで入る版はどちらのチャンネルとも限らないので、入れた後にclaude --versionで版を確かめてください。
• apt、dnf、apk：リポジトリに旧版が残っています。aptのstableには2.1.108から2.1.267まで54の版（2.1.267-1の形式）、latestには2.1.280までの134の版があり、dnfのstableの最新は2.1.267、apkのstableにも54の版（2.1.267-r1の形式）がありました。

# WinGet：版を指定して入れる
winget install Anthropic.ClaudeCode --version 2.1.267

# apt（Debian、Ubuntu）：版を指定して入れ、自動で上がらないよう固定する
sudo apt install claude-code=2.1.267-1
sudo apt-mark hold claude-code

# dnf（Fedora、RHEL）
sudo dnf install claude-code-2.1.267

# apk（Alpine）
apk add claude-code=2.1.267-r1

どの版がリポジトリに残るかはAnthropicやWinGetの登録状況しだいで、今後変わる可能性があります。回帰を避けることが目的なら、Homebrewのclaude-codeやstableのリポジトリを選ぶのが、公式に用意された方法です。

修正を待つ間、一時的に前の版へ戻す手順

changelogに修正がまだ載っていない回帰で作業が止まったときは、次の順番で前の版に戻します。ネイティブ版とnpm版で使える方法です。

1. 戻す版を決める。 「regression in 2.1.269」なら、その直前の2.1.268が候補です。先に、自分の版より新しい版で修正済みでないかを確かめます。

2. その版を入れる。 macOS、Linux、WSLのネイティブ版はcurl -fsSL https://claude.ai/install.sh | bash -s 2.1.268、Windowsは前の節のPowerShellのコマンドで版を2.1.268に置き換えます。すでにネイティブ版が入っていれば、CLIリファレンスにあるclaude install 2.1.268でも入れ直せます。npm版はnpm install -g @anthropic-ai/claude-code@2.1.268です。

3. 自動更新を止める。 古い版を入れた後に自動更新が再び新しい版へ進めるかどうかは、公式ドキュメントに書かれていません。ただし、GitHubのissue #91309では、2.1.257に自動更新されてmacOS 12で起動できなくなった利用者が2.1.252に戻し、DISABLE_AUTOUPDATERを設定しないと次のバックグラウンド更新が壊れた版を入れ直してしまうと報告しています。別の利用者も同じ手順を確認しています。Anthropicの説明ではなく、同じOSでの2人の報告ですが、戻した版にとどまるには、settings.jsonのenvに次の設定を加えます。

   json

   {
     "env": {
       "DISABLE_AUTOUPDATER": "1"
     }
   }

4. 反映を確かめる。 claude --versionで戻した版が表示され、claude doctorのAuto-updatesの行がdisabled (set by env: DISABLE_AUTOUPDATER)になっていれば完了です。

5. 修正が出たら元に戻す。 changelogに「(regression in 2.1.269)」付きの修正が載ったら、DISABLE_AUTOUPDATERを消してclaude updateを実行します。#91309の報告者も、2.1.258で修正された後に同じように設定を外しています。

Claude Desktopアプリに同梱されたClaude Code（macOSでは~/Library/Application Support/Claude/claude-code/<版>/）は、単体のCLIとは別の経路で入り、更新されます。issue #92401の報告では、DISABLE_AUTOUPDATERもインストーラーでの版の指定も、効くのは単体のCLIだけでした。ターミナルでclaudeを使っているのか、Desktopアプリ内のClaude Codeを使っているのかを先に確かめてください。

DISABLE_AUTOUPDATERが止めるのはバックグラウンドの確認だけで、claude updateとclaude installは引き続き使えます。手動の更新まで含めてすべて止めるDISABLE_UPDATESもありますが、これは社内で配布した版に利用者をとどめるための設定です。一時的な版戻しには、解除し忘れても手動で更新できるDISABLE_AUTOUPDATERのほうが扱いやすくなります。

変更を追い続ける方法

更新のたびに全文を読む必要はありません。目的に合わせて入口を分けておくと、見落としが減ります。

• 新しい版が出たことを知りたい：GitHub ReleasesのAtomフィードhttps://github.com/anthropics/claude-code/releases.atomをRSSリーダーに登 録します。
• 大きな変化だけ日本語で押さえたい：週1回の新機能を読みます。
• 更新直後に何が変わったかを見たい：セッション内で/release-notesを開き、今の版を選びます。
• しばらく更新していなかった：上のawkコマンドで、前の版以降の差分だけを読みます。

有志による日本語のまとめを使う場合は、そのページが扱っている最新の版の番号を公式のchangelogと見比べ、どこまでの変更が反映されているかを確かめてから読むと安心です。

よくある質問

Claude Codeのchangelogに日本語版はありますか

2026年9月23日時点では、バージョンごとのchangelogは英語だけです。/docs/ja/changelogのURLでも英語の内容が表示されます。日本語で読めるのは、週ごとに主な機能をまとめた「新機能」のページです。

2.1.279が見つからないのはなぜですか

その番号の版は公開されていないためです。2.1.279はnpmにもGitHubのリリースにもありません。Claude Codeのバージョン番号はときどき飛ぶので、changelogに載っていない番号は気にしなくて構いません。

更新しても最新版にならないのはなぜですか

考えられる原因は3つです。1つ目は、チャンネルがstableになっていて、latestより遅れた版が最新として扱われている場合です。Homebrewのclaude-codeもstableを追います。2つ目は、npm版をnpm update -gで更新している場合で、npm install -g @anthropic-ai/claude-code@latestを使います。3つ目は、パッケージマネージャーにまだ新しい版が届いていない場合で、時間をおいて再実行します。

stableに切り替えると、今より古い版になりますか

/configで切り替える場合は、今の版にとどまるかダウングレードを許すかを選べます。とどまる方を選べばminimumVersionが今の版に設定され、stableが追いつくまでその版を使います。settings.jsonを直接書き換える場合は、同じ効果を得るためにminimumVersionも一緒に指定します。