Global CLAUDE.md — Refreshed For Claude Opus 5

CLAUDE.mdを今すぐ見直すべき決定的理由とClaude 5世代最適化の全手順

「なぜかClaude Codeの動きが鈍い」「指示を出しているのに意図した通りに動かない」——そんな悩みを抱えているなら、原因はモデルの性能ではなく、あなた自身が書いたCLAUDE.mdにあるかもしれない。2026年7月24日、Anthropicは公式ブログで衝撃的な事実を公表した。Claude Opus 5 / Fable 5向けにClaude Codeのシステムプロンプトを80%以上削減したところ、社内コーディング評価において性能低下がまったく測定できなかったというのだ。 （あわせて読みたい：日産純正ナビでYouTubeをAndroidで見る方法！映らない理由と裏ワザ）

これは単なるAnthropicの内部最適化の話ではない。私たちが日々育て上げてきたCLAUDE.mdにも、全く同じ問題構造が埋め込まれている可能性が高い。Qiitaのエンジニアコミュニティで大きな反響を呼んだ記事（nogataka氏、2026年9月5日公開）を発端に、Claude 5世代向けのコンテキスト設計を根本から見直す動きが加速している。本稿では、その最前線の知見を整理・深掘りし、具体的なアクションプランとして提示する。

📌 【この記事の重要ポイントまとめ】

• 要点1：AnthropicがClaude Opus 5向けシステムプロンプトを80%以上削減しても性能低下ゼロだったことが、CLAUDE.md見直しの決定的な根拠となっている。
• 要点2：Claude 5世代は「文脈から自律判断できる」設計になっており、旧世代向けの禁止ルール・手順全文・例示の多くが逆に判断の妨げになっている。
• 要点3：既存CLAUDE.mdの7ステップ見直し、スキル定義によるワークフロー化、プロジェクト種類別の記述例（全体用1＋種別6）を実践することで、Claude Codeの実行品質が大幅に改善する。

【2026年最新】AnthropicがシステムプロンプトをΔ80%削減——CLAUDE.md見直しの震源地

公式発表資料によると、Anthropicの内部チームは2026年7月24日のブログ投稿において、Claude Opus 5ならびにFable 5を対象としたClaude Code向けシステムプロンプトの大幅な簡略化を正式に開示した。削減率は80%超。従来プロンプトに含まれていた「最悪ケース回避のための制約」「例外処理の細かな手順」「動作の例示」などが根こそぎ取り除かれた。

Anthropicが示した理由は明快だ。「制約の多くは最悪のケースを回避するために入れたものだが、今のモデルは周囲の文脈から判断できる」。これはAIの能力論ではなく、設計哲学の根本的な転換を意味する。旧世代のClaudeは「明示的に禁じなければやってしまう」という前提のもとに設定ファイルが組まれていた。しかしClaude 5世代は、コンテキストを読み、常識的な判断を自律的に下せる。つまり、過剰な明文化は「信頼の否定」になり、かえってモデルの推論を縛る。

この公表を受け、Qiitaではnogataka氏が「CLAUDE.mdをそろそろ見直す時期かも」と題する詳細な実践記事を公開（2026年9月5日）。同記事ははてなブックマークでも大きく拡散し、技術コミュニティで「今年最も実用的なCLAUDE.md論説」として評価されている。note上でもfine_duck830氏が「君のCLAUDE.mdはもう盛り過ぎ」（2026年9月6日）と題した記事を公開し、Claude 5時代に「通用しなくなった常識」として6つの誤解を整理した。こうした動向を横断的に見ると、2026年秋は日本語圏のAIコーディング実践者にとって「CLAUDE.md大改訂の転換点」として記録される可能性が高い。

「盛り過ぎ」の正体——旧世代CLAUDE.mdに蓄積された6つの負債

fine_duck830氏がnoteで指摘した「Claude 5世代で通用しなくなった常識」は、多くの実践者が経験的に感じていた問題を言語化したものとして広く共感を呼んだ。以下にその核心を整理する。

