Opus 5.5でCLAUDE.md見直しが要る理由とプロンプト

アポロ

2026年9月28日 12:09

Opus 5.5でCLAUDE.mdの見直しに迷う人向けに、理由と使えるプロンプト4本をまとめました。

「effort（考える深さの設定）を high にしたはずなのに、なんだか答えが浅い」。Opus 5.5 に替えてから、こんな違和感はありませんか。

結論から書きます。Opus 5.5 に替えたら、CLAUDE.md とスキルは一度見直したほうがよいです。前のモデルに合わせて書いた指示や設定が、そのままでは効かなかったり、効きすぎたりするからです。

見直しは、Claude Code に頼めば自分で1行ずつ読まなくても進められます。この記事では、見直しが要る理由と、そのまま貼って使えるプロンプト4本を渡します。

この記事は、Claude Code を使い始めたみなさん向けです。先に言葉をそろえます。

CLAUDE.md（Claude Code がセッションを始めるたびに読む、プロジェクトの説明書）
スキル（決まった作業の手順をまとめたファイル。中身は SKILL.md）
サブエージェント（仕事の一部を任せる、別の Claude。定義ファイルは .claude/agents/ に置く）

なお、Claude Code で Opus 5.5 を使うには v2.1.280 以降が要ります。ターミナルで claude --version と打って確かめ、古ければ claude update で上げてください。

見直さないと、こんなことが起きる

見直しをしないまま使うと、次のようなことが起きます。どれもエラーは出ません。

設定したはずの effort（どれだけ考えてから答えるかの設定）が効いていない
日付の過ぎた指示が、まだ効き続けている
2か所に置いたスキルの版がずれて、決めたはずのルールが抜けている

2つ目と3つ目は、わたしが 2026-09-26 に実際に見つけたものです。サブエージェントの定義ファイルに「9月7日までは〜を提案しない」という指示が、9月26日にも残っていました。スキルの版のずれは、次の章で書きます。

なぜ Opus 5.5 で見直しが要るのか

理由は3つあります。前のモデル向けの指示が要らなくなったこと。設定の既定が変わったこと。そして、ファイルは放っておくと古くなることです。

1. 前のモデル向けの指示が、要らなくなっている

Opus 5.5 の移行ガイドには、次の一文があります。Opus 5 向けに調整した指示は、要らなくなっているかもしれない。

たとえば「答える前によく考えて」という指示です。Opus 5.5 では、考える機能が常に有効です。Opus 5.5 向けのプロンプトの案内は、この種の指示は外すことを検討してよいとしています。チャット用の指示文についての案内です。CLAUDE.md にも同じ考え方が使えます。

ただし、Claude Code の ultrathink は別です。そのターンだけ深く考えさせる、公式に用意されたキーワードなので残します。

「必ず」「絶対に」「CRITICAL」のような強い言葉も見直しの候補です。Anthropic のドキュメントは、少し前の Opus 4.5 と 4.6 について書いています。強い言葉は、ツールやスキルの呼びすぎにつながる。「CRITICAL: You MUST use this tool when...」は「Use this tool when...」で足りる、という説明です。Opus 5.5 について同じ明言は見つかりませんでした。ただ、わたしのテストでは、強い言葉を減らしても困りませんでした。

2. 設定の既定が変わった

Claude Code での Opus 5.5 の effort の既定は、medium です。Opus 5 は high でした。Anthropic の試験では、Opus 5 の high と同等以上だったそうです。コーディングと知識業務の評価での結果です。

気をつけたいのは、以前保存した設定です。ユーザー設定ファイル（~/.claude/settings.json）に直接書いた effortLevel は、Opus 5.5 には効きません。今の effort はモデルごとに保存する仕組みで、古い書き方は新しいモデルに引き継がれないためです。ここにだけ書いている場合は、/effort か /model で選び直すまで既定のまま動きます。「high にしたはず」が効いていないのは、これが原因かもしれません。/effort で選び直せば済みます。

3. 指示ファイルは、放っておくと古くなる

指示ファイルは、書いた日の事情を覚えたまま残ります。日付つきの指示や、その時点の数字がそうです。

同じスキルを2か所に置いている人は、版のずれにも注意がいります。わたしは、手元のプロジェクトと claude.ai の2か所に置いていました（claude.ai にもスキルを登録できます）。照合すると、中身まで同じだったファイルは2つだけでした。claude.ai 側のスキルを短く書き直したとき、古い版を土台にしていたのが原因でした。

ただし、削りすぎると壊れる

見直しは、削ることだけではありません。わたしはその claude.ai 側の短い版と、元の版を比べました。同じ依頼を3回ずつ出すと、短い版では記事の冒頭の章が3回とも出てきませんでした。元の版では3回とも出ました。

エラーは出ず、出力はそれらしく整っていて、読んだだけでは気づきませんでした。ぎょっとしました。短い版には、その章を置く欄ごと無かったのです。

