Opus 5以降のCLAUDE.md：長い指示がClaudeの妨げになる理由

Ailootの利用方法については、ドキュメントをご覧ください。

Opus 5のリリース後、Claudeはどう変わったのか？#

Opus 5は2026年7月24日にリリースされ、すぐにClaude Codeのデフォルトモデルになりました。モデル自体の価格、ベンチマーク、努力度モードについては、別のガイド「Claude Opus 5に切り替えるべきか？」で詳しく説明しています。この記事で扱うのは別のことです。モデルのリリースによって、効果的な話しかけ方も変わりました。

AnthropicはClaudeのブログで分析記事を公開しました。要点は次のとおりです。

重要なのは「制約しすぎていた」という言葉です。モデルが弱かった頃は、足場となる指示が必要でした。「これをして、あれはしないで、例はこれです。もう一度繰り返します」といったものです。Opus 5にはもうその足場は必要ありません。むしろ妨げになることがあります。Anthropicが示す新しい原則はシンプルです。Claude自身の判断に任せましょう。

実際には、あなたにとってどんな意味があるのでしょうか？

• あなたのCLAUDE.mdも、プロジェクト用のシステムプロンプトです。 Anthropicが自社のものを80%削減したのなら、あなたのファイルも肥大化しているかもしれません。
• ルールの長いリストが、指示への準拠を保証するわけではありません。 反対に、行数が増えるほどモデルが指示に従わなくなります（詳しくは後述。ドキュメントの数値も紹介します）。
• 新しい仕組みも登場しました。 自動メモリとスキルが、以前はCLAUDE.mdに手作業で書き込む必要があった作業の一部を引き受けます。

要点は、最も重要な作業はプロンプトの前に行われるということです。最初のリクエストを送る前に、モデルのコンテキストへ何を入れておくかが大切です。Opus 5のアップデートは、実質的にAnthropicがこの考え方を公式に裏付けたものです。今回は具体的な数値と新しいツールも示されました。それぞれ見ていきます。

長いCLAUDE.mdは、なぜ今では妨げになるのか？#

仕組みを説明します。CLAUDE.mdは、各セッションの開始時にClaudeが読むルールのファイルです。別のガイド「CLAUDE.mdの設定方法」ではゼロから作る方法を解説していますが、この記事で扱うのは逆の作業、つまり今のファイルから何を削除するかです。そこに書いたことはすべて、最初のリクエストを送る前にコンテキストへ入り、会話が続く間ずっと残ります。コンテキストは無限ではありません。ルールの行が増えるたびに、あなたのタスクに使えるはずの容量が減ります。

Claude Codeのドキュメントは、はっきり述べています。

2つ目の指摘は、1つ目より重要です。長いファイルは指示への準拠を低下させます。モデルは指示に注意深く従わなくなります。これは、ほとんどの初心者が陥る落とし穴です。論理は揺るぎないように見えます。「Claudeに指示を聞いてほしいから、ルールをもっと書こう」。実際には逆のことが起こります。リストが長くなるほどモデルの注意は散漫になり、ルールが飛ばされる頻度が上がります。

アプローチがどう変わったのか、次の表で見てみましょう。

もう1つ問題があります。矛盾です。ファイルが大きくなるにつれ、互いに衝突するルールがたまるのはほぼ避けられません。ある場所では「必ずテストを書く」とあり、別の場所では「testsフォルダーに触れないで」と書かれているかもしれません。ドキュメントは、2つのルールが矛盾している場合、Claudeはどちらかをランダムに選ぶ可能性があると警告しています。つまり、肥大化したファイルはモデルの動作を予測しにくくします。

簡単なルールがあります。CLAUDE.mdには、Claudeが自力で推測できないことを短く書きます。それ以外は、モデルの注意を消費するだけです。

CLAUDE.mdには何を残し、何を削除すべきか？#

ドキュメントには、ルールをCLAUDE.mdに書くべきか判断する明確な基準があります。次に当てはまる場合は追加します。

1. Claudeが同じ間違いを2回目にした。
2. コードチェックで、このプロジェクトについてモデルが知っているべきことが検出された。
3. 同じ修正をチャットで2回目に入力している。
4. プロジェクトを壊さないよう、新しく参加した人にも同じ背景知識が必要になる。

一般原則は、プロジェクト固有の落とし穴を残し、明白な内容は削除することです。Claude Codeには、肥大化したCLAUDE.mdの整理を提案する組み込みチェックclaude doctorもあります。コードベースからモデルが推測できる詳細、たとえばフォルダー構成、依存関係のリスト、アーキテクチャの概要などを削り、落とし穴、その理由、デフォルトと異なる慣例を残します。