常識1「プロジェクト情報は全部CLAUDE.mdに書く」の崩壊。従来は「モデルへの情報提供は多ければ多いほどよい」という発想が支配的だった。しかしClaude 5は、リポジトリ構造そのものやファイル命名規則から多くの文脈を自律的に読み取れる。冗長な情報を詰め込むほど、モデルは「どの情報を優先すべきか」で迷い始める。

常識2「長いほどClaudeは正確に動く」の崩壊。100行を超えたCLAUDE.mdはしばしば自己矛盾を抱えている。「必ずXをせよ」と「YのときはXをするな」が同居し、その調停コストがモデルのトークン処理帯域を圧迫する。

常識3「例外と手順は常時読み込ませる」の崩壊。エッジケースの処理手順を逐一明文化することで、モデルは「書かれていない状況では判断停止」する傾向が旧世代では顕著だった。Claude 5ではこの傾向が激減しており、手順の全文記載はむしろ「思考の固定化」を招く。

常識4「会話の進捗もCLAUDE.mdに残す」の崩壊。メモリファイルとしての混用は、永続的な設定と一時的な状態情報を混在させ、セッションをまたいだ挙動の混乱を招く。状態管理は別ファイル（例：`MEMORY.md`）に分離すべきだ。

常識5「一つの長いセッションを使い続ける」の崩壊。コンテキストウィンドウを使い切ることを美徳とする発想は、Claude 5のエージェントモードにはそぐわない。小さく切ったタスクを複数のクリーンなセッションに分散させる方が、実行品質が安定する。

常識6「作業手順を一歩ずつ指定する」の崩壊。マイクロマネジメント型の指示書は、Claude 5の「目標から逆算して手順を組み立てる」能力を殺す。「何を達成すべきか」を明確にし、「どうやるか」の裁量をモデルに与えることで、実行精度が上がる。

【実態検証】7ステップで読み解くCLAUDE.md診断と削減の実践法

nogataka氏が提示した「既存CLAUDE.mdを見直す7ステップ」は、Qiitaコミュニティで最も実用的なフレームワークとして評価されている。以下に各ステップの核心を整理・補足する。

ステップ1：全行を「誰に向けて書いたか」で色分けする。旧世代のモデル向けに書いたルール（「絶対に〇〇するな」系）と、現在も有効な制約（「不可逆操作前の確認ゲート」）を視覚的に分離する。Claude 5ならば前者の大部分は不要だ。

ステップ2：禁止ルールの「なぜ」を書き出す。ルールの背後にある意図（例：「本番DBを誤って書き換えた経験があるため」）を明文化する。意図が自明であれば、Claude 5はルールなしに同じ判断を下せる可能性が高い。

ステップ3：手順の全文記載をスキル定義に置き換える。「Aをしてから、BをしてからCをする」という線形手順の全文は、`/skills/deploy.md`のような独立ファイルに切り出し、CLAUDE.mdからは「@skills/deployを参照せよ」と一行参照に凝縮する。

ステップ4：例示を削り「原則」だけを残す。「例えばこんなコードを書け」という具体例はほぼ不要になった。原則（「Rustの所有権モデルに沿ったコードを書け」など）だけを残すと、Claude 5は文脈から最適な実装を導出する。

ステップ5：矛盾するルール同士を突き合わせる。100行を超えたファイルには高確率でルール間の矛盾が潜む。GPT/ClaudeなどのLLMに「このCLAUDE.mdの矛盾箇所を列挙せよ」とレビューさせるのが効率的だ。

ステップ6：「絶対に削ってはいけない2項目」を確認する。nogataka氏が強調するのは、(a) 不可逆な操作の確認ゲート（DBのdrop、本番環境へのデプロイ前の人間レビュー要求）と、(b) リポジトリを見ても分からない罠（過去の経緯から来るプロジェクト固有の暗黙知）の2つだ。この2項目は削除禁止。