レシピにたとえると、わかりやすいと思います。料理人が腕のいい人に代わったら、「絶対に」「必ず」の赤線は消してよいです。でも、コース表から前菜の皿を消したら、どんなに腕がよくても前菜は出てきません。赤線（強調の書き込み）が強い言葉で、皿が出力の型（章の型・表の欄・チェック項目）です。

見直しに使うプロンプト4本

進め方は4段です。①一覧にして控えを取る。②点検する。③直し方の案を出させる。④前後で比べて確かめる。どれも Claude Code のチャット欄にそのまま貼れます。〈〉の中だけ、自分の環境に合わせて書き換えてください。プロンプト1〜3は、同じ会話の中で続けて貼ります。前の結果を使うからです。

プロンプト1　一覧にして、控えを取る

まず、見直す対象をすべて書き出し、書き換える前の控えを取ります。

このプロジェクトとユーザー設定（~/.claude）にある CLAUDE.md、スキル（SKILL.md）、サブエージェントの定義ファイルを探して、パスの一覧にしてください。プラグインで入れたものは除き、自分で書いたものだけにしてください。
一覧にしたファイルは、元のフォルダ構成のまま「〈控えの置き場所〉/控え_〈今日の日付〉」フォルダにコピーしてください。
元のファイルは書き換えないでください。

〈控えの置き場所〉は、プロジェクトの外にします（例：/Documents）。プロジェクトの中や .claude の中に置くと、控えの CLAUDE.md やスキルまで読み込まれることがあります。git を使っている人も、控えは取ります。/.claude 側のファイルは、プロジェクトの git に入っていないことが多いからです。

claude.ai にもスキルを登録している人は、登録に使った zip も控えとして残しておきます。手元で直したら、claude.ai 側も登録し直します。

プロンプト2　点検する

Claude Code v2.1.283 以降なら、チャット欄に /doctor prompt-audit と打つのがいちばん早いです。CLAUDE.md・スキル・サブエージェントの定義から、古いモデル向けの書き方を探してくれます。見つけたものと直し方の案を先に出し、確認なしにはファイルを書き換えません。/doctor の案をそのまま使うならプロンプト4へ、方針を足したいならプロンプト3へ進みます。

使えない環境や、観点を自分で指定したいときは、次のプロンプトを使います。

プロンプト1で一覧にしたファイルを1行ずつ読み、次の分類に当てはまる行を表にしてください。まだ何も書き換えないでください。
・強い念押し（「必ず」「絶対に」「CRITICAL」「重要」など）
・考え方の指示（「よく考えて」「ステップごとに考えて」など）
・日付や、その時点の数字が入った指示
・同じ内容が2か所以上に書かれている指示
・ファイルどうしで矛盾している指示
表の列は「ファイル名／該当する行／分類／直すなら何に直すか」にしてください。

プロンプト3　直し方の案を出させる

点検の結果をもとに、直し方の案を出させます。ここで「残すもの」をはっきり伝えるのがコツです。/doctor の結果を使うときは、1行目を「上の点検結果をもとに」に替えます。

プロンプト2の表をもとに、直し方の案を「変更前／変更後」の形で出してください。まだファイルは書き換えないでください。
直し方の方針：
・強い念押しは、普通の言い方に直す（「必ず〜すること」→「〜する」）
・考え方の指示は、外す案を出す（ただし ultrathink は残す）
・日付の過ぎた指示は削る。その時点の状況を表す数字（件数・順位・価格など）は削る。品質の基準の数字（文字数の上限など）は残す
・次のものは残す：誰向けか・環境・品質の基準とその理由、出力の章の型・表の欄・チェック項目、実際に起きた失敗から作った禁止
・残すものに当たる行を削る案は出さないでください

案を読んで、納得したものだけ「この案のとおりに書き換えてください」と頼みます。一度に全部ではなく、ファイル1つずつが安全です。

プロンプト4　前後で比べて確かめる

書き換えたら、効いているかを確かめます。控えの版（前）と今の版（後）に同じ依頼を出して比べます。このプロンプトは、スキルとサブエージェントの定義ファイル向けです。CLAUDE.md の比べ方は、この節の最後に書きます。

サブエージェントを6つ、1つずつ別々に立ててください。
3つには「〈控えの置き場所〉/控え_〈日付〉」の中の〈ファイル名〉を、残り3つには今の〈ファイル名〉を読ませ、次の依頼を出してください。
依頼：登録済みのスキルは呼ばず、このファイルの手順だけに従って、〈いつもこのファイルで頼んでいる作業〉をしてください。
6つの出力は、どちらのファイルのものか分かるようにして全文を見せてください。
最後に、〈出てほしい章や項目〉が6つの出力それぞれにあるかを表で数えてください。

〈〉の記入例です。

