少即是多的 CLAUDE.MD 撰寫原則

作者：@0xblacklight

文章：Writing a Good CLAUDE.MD

CLAUDE.MD 是很好的方式去注入專案相關資訊的方法，但是 Claude Code 為了 LLM 的回答表現考量，會在傳送內容時添加以下內容：

<system-reminder>
      IMPORTANT: this context may or may not be relevant to your tasks.
      You should not respond to this context unless it is highly relevant to your task.
</system-reminder>

也就是說，如果你的 CLAUDE.MD 包含太多針對少數情境的指令，反而會降低 Claude Code 去使用當中內容的機會，而且是整份設定都忽略，而不只是你新增的部分。

為當指令越多時，模型的表現下降 from 0xblacklight

所以最好只在 CLAUDE.MD 放整個專案（或子資料夾）通用的指令。

一般的原則：

• 前沿的大模型約在 150~200 個指令還運行正常，但 Claude Code 本身的 System Prompt 就包含 50 個指令；模型越小，能支援的指令數量會大幅下降。
• 小於 300 行
• 可以用提供其他檔案的方式，作漸進式的 Context 提供。（類似 Claude Skills 的作法）

#claude-code   #generative-ai