CLAUDE.md 檔案
Claude Code 中最實用的功能之一就是 CLAUDE.md 檔案。它能為 Claude Code 提供關於您專案的持久記憶。
它解決的問題
當您在沒有 CLAUDE.md 檔案的情況下開啟 Claude Code 時,它每次都會從頭開始。它必須重新探索您的程式碼庫,弄清楚需要哪些相依套件,並理解哪些功能已經實作。有時它會做出假設,這使得引導 Claude 朝正確方向前進變得更加困難。
CLAUDE.md 解決了這個問題。它是一個您加入專案根目錄的 Markdown 檔案,Claude Code 每次您開始新的工作階段時都會自動讀取它。可以把它想成是您程式碼庫的新人入職腳本。CLAUDE.md 檔案的內容會附加到您的提示中。
一個範例
以下是一個典型的 CLAUDE.md 檔案範例:
# Project
This is a Next.js 15 app using the App Router, Tailwind, and Drizzle ORM.
# Commands
- Dev server: `pnpm dev`
- Run tests: `pnpm test`
- Lint: `pnpm lint`
# Code Style
- Use 2-space indentation
- Prefer named exports
- All API routes go in app/api/
- Use server actions instead of API routes where possible這很簡單明瞭。現在如果您要求 Claude Code 建立一個 React 元件,它已經知道要使用 Tailwind 來設定樣式,並遵循您的程式碼規範。

CLAUDE.md 是為團隊設計的
您可以(也應該)將您的 CLAUDE.md 提交到版本控制系統,讓您的團隊也能從中受益。實際上,根據使用對象的不同,記憶檔案有一套層級結構:
-
專案層級的 CLAUDE.md 位於您專案的根目錄中。與團隊共享。
-
使用者層級的 CLAUDE.md 位於您的設定資料夾中。這個檔案僅供您個人使用,並適用於您的所有專案。將您的個人偏好設定放在這裡。
小技巧
將修正內容儲存到記憶中。 如果您發現自己一再修正 Claude——例如告訴它要一律使用 server actions 而不是 API routes——明確地要求 Claude 將該規則儲存到記憶中。下次您開啟專案時,它就會知道這項規則。

參照專案文件。 如果您的專案中有想讓 Claude 參照的文件,請使用 @ 符號加上檔案路徑:
## README.md
Please read if you need more info: @README.md先不建立檔案開始。 我們建議一開始先不建立 CLAUDE.md 檔案來進行專案,這樣您就能觀察自己經常需要糾正模型的地方。這能讓您的 CLAUDE.md 保持精簡,只聚焦於必要的資訊。當您準備好時,執行 /init 讓 Claude 為您產生一個檔案。
現在就試試看
選一個沒有 CLAUDE.md 的專案,然後執行 /init。閱讀 Claude 寫的內容,並刪除任何您不會費心告訴新同事的內容。新增一項您發現自己一直在重複糾正的事項,然後開始一個新的工作階段,並要求 Claude 做一件該修正會涉及的事情。Claude 有遵循嗎?
回顧
令人沮喪的 Claude Code 工作階段與高效的工作階段之間的差異,往往就在於上下文——而 CLAUDE.md 檔案正是您提供這種上下文的方式。從您的技術堆疊、偏好設定和指令開始,然後隨著您的使用逐步建立起來。