2つ目の重要なルールは具体性です。曖昧な表現は機能しません。次を比べてください。

違いはシンプルです。モデルは「適切に整形する」を好きなように解釈できます。一方、「インデントは2スペースにする」は明確に確認できます。CLAUDE.mdの各ルールは、守られたかどうかを確認でき、目で見て分かるものであるべきです。

3つ目は、明白なことを削除することです。CLAUDE.mdに「きれいなコードを書く」や「ベストプラクティスに従う」と書くのはノイズです。モデルはすでに知っており、その一行は容量を使って注意を散らします。Anthropicも、明白なことにコンテキストを費やさないよう明確に勧めています。

CLAUDE.mdに合わないルールはどこへ移すべきか？#

ここで、最も過小評価されているツールが登場します。以前はすべての指示をCLAUDE.mdに置く必要がありましたが、今では長い手順をスキルにまとめられます。別のガイド「Claude Codeスキルの選び方」では、スキルを増やしすぎずに適切なものを選ぶ方法を説明しています。

この違いは根本的です。CLAUDE.mdは各セッションの開始時にすべて読み込まれますが、スキルはそうではありません。ドキュメントは次のように説明しています。

これはプログレッシブ・ディスクロージャー、つまり情報を必要に応じて読み込む方法と呼ばれます。モデルに適切なタイミングで、情報を少しずつ与えるという考え方です。Anthropicは、コードレビューの指示など詳細な指示をスキルに移し、システムプロンプトから削除しました。

スキルに移す基準はシンプルです。CLAUDE.mdの一節が、事実から手順に変わったら移します。「ビルドはnpm run buildで実行する」という1行のメモは事実なので、CLAUDE.mdに置きます。「プロジェクトの公開方法」の10ステップは手順なので、スキルに置きます。

実用的な原則は、2、3回を超えて繰り返す作業は任せることです。たとえば、毎週の顧客レポートをどのように作成するかを一度説明し、それをスキルにすれば、もう説明し直す必要はありません。スキルはコンテキストを消費せずに置いておけて、/otchetのようなコマンドで名前を指定して呼び出せます。

スキルに移すと便利なものは次のとおりです。

• 複数ステップの手順（公開、レポート作成、リリース前チェック）。
• 完全な形で必要になることは少ないが、長い指示。
• 別のチャットに2回目または3回目にコピーする内容。

中間的な選択肢もあります。フォルダーごとのルールです。指示がプロジェクトの特定部分にだけ関係する場合は、.claude/rules/に置き、該当ファイルにリンクできます。そうすれば、常にコンテキストに残るのではなく、Claudeがそのファイルを扱うときだけ読み込まれます。

自動メモリとは何か、2026年になぜ使うのか？#

CLAUDE.mdの負担を軽くする2つ目の新しい仕組みが、自動メモリです。Claudeはあなたが書いた内容だけでなく、自分で気づいたことも覚えるようになりました。別のガイド「ClaudeのメモリとCLAUDE.mdの違い」では、両者の仕組みの違いを説明しています。

2種類のメモリの違いは次のとおりです。

仕組みは次のとおりです。Claudeはタスクに取り組む間に、ビルドを実行するコマンド、デバッグで行き詰まった箇所、あなたが別のやり方を求めたことなど、役立つ詳細に気づき、それをメモに保存します。次のセッションでその情報を取り出します。重要なのは、将来役立つと判断したものだけを選んで保存することです。

メモはプロジェクトごとに別のフォルダーに保存され、MEMORY.mdというインデックスファイルがあります。/memoryコマンドで表示、編集できます。通常のテキストファイルなので、いつでも読んだり、編集したり、削除したりできます。

実際に何が変わるのでしょうか。Claudeは、以前なら間違いを犯すたびにあなたがCLAUDE.mdへ追加していた内容の一部を、自分で記録するようになりました。これによってルールファイルはさらに短くなります。これは良いことです。

Opus 5はなぜ指示に異議を唱えるのか？#

これには裏面もあります。

判断する権限を与えられたモデルは、文脈の中により良い選択肢を見つけると、定義上、ときに硬直したコマンドに異議を唱えます。

Opus 5にアップグレードした後、問題が起きた場合は次の点を確認してください。

1. 古いスキルとプラグインを再確認する。 以前のモデル向けに作られた設定は、新しいロジックと衝突することがあります。以前は問題なく動いていたものも、もう一度テストする価値があります。
2. 最も硬直した表現を削除する。 第5世代モデルは「Xを絶対にするな、Yだけを必ずしろ」のような命令より、理由を説明する柔軟な表現をうまく扱います。
3. モデルが早く止まりすぎる箇所を確認する。 指示同士が矛盾している、または肥大化したCLAUDE.mdのルールと衝突している兆候かもしれません。