ステップ7：200行以内を目標に最終版を作成する。fine_duck830氏も「CLAUDE.mdを200行以内に」という具体的な目安を提示している。行数そのものが目的ではないが、それを意識することで「本当に必要な情報か」という問いが自然に生まれる。

【比較分析】CLAUDE.md旧世代vs.最適化版、そしてCursor Rulesとの違い

Claude 5世代に最適化されたCLAUDE.mdと、従来の「詰め込み型」CLAUDE.md、そしてVS Codeの競合ツールであるCursor Rulesとの構造的な差異を整理する。

Cursor RulesとCLAUDE.mdの本質的な違いは「前提とするモデルの自律性」にある。Cursorは現時点でも「明示的なルール遵守」をコアとした設計を維持しているのに対し、Claude 5以降の設計思想は「コンテキスト理解による自律判断」を前提に転換した。どちらが優れているかではなく、ツールの設計哲学に合わせた記述スタイルを使い分けることが重要だ。

【スキル定義とテンプレート例】プロジェクト種類別CLAUDE.mdの実践的な書き方

nogataka氏の記事が特に高く評価されているのは、「全体用1つ＋プロジェクト種類別6つのCLAUDE.md例」を実際のコードとして提示した点だ。ここでは、そのエッセンスを編集部独自の補足とともに整理する。

全体用CLAUDE.md（グローバル設定）の最小構成

全体用CLAUDE.mdはホームディレクトリ（`~/.claude/CLAUDE.md`）に置き、すべてのプロジェクトに共通する設定を記述する。Claude 5最適化版の最小構成例は以下の通りだ。

 ## Identity You are a senior software engineer. Prefer clarity over cleverness. ## Non-negotiables - Confirm before any irreversible operation (DROP TABLE, rm -rf, prod deploy). - Never commit secrets to version control. ## Memory files - Project state → MEMORY.md (do not write project state here) - Skill library → @skills/ ## Communication style - Japanese for prose, English for code identifiers. - Brief answers unless depth is explicitly requested. 

わずか15行。かつて100行以上詰め込んでいた設定と比べると拍子抜けするかもしれないが、これがClaude 5向けの「標識としてのCLAUDE.md」の理想形だ。

プロジェクト種類別テンプレート6選

①Webフロントエンド（React/Next.js系）：フレームワークバージョン・状態管理ライブラリ・スタイリング方針のみ記載。「コンポーネントはここに置く」という構造規約は、ディレクトリ構成から読み取れるため不要。

 # CLAUDE.md — Next.js 15 app ## Stack - Next.js 15 (App Router), TypeScript strict, Tailwind CSS - State: Zustand for client, React Query for server state ## Trap - /app/api/auth/ was hand-rolled before NextAuth existed. Do NOT refactor without checking SESSION_MIGRATION.md. 

②バックエンドAPI（Python/FastAPI系）：型ヒントの強制、非同期処理パターン、エラーハンドリング方針を原則として記載。DBスキーマへの参照は`@docs/schema.md`に委ねる。

③データサイエンス・分析系：注目すべきは「実験の再現性」に関する1行だけの制約。「乱数シードは必ずseedファイルから読むこと」という暗黙知だけが残せば十分で、Pandasの基本的な使い方を書く必要はまったくない。

④インフラ・IaC（Terraform/AWS CDK系）：このカテゴリだけは確認ゲートを多めに設定することが許容される。「本番環境へのapplyは必ず計画ファイルをSlackに共有してから」など、人間の介在ルールを明文化する。

⑤CLIツール・スクリプト系：「このスクリプトは冪等性を保つように」という原則1行で十分。エラー処理の詳細は`@skills/error-handling.md`に切り出す。

⑥OSS・ライブラリ開発系：コントリビューションガイドラインへの1行参照が核心。「CONTRIBUTING.mdを読んでからコードに触れ」という入口の標識だけを置く。

スキルファイルの定義方法——ワークフローの外部化