〈ファイル名〉：.claude/skills/議事録/SKILL.md（控え側も、控えフォルダの中の同じ場所にあります）
〈いつもこのファイルで頼んでいる作業〉：この議事メモから議事録を作る
〈出てほしい章や項目〉：決定事項の表と、次回までの宿題の欄

サブエージェントは1回ごとに新しく立ち上がるので、前の回の出力が次に混じりません。

戻すかどうかは、次のように決めます。

今の版で、出てほしい章や項目が2回以上少ない（例：3回中3回が1回に）→ その書き換えを戻す
1回だけ少ない → もう一度プロンプト4を回し、6回ずつで比べる。6回中2回以上少なければ戻す
それ以外 → 書き換えを残す

CLAUDE.md を比べるときは、サブエージェントを使いません。CLAUDE.md はサブエージェントにも自動で読み込まれ、前と後が分かれないからです。かわりに、プロジェクトのフォルダを別の場所にコピーし、コピー側の CLAUDE.md だけを控えの版に戻します。2つのフォルダでそれぞれ Claude Code を開き、同じ依頼を3回ずつ出して比べます。1回ごとに /clear で会話を消してから出します。

Opus で6回動かすので、そのぶん利用枠を使います。いちばんよく使うスキル1本から始めるのが無難です。

effort も、ここで選び直しておきます。チャット欄に /effort と打つと選び直せます。公式は medium から始め、いくつかの段階を試して測るよう勧めています。上げて良くなった作業だけ上げれば十分です。

うまくいかないとき

点検で「削る候補」がたくさん出た

全部を削る必要はありません。候補の中に、出力の章の型や表の欄、チェック項目が入っていないかを先に見ます。入っていたら、残します。

Anthropic は、/claude-api prompt-audit（/doctor prompt-audit と観点の近い点検機能）の手順書を GitHub で公開しています。その中で、指示に書き込んだ参照用の表や配点表、細かい段取りも見直しの候補に挙げています。出力の型をその近くに書いていると、案の中で一緒に消されることがあると、わたしは見ています。手順書自身も、削除は仮説で、振る舞いを確かめてから決める立場です。

比べても差が出ない

差が出ないのは、今の依頼にその行が効く場面が無いだけかもしれません。削る前に、その行が効く依頼を1件わざと作り、もう一度比べます。それでも差が無ければ削ります。

CLAUDE.md を書き換えたら、ほかの作業が変になった

CLAUDE.md は、多くの場合サブエージェントにも読み込まれます。書き換えの影響は広く出ます。次のように頼んで元に戻し、1行ずつ書き換え直します。

〈控えの置き場所〉/控え_〈日付〉の CLAUDE.md で、元の場所の CLAUDE.md を上書きしてください。

見直しが済んだかの確認

次の4つがそろえば、見直しは一回り済んでいます。

書き換える前の控えがある
強い念押し、考え方の指示、日付の過ぎた指示が整理されている
出てほしい章や項目が、前の版より減っていない
effort を /effort で選び直した

おさらい

Opus 5.5 では、前のモデル向けの指示が要らなくなり、effort の既定も変わった。一度は見直す
強い言葉は減らしてよい。出力の型（章・欄・チェック項目）は残す
プロンプト4本（一覧と控え→点検→直し方の案→前後の比較）で一回りする

削るのは言葉で、出力の型ではありません。

まずはプロンプト1を貼って、自分の指示ファイルの一覧を出すところから始めます。

参照したページ

▶ 前提：CLAUDE.mdとskill、重複を断つ3つの質問（無料）削る前に、CLAUDE.mdとスキルに同じ指示を二重に書いていないか確かめたい人へ。見分ける質問を3つにまとめてあります。

次の一手は、工程①です

ここまでで見直しの理由と、そのまま使えるプロンプト4本が手に入りました。ここから先は、仕様書の話です。

工程①は、Claude Codeでアプリをつくる講座（全5本）の1本目です。CLAUDE.mdもスキルも、Claudeに何をさせたいかを書いた仕様書です。見直しで迷わないのは、それを最初に書き出してあるときです。アプリづくりでは、これを工程①でやります。

わたしが実際に使っている全文は、工程①の記事に置いてあります。壁打ちプロンプトが4種類。それと、できた仕様書をファイルにして次回のClaude Codeへ引き継ぐプロンプトが1本です。500円。

工程①で書くのは、日本語の要件だけです。コードを書くのは②以降の工程になります。

②の記事は、①で書き出した仕様書ファイルを読み込ませるところから始まります。

わたしが最初に作った備品管理ツールは、3回作り直しました。毎回「だいたいこんな感じで」としか伝えていなかったからです。3回目でようやく、先に要件を書き出してから頼みました。最初から一問一答をやっていれば、2回分の作り直しは要りませんでした。

買ってください。500円で、その一問一答のプロンプト全文4種類が手に入ります。

▶ アプリをつくるまえに要件を固めよう（500円）

Claudeの使い方を書いています。よければフォローしてください。