CLAUDE.md 寫太長了？Anthropic 自己砍掉八成

結果先講：寫 Claude Code 的那個團隊，把 Claude Code 自己的系統提示刪掉了超過八成。

動手的是 Anthropic 技術成員 Thariq Shihipar，他在 2026 年 7 月 24 日——Claude Opus 5 上線的同一天——把這件事寫成一篇公開發文。原文是這樣寫的：「We removed over 80% of Claude Code’s system prompt for models like Claude Opus 5 and Claude Fable 5 with no measurable loss on our coding evaluations.」砍掉八成，官方稱自家的 coding 評測分數沒有可測量的退步。

然後他把過去三年大家被教的做法，逐條反過來寫了一遍。

官方自承的那句話比八成更重要：over-constraining

八成是結果，原因寫在發文裡：團隊說他們先前「were overconstraining Claude Code, both through our system prompt and in our CLAUDE.md files and skills」——過度約束，而且三個地方都有：系統提示、CLAUDE.md、skills。

為什麼會過度約束？因為那些規則當初是有用的。你寫「不要產生多段式的 docstring」，是因為舊模型真的會失手寫出一大坨。這種明列的禁令是給舊模型行為設的護欄，一條一條補上去，補了兩年。

模型換代之後，護欄還在原地，但擋的東西已經不在了。發文給的新寫法是把禁令換成一句描述性的標準：「Write code that reads like the surrounding code: match its comment density, naming, and idiom.」——寫得跟旁邊的程式碼一樣就好，註解密度、命名、慣用寫法都對齊。一句話取代一串禁令，剩下的交給模型自己判斷。

六組反轉，對到你手上的哪個檔案

發文用六組 Then／Now 把改動列完。左邊兩欄是官方原文的說法，右邊那欄是接到你實際會打開的檔案：

官方說的 Then	官方說的 Now	你手上對應的東西
給 Claude 規則	讓 Claude 自己判斷	CLAUDE.md 裡那串「不准…」「一律要…」的條列，改寫成一句描述性標準
給 Claude 範例	設計介面	工具的用法範例可以拿掉，改成把參數名稱、列舉值設計得夠清楚
全部先塞好	漸進揭露	長篇說明從系統提示搬進 skills，用到才載入
重複交代	精簡的工具描述	同一條指示不要在系統提示和工具描述各寫一遍，只留在工具描述
記憶寫在 CLAUDE.md	自動記憶	手動記錄的偏好交給自動記憶，別再往檔案裡塞
簡單規格	豐富參照	用測試套件、程式碼樣本、評分標準當規格，比用文字描述準

第三欄的動作幅度由你決定——官方沒有給「幾行以下才合格」這種門檻，我們也沒有實測過砍到什麼程度會出事。

工具那一層的做法發文講得最具體：「Some of our tools are ‘deferred loading,’ which means the agent must search for their full definitions using ToolSearch before using them.」工具定義不再全部攤在上下文裡，agent 要用之前先自己搜。skills 的定位也被下修了——官方說法是「lightweight guides」，讓 Claude 需要時去找資訊，除非是高度重要的領域，否則不要寫得太死。

CLAUDE.md 現在只該留一種東西：坑

這是整篇最能直接執行的一句。官方原文：「Keep your CLAUDE.md lightweight and briefly describe what your repo is for, but spend most of the tokens on gotchas inside of the codebase.」

repo 是幹嘛的，簡短交代一下就好；大部分篇幅要花在 codebase 裡的坑。

判準因此很清楚：模型自己讀 codebase 就能學會的，刪掉；它讀了也不會知道的，留下。 命名慣例、目錄結構、這個專案偏好哪種寫法——它讀幾個檔案就看得出來。哪個看起來沒用的環境變數其實在部署時會被讀、哪個測試在 CI 上會 flaky、哪個函式改了會連動到一個沒有測試覆蓋的地方——這些它讀不出來，這些才是要寫的。

順帶一提，記憶那一組的改動意味著 CLAUDE.md 不用再兼差當備忘錄。官方說 Claude 現在會自動存下跟工作、跟你有關的記憶。

這些功能早就出貨了，發文只是補說明書

把 Claude Code 的官方 CHANGELOG 抓下來對版本號，會看到發文講的東西大多已經在版本裡跑了一段時間。這篇發文的作用比較接近補上使用說明：

1. 2.1.59 — 「Claude automatically saves useful context to auto-memory. Manage with /memory」，自動記憶上線。
2. 2.1.74 — 新增 autoMemoryDirectory，可以自訂自動記憶存放位置。
3. 2.1.206 — 「Added a /doctor check that proposes trimming checked-in CLAUDE.md files by cutting content Claude could derive from the codebase」，也就是發文最後推薦的那個入口。
4. 2.1.219 — Claude Opus 5 成為預設 Opus 模型，1M 上下文窗口。
5. 2.1.220 — 截至 2026 年 7 月 26 日的最新版。

這對你有個實際意義：/doctor 那個修剪檢查是在 2.1.206 進去的。你手上如果停在更早的版本，跑 /doctor 是不會看到 CLAUDE.md 修剪建議的，先更新再說。

要注意官方的措辭是 proposes——它提建議，刪不刪還是你按的。

這篇能信到哪裡？

邊界一次講完。八成和「沒有可測量的退步」都是 Anthropic 自報、自評，對照的是他們自己的 coding evaluations，題目沒公開、分數沒公開、也還沒有第三方複現；供應商建議你少寫一點 token，本身也不是完全中立的位置。發文明確限定在 Claude 5 世代模型（Opus 5、Fable 5），你在 GPT-5.6、Gemini 3.6 或開源權重模型上照著砍，沒有任何依據說結果會一樣。而我們這邊做的事只有兩件：把發文全文讀完、把 CHANGELOG 全檔抓下來對版本號——沒有把哪個專案的 CLAUDE.md 砍掉八成再跑一輪 eval。

還有一件事得說清楚：本站 6 月 19 日那兩堂課教的，正是「把專案慣例寫進 CLAUDE.md、把任務講成規格」的那套寫法。那些規則在 Claude 4 世代擋住了真實會發生的失手，現在擋住的變成模型自己的判斷力——護欄的位置沒動，模型長高了。

今晚可以做的兩件事

第一，claude doctor 或在 Claude Code 裡跑 /doctor，看它對你的 CLAUDE.md 和 skills 提什麼修剪建議——先看，不用照單全收。

第二，打開 CLAUDE.md，對每一條問一句：這件事它自己讀 codebase 會不會知道？會，就是候選刪除項；不會，那就是這份檔案存在的理由。