「スキル」とはClaude 5向けの新しい設計概念で、繰り返し実行されるワークフローを`/skills/`ディレクトリ以下の独立Markdownファイルとして定義し、CLAUDE.mdから参照させる構造だ。

 # /skills/test-and-commit.md ## Goal Run tests, fix failures, then commit with a conventional commit message. ## Steps 1. Run `pnpm test` and collect failing test names. 2. Fix each failing test. Do not modify test assertions unless clearly wrong. 3. Re-run until green, then `git add -p` (do NOT use `git add .`). 4. Commit using Conventional Commits format. ## Gate If any test touches /src/auth/, stop and ask before committing. 

CLAUDE.mdには`@skills/test-and-commit`と1行書くだけで、Claude 5はこの手順書を必要に応じて参照する。常時読み込ませる必要はない。これが「手順の常時読み込み」という旧常識を覆す「オンデマンド参照型スキル設計」の本質だ。

一般に知られていない盲点——「削ってはいけないもの」の見極め方

CLAUDE.mdのスリム化を推進する流れの中で、見落としがちな落とし穴がある。nogataka氏が特に警告しているのが「リポジトリを見ても分からない罠」の削除だ。

例えば「`/api/v1/users/bulk`は一見普通のエンドポイントに見えるが、内部ではレガシーな同期処理が走っており、並列呼び出しするとデッドロックを起こす」という情報は、コードをどれほど読み込んでも文脈から推測できない。こうした「歴史的経緯に由来する暗黙知」こそ、CLAUDE.mdに書き続けるべき核心的な情報だ。

一方で誤解されやすいのは「Lintの設定はESLintrcを見ればわかるからCLAUDE.mdに書かなくていい」という判断の基準だ。ファイルを参照すれば分かる情報はCLAUDE.mdに書く必要はないが、「なぜそのLintルールが存在するか」という背景（例：「2024年のインシデントで`any`型が原因のバグが発生したためno-explicit-anyを厳守している」）は、Claude 5が判断する際の重要な文脈になる。

整理すると、削除すべき情報と残すべき情報の判断軸は次の通りになる。

• ✅ 残す：不可逆操作の確認ゲート
• ✅ 残す：コードベースを読んでも分からない罠・歴史的経緯
• ✅ 残す：プロジェクト固有の命名規則で命名の意図が不明なもの
• ❌ 削る：「〇〇するな」系の禁止ルールで理由が自明なもの
• ❌ 削る：コードや既存ファイルから読み取れる手順・設定
• ❌ 削る：旧世代向けの「詳細な使い方の例示」
• ❌ 削る：会話の進捗・一時的な状態情報

【プロの結論】エージェントモード最適化の本質——「説明書」から「標識」へ

fine_duck830氏が提示した比喩が核心を突いている。「CLAUDE.mdは説明書ではなく標識へ。」道路標識は「この先カーブあり」と一言書いてある。運転手（Claude 5）は自分で速度を落とし、ハンドルを操作する。標識が「カーブを曲がる際は、まず速度を〇km/h以下に落とし、内側に寄り、アクセルは徐々に……」と書いてあったら、むしろ危ない。

Claude 5世代のエージェントモードを最大限に活用するためには、この設計哲学の転換が必須だ。「何を達成すべきか」「絶対に触れてはいけないゲートはどこか」「コードを読んでも分からない罠はどこか」——この3軸だけに絞ったCLAUDE.mdが、2026年以降の最高の設定ファイルになる。

Anthropicの公式推奨CLAUDE.md構成例も、まさにこの方向性に収束しつつある。システムプロンプトを80%削減しても性能が落ちなかったという実証データは、私たちのCLAUDE.mdにも同じ余白があることを示している。

【CLAUDE.mdをそろそろ見直す時期かも ── Claude 5世代向けの最適化手順・スキル・プロジェクト種類別の例】に関するよくある質問（FAQ）