Opus 5向けにCLAUDE.mdを書き直す方法：手順#

以前のモデル向けに作られたCLAUDE.mdを見直す手順は次のとおりです。

1. 組み込みチェックを実行する

   プロジェクト内でclaude doctorと入力します。肥大化したファイルから何を削除し、何を残すべきか提案されます。

2. 明白なことを削除する

   Claudeがコード自体から推測できる行をすべて削除します。フォルダー構成、ライブラリの一覧、「きれいなコードを書く」のような一般的な表現などです。

3. 矛盾を削除する

   ファイルを上から下まで確認して、互いに衝突するルールを見つけます。一方を残し、矛盾するもう一方を削除します。

4. 手順をスキルに移す

   事実から段階的な指示に変わったものは、別個のスキルに移します。CLAUDE.mdには1行のリンクを残します。

5. 残すルールを具体的にする

   各ルールを確認可能な表現に言い換えます。「適切に整形する」を「インデントは2スペースにする」に変えます。

6. 自動メモリを有効にして、長さを確認する

   自動メモリが動作していること（/memory）と、ファイルが200行未満であることを確認します。そうでなければ、まだ移すべきものがあります。

最初の整理を手作業で行わず、Claudeに任せることもできます。以下は出発点として使えるプロンプトです。コピーして、プロジェクト内で開いたセッションに貼り付けてください。

私のCLAUDE.mdとコードを読んでください。あなたのタスクは、第5世代モデルにとってCLAUDE.mdを短く、役立つものにすることです。

ファイルを確認し、すべてのルールを次の3グループに分けてください。

KEEP - プロジェクト固有の落とし穴と、コードを見ただけでは自分で推測できない慣例。

DELETE - すでに知っている明白なこと、およびコードから推測できること。

MOVE TO A SKILL - 現在CLAUDE.mdに文章として書かれている複数ステップの手順。

グループ1については、曖昧なルールを具体的で検証可能な表現に言い換えてください。
互いに矛盾するルールを見つけ、別々に示してください。
200行未満の新しいCLAUDE.mdと、スキルへの移動を提案する項目の一覧を返してください。
確認するまで、ファイルは変更しないでください。

最後の行に注目してください。「確認するまで、何も変更しないでください」。自分で判断するようになったモデルには、これは重要です。まず計画を提示させ、決定権はあなたに残しましょう。

なぜプロンプトよりコンテキストが重要なのか？#

Opus 5の詳細をひとまず脇に置き、全体を見渡すと、この記事の分析は1つの考えに行き着きます。プロンプトよりコンテキストが重要です。最も重要な作業はリクエストの前、つまりモデルが作業する環境を整えるときに行われます。

CLAUDE.md、スキル、自動メモリは、Claudeが最初のメッセージを受け取る前に見るものという点で、すべて同じものの一部です。リクエストの言い回しは何度でも調整できます。しかし、コンテキストがうまく構成されていなければ、肥大化したCLAUDE.md、矛盾するルール、構造の欠如などによって、結果は一貫しないままです。

簡単な確認方法があります。最初の脳がなければ、第二の脳も役に立ちません。この記事でいう「第二の脳」とは、モデルが各リクエストで読むプロジェクト知識の構成です。ただし、それが機能するのは、タスクについてあなた自身が明確に理解している場合だけです。ツールはあなたの思考を増幅します。その役割はそこで終わります。

Opus 5のアップデートで、この考え方はより明確になりました。Anthropicは自社の取り組みを通じて、モデルが十分に賢いときは余分なルールがかえって害になり、コンテキストを丁寧に整えた人が優位に立つことを示しました。このスキルは、Opus 6であれ他のモデルであれ、次のモデルでも役立ちます。

今すぐ何から始めればよいのか？#

「いつか」まで先延ばしにしないでください。最も簡単な第一歩は、今すぐCLAUDE.mdを開き、各行について正直に考えることです。これはClaudeが推測できない落とし穴でしょうか。それとも念のために加えた明白なことでしょうか。後者はすべて削除候補です。

次に、上のセクションにあるプロンプトでファイルを整理し、長い手順をスキルに移し、自動メモリが有効になっていることを確認します。一晩作業すれば、コンテキストは簡潔で正確な基盤になります。

ご自身の実際のプロジェクトで、CLAUDE.md、第二の脳、タスク用スキルを使って実践できます。

Ailootについて詳しく知る。