Claude Codeの更新で仕事への影響を確かめる方法

公式の最新版と手元の版を分けて記録する

Claude Codeの更新を確かめるときに使う材料は3つです。公式のCHANGELOG、手元で claude -v を実行した結果、そして答えが決まっている小さな練習データです。

まず、公式の最新版と手元で動いている版を分けて書き留めます。2026年10月14日に確認した時点で、公式CHANGELOGの先頭は2.1.299でした。一方、今回の確認に使った端末は2.1.285です。2.1.299で追加された CLAUDE_CODE_DISABLE_FILE_MENTIONS はこの端末に入っていないため、試していません。

claude -v

公式ドキュメントには、使える版の条件が付いた項目があります。たとえばCLIリファレンスでは、claude attach にセッション名の一部を渡す使い方に「v2.1.290以降」と書かれています。2.1.285の端末では、この使い方を前提にできません。「Requires Claude Code v...」と書かれた項目は、手元の版と見比べてから手順書に書いてください。

インストールの経路と更新の基本操作はClaude Codeのインストール記事で扱っています。CLIリファレンスによると、claude update で最新版に更新でき、claude install 2.1.118 のように版を指定して入れ直すこともできます。ただし今回は、どちらも実行していません。

変更点の中から自分の仕事に関わるものを選ぶ

2.1.285の変更項目は100件を超えます。全部は試せないので、設定ファイルや手順書、社内の取り決めに書いてある機能に関わる項目だけを拾います。今回は「外部のWebページを取りに行かせずに社内資料だけで判定させたい作業」を想定し、WebFetchに関する項目を選びました。

公式に書かれているのは「WebFetchツールを無効にする」ことだけです。Bashなどほかのツールの通信や、Claude Code自体のAPI通信を止める機能だとは書かれていません。この変数を社内のネットワーク方針の代わりにはしないでください。法人での管理は法人で使うときのセキュリティ記事で確認してください。

手元の版で小さく試す

試験には、教材ページの制作依頼の練習セットを使います。ZIPを展開すると、同じ名前の最上位フォルダ production-review-practice/ ができます。作業に使うのは次の2つのフォルダです。

• exercise/: AIに渡す入力ファイル3つ。requests.json(架空の依頼8件)、judging-rules.md(判定規則)、prompt.txt(指示文)

• answer-key/: 期待結果と照合スクリプト

判定規則は11条あり、記録するissue codeは10種類です。期待結果をAIに見せないように、exercise/ の3ファイルだけを別のフォルダへコピーし、Claude Codeはそのコピー先で起動します。answer-key/ はコピーしません。

cd /path/to/production-review-practice
mkdir -p ~/cc-practice/request-check
cp exercise/requests.json exercise/judging-rules.md exercise/prompt.txt ~/cc-practice/request-check/
cd ~/cc-practice/request-check
claude -v
CLAUDE_CODE_DISABLE_WEB_FETCH=1 claude --tools Read,WebFetch --allowedTools Read \
  --setting-sources project --strict-mcp-config --mcp-config '{"mcpServers":{}}'

環境変数は、このコマンドの1回の起動にだけ付けます。設定のドキュメントによると、環境変数は設定ファイルの優先順位の外で扱われます。共有の設定ファイルに書く前に1回限りの起動で試せば、元に戻すのも簡単です。--setting-sources project はuserとlocalの設定元を読まない指定です。管理設定や組織ポリシーが適用される環境では、その制約は残ります。--strict-mcp-config に空の --mcp-config を組み合わせているので、MCPサーバーを使わずに実行されます。

これは対話モードで試す参考手順です。起動後に prompt.txt の内容を入力し、返答中の {"results":[...]} だけを人が ~/cc-practice/request-check/actual-results.json として保存します。コードフェンスや説明文は含めません。python3 -m json.tool actual-results.json > /dev/null で構文を確認します。AIがWriteで保存する手順を検証したものではありません。保存できたら、教材の最上位フォルダに戻って照合します。

cd /path/to/production-review-practice
python3 answer-key/check_result.py ~/cc-practice/request-check/actual-results.json

passed がtrueなら、id・decision・issue_codesが期待結果と一致しています。confirmationの文章は照合の対象外なので、内容は人が読んで確かめます。

1回だけの記録を読み違えない

2026年10月14日に、2.1.285で CLAUDE_CODE_DISABLE_WEB_FETCH=1 を付けて1回だけ実行した記録です。ログは教材の measurement-and-updates/observed/webfetch-disabled.json に収録しています。

R01はready、R02〜R08はholdでした。たとえばR08は、締切の2026-10-13が基準日より前なので past_deadline が付いています。

この記録から言えるのは、この端末・この条件で1回実行したところ、起動時のツールにWebFetchがなく、判定が期待結果と一致した、ということだけです。次のことは確かめていません。

• 今回のツール一覧は通常より少なく、変数なしで同じ条件の対照実行もしていません。そのため、WebFetchが消えた原因が変数だけかどうかは切り分けられていません。

• WebFetch以外の通信が止まるかどうかは確認していません。

• 更新前後の版を比べた試験ではありません。

• AIが自分でファイルに書き込む操作は試していません。

費用と時間は1回分の値なので、見積もりの根拠には使わないでください。

更新確認票に1行で残して手順へ反映する

結果は、教材の measurement-and-updates/update-check.csv に1行で記録します。期待結果と戻す手順を実行前に書いておけば、出力を見てから基準を変えてしまうのを防げます。今回の記録を当てはめると、次のようになります。

採用すると決めたら、手順書の起動コマンドを直します。設定ファイルに書く場合は、誰に適用するかで書き先を選びます。設定のドキュメントでは、共有前に試すなら .claude/settings.local.json、チームで共有するなら .claude/settings.json が想定されています。共有ファイルの env の値の多くは、各メンバーがフォルダを信頼するまで反映されません。書き終えたら /status で読み込まれた設定元を確かめ、claude doctor で拒否された項目がないかを見ます。

制作依頼の確認をスキルにする記事のように手順をSkillにしている場合も、更新後に同じ練習セットで同じ結果になるかを確かめ、確認票の行に加えてください。

次の一歩

次の更新が出たら、CHANGELOGから自分の運用に関わる項目を1つだけ選び、同じ練習セットで確認票に1行記録してください。今回足りなかった変数なしの対照実行から始めるのが手軽です。

更新確認票を教材ページで見る