Q1：CLAUDE.mdを削りすぎてClaude Codeの動きが悪くなった場合はどうすればよいですか？
A1：まず「削った内容のバックアップ」を別ファイル（例：`CLAUDE.old.md`）に残しておくことが基本です。動きが悪くなった場合は、削除した情報の中から「コードベースから読み取れない暗黙知」に相当するものを選んで再追加してください。「長さ」ではなく「情報の種類」が問題なので、やみくもに全文を戻さないことが重要です。

Q2：スキルファイル（/skills/*.md）はCLAUDE.mdとどう使い分けるべきですか？
A2：CLAUDE.mdは「常に有効な制約・原則・危険ゲート」を置く場所、スキルファイルは「特定のワークフローを実行するときだけ参照する手順書」です。「デプロイするときだけ読む手順」「テストを回すときだけ読む手順」など、発動条件が限定的なものはすべてスキルファイルに切り出してください。CLAUDE.mdへの記載は`@skills/ファイル名`の1行参照で十分です。

Q3：Cursor Rulesも使っている場合、CLAUDE.mdと設定が重複しても大丈夫ですか？
A3：設定の重複は原則として避けるべきです。「どのツールが主でどのツールが補助か」を先に決めてください。Claude Codeがメインエージェントであれば、CLAUDE.mdを正とし、Cursor Rulesには最小限の差分（UIの見た目設定など）だけを置く構成が安定します。同じプロジェクトで両方を同等に管理すると、アップデート時に乖離が生じて混乱の原因になります。

Q4：CLAUDE.mdの見直しはどのくらいの頻度で行うべきですか？
A4：Anthropicがメジャーモデルをリリースするタイミング（Claude 4→5への移行期など）が最大のトリガーです。それ以外では「CLAUDE.mdを読んだClaudeが明らかに意図と異なる動きをした」「新しいプロジェクトメンバーが読んでも意味を理解できないルールが増えた」「ファイルが100行を超えた」の3条件が見直しのサインです。

Q5：Claude 5以前のモデルを引き続き使う場合、旧世代向けCLAUDE.mdを維持すべきですか？
A5：はい、モデルのバージョンに合わせた設定は必要です。Claude 3系やClaude 4系を併用している場合は、`CLAUDE.opus5.md`と`CLAUDE.legacy.md`のように分けて管理し、使用するモデルに合わせて切り替えることを推奨します。Claude 5最適化版の「원則だけ」の設定を旧世代のモデルに使うと、意図しない挙動が増える可能性があります。

まとめ：2026年秋、CLAUDE.mdの大改訂が求められる根本的な理由

Anthropicが公式に実証した「システムプロンプト80%削減でも性能低下ゼロ」という事実は、私たちの設定ファイルへの問い直しを強く促している。旧世代向けに積み上げた禁止ルール・詳細手順・豊富な例示は、Claude 5の自律判断能力にとって「助けを借りなくても走れる人に無理に松葉杖を渡す」行為に等しい。

ただし繰り返すが、「全部削ればよい」という話ではない。不可逆な操作の確認ゲートと、コードベースから読み取れない歴史的な罠だけは、絶対に残す。それ以外の「とりあえず書いておいた」情報を削除し、繰り返しワークフローはスキルファイルに切り出し、全体用とプロジェクト別を分離する——この構造改革が、2026年秋のCLAUDE.md最適化の核心だ。

CLAUDE.mdの行数が100行を超えていたら、今すぐnogataka氏の7ステップ診断から始めることを強く勧める。あなたの設定が時代遅れかどうかは、すぐに分かるはずだ。Claude 5は「制約が少ないほど能力を発揮できる」——その設計思想に、私たちの指示書をいよいよ合わせる時期が来た。 （あわせて読みたい：前歯を削ると寿命が縮む？後悔の真相と失敗しない審美治療の境界線） （出典: claudemdをそろそろ見直す時期かも claude 5世代向けの最適化手順・スキル・プロジェクト種類別の例（Yahoo!ニュース））