Claude Code /release-notesコマンドで変更履歴を会話を汚さず見る
/release-notesは変更履歴をバージョンピッカーで選んで表示するコマンドです。内容は会話ではなくターミナルの表示だけに載るため、Claudeの文脈を消費しません。
/release-notesは、Claude Codeの変更履歴をインタラクティブなバージョンピッカーで選んで表示するコマンドです。表示内容はターミナルの画面だけに載ります。Claudeが読む会話の文脈には入りません。アップデート内容を知りたいときに、Claudeへ質問して文脈を消費する必要がなくなります。
/release-notesは何を表示するか
/release-notesを実行すると、バージョン番号が並んだ選択式のピッカーが開きます。1つのバージョンを選べばそのリリースノートだけが表示され、「すべて表示」を選べば全バージョン分をまとめて確認できます。
> /release-notes
# バージョン一覧のピッカーが開く
# ↑↓で選択してEnter、特定バージョンか「すべて表示」を選ぶ出力先が重要です。選んだ内容はターミナルの表示に流れるだけで、Claudeが処理する会話履歴には追加されません。ターミナルに表示されるが会話には入らない、という設計が/release-notesの核です。
会話に聞くより文脈を消費しない
「v2.1.240で何が変わった?」とClaudeに直接尋ねる方法もあります。ただしこの聞き方では、Claudeが変更履歴を調べる過程と回答の全文が会話履歴に積み上がります。長いセッションほど、この積み上がりはコンテキストウィンドウを圧迫する要因になります。
/release-notesはここを避けます。表示はターミナル側の画面描画にとどまり、Claude側の文脈は一切増えません。何十バージョン分をまとめて見返しても、次のターンでClaudeに渡すトークン量は変わらないままです。アップデート内容を頻繁に確認する運用ほど、この差が効いてきます。
制限されたネットワークでは表示されないことがある
/release-notesが取得する変更履歴データは、Anthropicや連携先サービスへのネットワークリクエストで届きます。バージョンチェックやテレメトリと同じ「非必須のバックグラウンド通信」の一種として扱われる情報です。
企業ネットワークでLLMゲートウェイ経由の通信だけを許可し、それ以外への外部通信(egress)を遮断している環境では、このリクエストが失敗します。ゲートウェイが通すのはモデルへのリクエストだけです。変更履歴のような周辺リクエストは対象外だからです。遮断された場合、選んだバージョンの内容が表示されないか、一覧そのものが取得できません。
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICは他の機能も一緒に止める
/release-notesだけを狙って通信を止める変数ではありません。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICを設定すると、自動更新チェック・テレメトリ・エラーレポートがまとめて止まります。/feedbackコマンド、Claudeが下書きするフィードバック送信、LLMゲートウェイのモデル一覧更新、fast modeの利用可否チェックも同時に止まる対象です。プラグインのcommandソースがバックグラウンドで再実行される挙動も、これに巻き込まれて止まります。
見落としやすいのが、フィーチャーフラグの取得も止まる点です。フィーチャーフラグはRemote Controlなど一部機能が動くための前提になっており、この変数を有効にした環境ではRemote Controlも使えなくなります。「/release-notesが表示されない」と気づいたときは、他にも複数の機能が同時に止まっている可能性を疑ってください。原因を1つずつ潰すより、この変数の設定有無を先に確認するほうが早く辿り着けます。
ブラウザで公式changelogページを見る方法との違い
Claude Codeの変更履歴は、ブラウザから公式ドキュメントのchangelogページでも確認できます。このページはGitHub上のCHANGELOG.mdから自動生成されたもので、/release-notesが表示するのも同じ変更履歴の内容です。情報源は共通でも、見え方は違います。ブラウザ側は最新から遡って全バージョンが縦に並ぶ一覧で、特定バージョンだけに絞り込むにはページ内検索に頼ることになります。
/release-notesはターミナルを離れずにバージョンピッカーで絞り込める点が違います。作業中のセッションから離脱せずに済むため、コーディング中に「このバージョンで何が直ったか」を確認したい場面ほど/release-notesの方が手数が少なく済みます。逆に、複数バージョンをまたいでじっくり読み比べたいときは、ブラウザ側のページ内検索やブックマークの方が向く場合もあります。
各バージョンの記載形式は共通です。バージョン番号と公開日が見出しになり、その下に新機能は「Added」、修正は「Fixed」、仕様変更は「Changed」といった種類ごとの箇条書きが並びます。たとえばv2.1.258のFixed項目は2件だけです。macOS 12(Monterey)での起動失敗の修正と、権限承認の再送後にリモート・スケジュール済みセッションが失敗する不具合の修正です。一方、1つ前のv2.1.257は規模が違います。新モデル追加を含むAdded項目が8件、Fixed項目が63件、ChangedとImprovedを合わせて20件超で、あわせて100件近い項目が1バージョンに詰まっていました。バージョンによって分量の差がここまで大きく、/release-notesで見比べるとこの粒度の差がそのまま体感できます。
バージョン番号は連番どおりに全件記載されているわけではありません。実際にv2.1.257の1つ前を見ると、変更履歴に載っている次の記録はv2.1.252で、253から256の4つは記載がありません。ピッカーで番号が飛んでいても、表示側の不具合ではなく変更履歴側の欠番なので、そのまま前後のバージョンを選び直せば大丈夫です。
バージョン番号はv2.1.258まで進んでおり、200を超える回数のリリースがすでに積み重なっています。「すべて表示」を選ぶとこの規模の履歴が一度に流れるため、特定の1件だけを追いたいときほど、全件表示ではなくピッカーで単一バージョンを選ぶ使い方が効いてきます。
自分のバージョンを確認してから読む
/release-notesで気になる項目を見つけても、それが自分の環境に関係あるかは、いま動いているバージョンが分からないと判断できません。バージョンの確認にはclaude --versionを使います。
claude --version表示された番号を/release-notesのピッカーで選べば、そのバージョンで何が変わったかを直接確認できます。自分のバージョンより新しい項目が並んでいれば、まだ手元に届いていない変更だと判断できます。逆に自分のバージョンと同じか、それより古い項目まで遡って読めば、いま起きている挙動がいつ入った変更に由来するかを追えます。
/doctorと組み合わせて使う典型的な流れ
/release-notesは単独でも使えますが、/doctorと組み合わせる使い方が実務では多くなります。/doctorを実行し、リリースチャンネル上に新しいバージョンがあると分かったとします。更新する前に/release-notesでそのバージョンの内容を確認し、破壊的変更や自分の環境に影響しそうな項目が無いかを見てから更新に進みます。
更新内容を先に把握してから更新するか判断できるため、変更点を知らないままアップデートして挙動が変わって困る、という事態を避けやすくなります。
似たコマンドとの使い分け
「アップデートを知る」目的で紛らわしいコマンドが他に2つあります。役割はそれぞれ独立しています。
| コマンド | できること | /release-notesとの違い |
|---|---|---|
/release-notes | できること過去の変更履歴を選んで閲覧する | /release-notesとの違い読むだけで、更新やチェックは行わない |
/doctor | できることインストール状態を診断し、リリースチャンネル上の新版有無も確認する | /release-notesとの違い「新しいバージョンがあるか」を判定する側 |
/upgrade | できることプランのアップグレードページをブラウザで開く | /release-notesとの違いバージョンではなく契約プランを上げる操作 |
インストール診断とあわせてリリースチャンネルの新版有無まで確認したいときは/doctorが向いています。/doctorはインストールの重複やPATHの問題も一緒に洗い出します。/release-notesで中身を読む前段の健康診断としても使えるということです。過去のリリースで何が変わったかを読み返すだけなら/release-notesで十分です。/doctorが自動修正まで担うようになった経緯はClaude Codeの/doctorが自動修正までするチェックアップになった仕組みで扱っています。
たとえば、Bashツール呼び出しのタイムアウト秒数がいつの間にか変わった気がするとします。原因はまだ分かりません。まずclaude --versionで自分のバージョンを確認します。次に/release-notesでそのバージョンとその前後を選んで読めば、タイムアウト関連の変更が入ったバージョンをターミナルの中だけで特定できます。Claudeに直接尋ねて調べさせるより会話の文脈を汚さずに済み、原因が見つかった時点でそのままコーディングの続きに戻れます。
よくある質問
/release-notesはアップデートを促すコマンドですか
いいえ、閲覧専用です。表示された内容から実際にバージョンを更新する操作は含まれません。更新の有無を確認したいなら/doctor、更新自体を実行したいなら通常のインストール手順(パッケージマネージャーやインストーラー経由の更新)を使います。
他のコマンドの役割も一覧で知りたいときは
Claude Codeに用意されている全コマンドの役割別早見表はClaude Codeスラッシュコマンド一覧で確認できます。
まとめ
/release-notesは、バージョンピッカーで選んだ変更履歴をターミナル表示だけに出し、Claudeの会話文脈には触れないコマンドです。頻繁にアップデート内容を確認する運用ほど、Claudeへ直接尋ねる方法よりトークン消費を抑えられます。ゲートウェイ経由で通信を絞っている環境やCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICを設定した環境では、表示が失敗することがあります。その場合は原因をネットワーク側から先に疑ってください。