Claude Opus 4.7 移行ガイドをZenn記事化

2026年4月17日 23:40 更新

一言でいうと

AIの新バージョンに乗り換える時の設定書き換え手順を、実体験ベースで記事化した

なぜこれが必要なのか

普段の開発で使っている AI「Claude Opus」（Anthropic社が提供する対話型AI）が、4.6 から 4.7 に上がった。見た目は「モデルIDを書き換えれば動く」程度の簡単な移行に見えるが、実際は裏側の挙動がかなり変わっている。たとえば、

AIが自動で呼び出す「補助スタッフ」（subagent / サブエージェント、並列で別タスクをこなす小さなAI）の起動頻度が減った
ファイルを調べるような「道具の呼び出し」（tool call）の頻度も減った
プロンプト（指示文）を「言葉通り」に解釈するようになり、察してくれなくなった

これを知らずに4.6のノリのまま使うと「なんか大人しくなった」と感じて、本来の性能を引き出せない。一方、Anthropic の公式ドキュメントは網羅的だが英語・分量が多く、「実際何をいじればいいのか」の答えには直結しない。 自分の環境で実際に何をどう書き換えたかを日本語でまとめた記事があれば、同じく移行で戸惑っている人の役に立つはず。 Zenn（エンジニア向けの技術記事プラットフォーム）に公開する前提で、ドラフトを書き上げた。

何をしたのか

移行で踏むべき設定変更とAPI書き換えを、約8000字の Zenn 記事に落とし込んだ。公式ドキュメントを翻訳するのではなく、「私の環境ではこう設定した」という実装ログ側に振り切った構成。

BEFORE（執筆前の状態）

Claude 4.7移行、日本語まとめ記事が薄い
公式docは英語・網羅的だが読みにくい
「結局何をいじるの？」に答えが無い

AFTER（執筆後の状態）

4.6→4.7比較表（破壊的変更と挙動差を色分け）
settings.json（AIの挙動を決める設定ファイル）の実例
API書き換え前後のコード例（Python）
実際につまづいた罠6件の具体対処

記事に盛り込んだ要点

1effort level（努力レベル）の変更

AIが「どれくらい頭を使うか」を指定するパラメータ。4.7で xhigh という新レベルが追加された。公式のAPIデフォルトは high だが、コーディング用途では xhigh 開始が推奨されている。ここを上げないと4.6より大人しい印象を受けるため、最初の設定変更として説明している。

2新トークナイザーへの対応

トークナイザー（文字をAIが数える単位に変換する仕組み）が4.7で刷新され、同じ文章でも1〜1.35倍のトークンを消費するようになった。そのため、会話履歴が自動的に要約（compact）されるしきい値を上げる必要がある。環境変数で CLAUDE_CODE_AUTO_COMPACT_WINDOW=700000（70万トークン）に引き上げた設定例を掲載。

3破壊的変更（Breaking changes）の書き換え

AIと直接通信するAPI（Messages API）を使っているコードは、以下の3点で動かなくなる。それぞれ「移行前」「移行後」のPythonコード例を Before/After で並べた：

temperature/top_p/top_k（応答のばらつきを制御するパラメータ）は非デフォルト値で400エラー
手動の思考予算 budget_tokens が廃止（adaptive thinking = モデル自身が思考深度を決める方式に一本化）
思考内容（thinking content）がデフォで空に（これだけはエラーにならない silent な変更）

4CLAUDE.md（AIへの固定指示ファイル）の更新ルール

4.7は「察して」が通じなくなったため、やりたいこと・制約・完了条件を明文化するルールを追加。 compact（会話履歴の要約）前に外部ノートに重要な分析を書き出す、というルールも強調した。 compactは要約なので必ず情報が欠落するため、書き出し→compactの順が鉄則。

執筆プロセス（品質の担保方法）

記事を1回書いただけでは事実誤認が残るため、以下の3段階でチェックした：

1Codex（OpenAIのGPT-5.4搭載レビューAI）でファクトチェック

Codexに「事実誤認・言い過ぎ・未確認の断定」を指摘させた。 11件の指摘が返り、その中には「4.6のeffort levelを3段階と書いているが実際は4段階（max含む）」「extended thinking が廃止と書いているが、正確にはmanual thinking方式が廃止でadaptive thinking は引き続き動く」など、公式ドキュメントと食い違う重要な誤りが含まれていた。すべて反映済み。

2ai-smell（AI臭検出スキル）で文章チェック

AIが生成した文章特有の「臭み」（em-dashの多用、「〜とされています」「〜と思われます」のような曖昧な断定回避など10パターン）を自動検出するスキル。 0件検出で通過した。元々、口語・実体験ベースで書いたので自然とパターンを踏まなかった形。

3公式ドキュメントの一次情報照合

執筆前に Anthropic 公式の「What's new in Claude Opus 4.7」「Migration guide」「effort」「adaptive thinking」「task budgets」など6本のドキュメントを読み込み、 Codexにも公式URLを渡して裏取りさせた。記事末尾に参照元リンクをまとめて掲載。

ポイント・今後

「察して」が通じない前提で書くという運用の変化が、4.7移行で一番大きな生活変更だった。これまで「雰囲気で動いてくれた」部分を、完了条件まで明文化する習慣に切り替える必要がある。記事でも設定だけでなく運用側の習慣変更を1セクション割いている。

見送った選択肢: ベンチマーク比較（SWE-bench Verified の数値など）は意図的に省いた。公式blogや海外メディアが散々書いているので、この記事では「設定diffと実体験」に全振りしたほうが差別化になると判断。

次のステップ: Zenn への実投稿（現状 published: false でローカル保存）、および反応を見て加筆修正。 ~/plans/zenn-opus4.7-migration-draft.md に最終版あり。