Claude Code 專案資料夾怎麼放?我的整理法
文 / Coolkid發布：2026-08-02閱讀約 7 分鐘
摘要
短答給趕時間的人:你在哪個資料夾打開 Claude Code,那裡就是它的辦公桌 — 它預設看得到、改得動的就是那一圈,CLAUDE.md 規則書也是認資料夾的。所以資料夾怎麼放不是潔癖,是直接決定 AI 好不好用。三個原則:一專案一資料夾(各自帶一份 CLAUDE.md)、路徑用英文命名(中文路徑在 Windows 上有亂碼雷)、會重複用的工具集中放一個資源庫資料夾(動手前先查,不重造)。
我剛開始的時候什麼都丟桌面:網站一夾、機器人的程式跟測試檔散在外面、還有幾個中文命名的資料夾。後果是 AI 常讀到不相干的東西、我叫它改 A 它順手動到 B,還踩過中文路徑的亂碼雷。三個月下來電腦上專案數長到兩位數,現在的結構是被雷出來的 — 這篇講我實際怎麼放、為什麼這樣放、以及你什麼訊號出現才需要整理。
AI 的視野=你開它的那個資料夾
先建立一個觀念:Claude Code 是「開在某個資料夾裡」的 — 你在哪裡打開它,那個資料夾就是它的工作範圍,預設讀寫都在裡面,超出範圍的動作會特別問你。連規則書都認位置:全域的 CLAUDE.md 管你這個人,專案資料夾裡的那份只在這個專案生效(寫法見 CLAUDE.md 那篇)。
白話比喻:請師傅來家裡,你帶他進哪個房間,他就整理哪個房間 — 範圍清楚,他效率高、你放心。反過來,把整棟房子都開放給他,他光搞清楚狀況就耗掉半天,還可能動到你沒想讓他碰的東西。「全部丟桌面同一層」就是後者。
我的三個原則(附真實結構)
| 原則 | 為什麼 | 沒做會怎樣(我踩過) |
|---|---|---|
| 一專案一資料夾 | 範圍清楚,各帶各的 CLAUDE.md | 叫它改 A 專案,它順手動到旁邊的 B |
| 路徑用英文命名 | Windows 中文路徑偶爾觸發編碼問題 | 工具直接找不到檔案、輸出變亂碼 |
| 共用工具集中一個資源庫 | 先查再造,不重複發明 | 同一支爬蟲做了兩次才發現以前寫過 |
我的實際結構(簡化版):桌面上一個 brand 資料夾裝品牌與網站相關的專案,底下每個專案一個子資料夾、各有自己的 CLAUDE.md;自動化機器人各自獨立一夾,排程各自設;另外有一個資源庫資料夾,集中放會重複用的工具(爬蟲、掃描器這類)。配套的一條規則寫在我的全域 CLAUDE.md:「動手寫新工具前,先查資源庫有沒有現成的」— 三個月下來,這條規則省下的時間比任何技巧都多,因為很多東西以前的自己已經做過了。
英文命名補充一句:給「人」看的內容(文章、筆記的內文)當然用中文;要英文的是「路徑」— 資料夾名、檔名。中文路徑大多數時候沒事,但踩到的那一次很難查(亂碼篇的雷),英文命名等於直接把這整類問題關掉。
專案資料夾裡面長什麼樣
跨進資料夾內部,我固定留三塊。第一塊是進度檔:路線圖、斷點紀錄、決策紀錄 — 專案一大、對話一多,靠這些檔案跨對話接關(context 那篇的第 3 招),我每個長專案都有這一區。
第二塊是把暫存跟正式產出分開:實驗性的草稿、跑一次就丟的腳本,集中丟一個暫存資料夾定期清,不跟正式檔案混住 — 混住的下場是 AI 引用到過期的草稿版本。第三塊是機密不落地:API 金鑰這類東西不用明文放在專案資料夾裡的檔案(登入篇的「三不」),不然哪天你把整個資料夾分享給別人或公開上網,金鑰就跟著出去了。
新手第一步:不用重整,從下一個專案開始
先講重要的:別急著把現有的東西全部搬家。搬資料夾會弄斷既有專案裡寫死的路徑,為了整齊把能跑的東西弄壞,不划算。正確起手式是從下一個新專案開始套:建一個英文命名的資料夾 → 寫三行 CLAUDE.md → 以後都在這個資料夾裡開 Claude Code。就這樣,一個專案養成一個習慣。
至於現有的要不要整理,看訊號:AI 常讀錯檔案、你叫它改這個它動到那個、或你自己都要找很久 — 出現任何一個,值得花半小時整理(可以叫 Claude Code 自己提搬家計畫,先看計畫再動手)。什麼訊號都沒有?那就先不動 — 結構是為了做事,不是為了好看。
Claude Code 開在哪個資料夾,那裡就是它的視野與工作範圍,CLAUDE.md 也認資料夾生效 — 所以資料夾結構直接決定 AI 好不好用。三個原則:一專案一資料夾(範圍清楚、各帶規則書,避免改 A 動到 B)、路徑英文命名(關掉 Windows 中文路徑的亂碼雷)、共用工具集中資源庫+「動手前先查」規則(不重複發明,我省最多時間的一條)。資料夾內固定三塊:進度檔(路線圖/斷點/決策,跨對話接關)、暫存與正式分開、機密不落地。新手別急著重整現有專案(搬家會弄斷路徑),從下一個新專案開始套;AI 常讀錯檔、改錯專案、自己找很久才是該整理的訊號。
名詞解釋
- Claude Code
- Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- 編碼（encoding）
- 電腦儲存文字的方式。Windows 中文環境常用 Big5，多數程式假設 UTF-8，兩邊對不上就變亂碼 — 所以資料夾、檔案建議用英文命名。
- API 金鑰（API key）
- 服務發給你的一串密碼，程式用它證明「我有權限使用這個服務」。絕對不能公開、不能寫死在程式碼裡。
- 機器人（bot）
- 自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- context（上下文視窗）
- AI 一次能「記在腦中」的內容上限，包含你說的話、它讀的檔案跟對話紀錄。塞滿了就會忘掉前面的事，這就是長對話後 AI 開始恍神的原因。
如果內容對你有用就太好了
隨喜斗內
▸ 常見問題
Claude Code 應該在哪個資料夾打開?
在你要做事的那個專案資料夾裡開。它的預設視野、讀寫範圍、還有專案層的 CLAUDE.md 規則,全都認你開它的位置 — 在對的資料夾開,它讀對檔案、守對規矩;在隨便的位置開,這些全變浮動。一專案一資料夾,就是為了讓「開在哪」永遠有明確答案。
資料夾跟檔案可以用中文命名嗎?
內容裡的中文完全沒問題;建議改英文的是「路徑」— 資料夾名與檔名。Windows 上中文路徑大多數時候能用,但部分工具鏈會踩編碼雷:找不到檔案、輸出亂碼(詳見中文亂碼那篇),而且踩到時很難查。英文命名等於把這一整類問題直接關掉,成本只是取名時多想兩秒。
Claude Code 可以讀寫專案資料夾以外的檔案嗎?
可以,但超出工作範圍的動作預設會先問你 — 這是權限機制在把關。實務建議把「範圍」當第一道安全鎖:專案內的動作放它做,跨到外面的自己按確認。這也是一專案一資料夾的另一個好處:範圍清楚,哪些該問、哪些不用,一目了然。
好幾個小專案放同一個資料夾可以嗎?
起步期可以,東西少的時候混住成本低。該分家的訊號是「規則開始打架」:A 專案要的規矩 B 不適用、CLAUDE.md 越寫越像例外清單、或 AI 常把兩個專案的檔案搞混 — 出現就拆,一專案一夾各帶各的規則書,拆完這些問題直接消失。
看完這篇之前先確認:
- 檔案散到自己都找不到,AI 也常讀錯的人
- 想知道 Claude Code 到底該在哪個資料夾打開的人
- 同時養好幾個專案(網站/機器人/爬蟲)的人
- 只有一個小專案、目前一切都順的人 (不用為整理而整理)
- 想找團隊級的程式碼倉庫規範 (本篇是個人單機向)
- 還沒開始第一個專案 (先看新手村那篇)
- 全部檔案丟桌面同一層 — AI 掃描慢,還可能改錯東西
- 資料夾用中文命名 — 部分工具會亂碼或找不到路徑
- 每次在隨便的位置開 Claude Code — 它看得到什麼全變浮動