指揮 AI 工作台
Claude Code 入門
Terminal 看起來像工程師專屬,其實只是「用打字代替點滑鼠」。安裝加第一個指令只要 10 分鐘,會打字就會。這一站解鎖完整威力。
這一站解鎖
- 核心工作流:探索 → 計畫 → 執行 → 確認(不要一句話就讓它衝)
- CLAUDE.md:專案的長期記憶——把規矩寫成檔案,每次自動載入
- Context 管理:為什麼「一個對話塞所有事」會愈用愈笨
技能點詳解
每個技能點先給重點(讀這個就夠用);想深入的話,展開看完整說明與實作步驟。
Claude Code 是什麼、能幫你做什麼
Claude Code 是一個「會自己動手」的 AI 工作台,住在終端機裡。它跟聊天最大的差別是:它能直接讀你整個專案資料夾、自己跑指令、一次改好一整批檔案,做完還會回頭驗證對不對,不用你在中間複製貼上。它是聊天的升級版,也是 Cowork 的進階版。
- 它會動手,不只出一張嘴。聊天給你文字要你自己搬;Claude Code 直接讀檔案、改檔案、跑指令,整件事在你的專案裡做完。
- 它看得懂「整個專案」。你在哪個資料夾啟動它,它就能讀那個資料夾和底下所有子資料夾——適合維護一整個網站、整理一大批文件這種跨很多檔案的活。
- 它是一個 AI 代理(agent)。代理就是「會在一個循環裡自己想、自己做、自己檢查」的軟體,不是問一句答一句。
- 預設會先問過你才動手。要改檔案、要跑指令,它會先停下來等你點頭,主導權一直在你手上。
- 它會犯錯,你要留在迴圈裡。它可能誤會你的意思、寫錯、或想太多把事情做複雜——所以你要看著、驗收,別整包丟著不管。
深入研讀 · 實作步驟 收合
影片來源:Anthropic《Claude Code 101》· 在 YouTube 觀看原片
先把三個東西擺在一起比。聊天(就是你熟悉的 claude.ai 對話框)只能看到你貼進去的東西,它給你一段文字,搬回檔案的苦工是你的。上一站的 Cowork 前進了一大步——它能直接動你指定資料夾裡的檔案,介面還是聊天的樣子。Claude Code 則是把同樣的「會動手」能力,搬到一個更有力、給進階使用者的環境:終端機。它一次能掌握的檔案更多、能跑的指令更完整、也更能處理「一件事要動十幾個檔案、還要跑測試確認沒壞」這種真正複雜的工作。
它之所以能做到這些,是因為它是一個 AI 代理(agent)。這個詞聽起來很玄,其實意思很單純:一般的 AI 助理是「你問一句、它答一句」,代理則是「你交代一個目標,它自己在一個循環裡反覆地想、動手、再檢查,直到把目標達成」。過程中它會用到各種工具——讀檔案的工具、跑指令的工具、上網查資料的工具——就像一個員工手上有一整套工具箱,會自己判斷這一步該拿哪一件。
具體它能幫你做什麼?用台灣中小企業的場景講:讀懂並解釋——你接手一個前人留下的公司官網,可以叫它「解釋這個網站每個檔案在做什麼、首頁的價目表是哪個檔案在管」。跨檔案批次修改——「把全站的舊電話換成新的、順便把頁尾的年份改成今年」,它會找出每一個出現的地方一起改,不會漏。自己跑指令——它能執行你平常手動跑的那些流程(例如把網站重新產生一次、確認沒壞),再根據結果決定下一步。上網查——需要最新的資料或說明文件時,它會自己去查。
但要記住兩件事,你才用得安心。第一,它有一個叫 context window(脈絡視窗)的東西,可以想成它的「工作記憶」——很大,但不是無限,塞太多會變鈍(後面會專門講怎麼管)。第二,它會犯錯:可能誤會你的意圖、引進一個小毛病、或把簡單的事做得太複雜。這就是為什麼它預設「先問過你才動手」,也是為什麼你不能整包丟著走開。你的角色從「人肉搬運工」升級成「盯著看、做決定、驗收成果」的負責人。
實作步驟
- 認清「聊天/Cowork/Claude Code」各自的位置 要一段文字或問問題,用聊天;要它動一個資料夾裡的檔案又不想碰終端機,用 Cowork;要處理一整個專案、一次動很多檔案、還要跑指令驗證,就升級到 Claude Code。
- 記住那個關鍵動作:它會「讀→做→檢查」自己跑一圈 你交代的是目標(例如「把全站電話換成新號碼」),不是一步步的操作。它會自己去找、自己改、自己確認,這就是「代理」跟「聊天」的根本差別。
- 想一個你自己的「跨很多檔案」的痛點 維護官網、整理一批命名混亂的文件、把散在多份報表裡的數字對一遍——挑一個你現在要開很多檔、來回很多次的事,那就是 Claude Code 的主場,先記在心裡,後面幾個技能點會教你怎麼下手。
- 接受「你要留在迴圈裡」這件事 它很能幹但會犯錯。先建立一個心態:你不是把事情丟給它就走,而是看它的計畫、在它動手前把關、做完自己驗收。威力越大,越要盯。
常見踩雷
- 以為 Claude Code 跟聊天一樣「問一句答一句」——它的價值在會自己動手完成整件事,只拿它問問題就浪費了。
- 因為它住在終端機、看起來像工程師工具就不敢碰。它其實只是「打字代替點滑鼠」,會打中文交代事情就能用。
- 把它當永遠不會錯的機器,整包丟著不看。它會誤會、會出小毛病,你留在迴圈裡才抓得到。
深入來源:Claude Code 101・What is Claude Code?
安裝與第一個指令
安裝比你想的簡單:複製一行指令貼進終端機、登入你的 Claude 帳號,就裝好了。第一次用不用急著讓它衝——先學會用鍵盤在「每步都問我/自動改檔/只計畫不動手」三種監督層級之間切換,你就能一邊放心一邊上手。
- 終端機=用打字下指令的視窗。Mac 上叫「終端機(Terminal)」,就是個黑底打字畫面;你貼一行安裝指令進去按 Enter,它就會自己裝好。
- 你在哪個資料夾啟動,它就只看得到那裡。先切到你要處理的專案資料夾,再輸入
claude啟動——它的視野範圍就是這個資料夾和底下的東西。 - 三種監督層級用 Shift + Tab 切換。approval(每步都先問你)、auto-accept(自動改檔、但跑指令仍要問)、plan mode(只讀不動、先給你一份計畫)。
- 新手從「每步都問我」開始。先讓它每個動作都停下來等你點頭,熟了再視情況放寬,別一開始就全自動。
- 不只終端機一種入口。也能裝在 VS Code、JetBrains 或 Claude 桌面版裡;但新功能都最先上終端機,想用最完整的就從終端機開始。
深入研讀 · 實作步驟 收合
影片來源:Anthropic《Claude Code 101》· 在 YouTube 觀看原片
先破除門檻。終端機不是什麼神秘的工程師結界,它只是一個「你打字、電腦照做」的視窗——你平常用滑鼠點來點去做的事,在這裡改成打字交代。在 Mac 上,打開「應用程式 → 工具程式 → 終端機」就是它;Windows 則有 PowerShell 等對應的視窗。安裝 Claude Code 的官方做法,就是從官網複製一行安裝指令、貼進這個視窗、按 Enter,剩下的它自己完成。裝好之後,你在終端機輸入 claude 這個字就能啟動它;如果一開始沒反應,把終端機關掉重開通常就好。
啟動前有一個觀念一定要懂:你在哪個資料夾啟動 Claude Code,它就只能看到那個資料夾和底下所有子資料夾。這其實是保護你的機制——它碰不到你沒帶它進去的地方。所以標準動作是「先切換到你要處理的專案資料夾,再輸入 claude」。第一次啟動它會帶你做幾個設定:選個配色、用你的 Claude 帳號登入(Pro、Max 或公司的企業帳號都可以,公司有企業帳號記得選那個)。這些一次做完,之後就直接進工作。
真正的重點,是這三種監督層級——它決定「它動手前要不要先問你」,是你放不放心的關鍵旋鈕。用鍵盤的 Shift + Tab 就能循環切換:approval(審核模式,預設)——它每要改一個檔案、每要跑一個指令,都先停下來問你「可以嗎」,你點頭它才做,最穩、最適合新手。auto-accept(自動接受)——改檔案不再一個個問你、自動接受,但要「跑指令」這種影響更大的動作還是會停下來問;適合你已經信任它、想加快節奏時。plan mode(計畫模式)——它完全不動你的檔案,只用「唯讀」的方式讀你的專案、研究怎麼做,最後給你一份完整計畫;這是最安全的一檔,特別適合複雜任務或只想請它做個檢查。
給你一個實用的上手節奏:第一次用,就停在 approval 模式,讓它每一步都問過你,你會很清楚它想幹嘛、也隨時喊得停。等你跟它合作幾次、抓到它的脾氣了,再對那些你很有把握的重複小事切到 auto-accept 加速。而每次要交代「有點複雜、會動很多檔」的任務,養成先切 plan mode 的習慣——先看計畫、確認方向對了,再放它去執行。這個習慣是下一個技能點的核心,這裡先讓你的手熟悉 Shift + Tab 這個動作。
實作步驟
- 打開終端機 Mac:從「應用程式 → 工具程式 → 終端機」打開,或用 Spotlight 搜尋「終端機」。它就是一個黑底、可以打字的視窗,別怕。
- 貼上官方安裝指令、按 Enter 到 Claude Code 官方文件複製那一行安裝指令,貼進終端機按 Enter,等它自己裝完。裝好後輸入
claude沒反應的話,把終端機關掉重開再試。 - 先切到你的專案資料夾,再啟動 用
cd指令切換到你要處理的資料夾(例如你的官網資料夾),再輸入claude。記住:它只看得到你啟動時所在的這個資料夾。 - 完成第一次登入設定 第一次會請你選配色、用 Claude 帳號登入。公司若有企業(Enterprise)帳號,登入時記得選那個選項。
- 按 Shift + Tab 認識三種監督層級 啟動後按幾下 Shift + Tab,看畫面下方在 approval、auto-accept、plan mode 之間輪流切換。先停在 approval(每步都問我)。
- 下第一個安全的 prompt 別急著叫它改東西。先問它認識你的專案,例如:「請看一下這個資料夾,用中文跟我說每個檔案大概在做什麼。」感受一次「它自己讀完再回報」的流程。
常見踩雷
- 在錯的資料夾啟動它,結果它看不到你要處理的檔案。永遠先 cd 切到對的專案資料夾再輸入 claude。
- 一上手就切全自動、或直接跳過權限,然後被它自作主張嚇到。新手先待在 approval 模式,看清楚每一步。
- 被終端機的樣子勸退。它只是打字視窗,安裝就是貼一行、按 Enter,比裝很多手機 App 還簡單。
深入來源:Claude Code 101・Installing Claude Code
核心工作流:探索 → 計畫 → 執行 → 確認
這是整站最重要的一招。多數人一上來就叫 AI「動手寫」,結果方向錯了要一改再改。正確順序是四步:先讓它探索搞懂現況、再讓它計畫攤出打算怎麼做、你點頭後才執行、最後確認(自己驗收+請一個「新的眼睛」幫你複查)再定案。學會這一招,你用 AI 的成功率會整個翻上去。
- 順序就是威力:探索 → 計畫 → 執行 → 確認。把「想清楚」放在「動手」前面,省下後面一改再改的來回。
- 用 plan mode 一次做完前兩步。切到計畫模式,它只讀不動、把打算怎麼做攤給你看——這是最好的「事前踩煞車、改方向」的時機,因為還沒動到任何檔案。
- 先講清楚「怎樣算做對」。把成功的標準明講出來(例如「改完網站還能正常打開、電話全部是新號碼」),它才知道要做到什麼程度才算完成。
- 執行階段是一來一往,不是一鍵完成。它照計畫做、卡住時你補一句話拉回來;發現它一直卡同一個坑,就叫它把解法寫進 CLAUDE.md,下次別再犯。
- 定案前找「新的眼睛」複查。請它另開一個「子代理」用乾淨的腦袋審一遍你的改動——它不帶剛才做事的成見,更容易挑出問題。你自己也要親自驗收過再定案。
深入研讀 · 實作步驟 收合
影片來源:Anthropic《Claude Code 101》· 在 YouTube 觀看原片
先講為什麼要有這一招。大部分人拿到 AI 就是一句「幫我把某某功能做出來」,然後它就衝了——問題是它對你的專案理解可能是錯的、對「做成什麼樣才算好」的認知可能跟你差很遠,等它做完你才發現方向歪了,只好一輪一輪地改,時間反而花更多。探索 → 計畫 → 執行 → 確認這個流程,就是把「想清楚」硬性地擺到「動手」前面。如果這一站你只帶走一件事,帶走這個。
探索和計畫這前兩步,最省事的做法就是用上一個技能點學到的 plan mode(計畫模式)。在計畫模式裡,它不能改你任何檔案,只能讀——它會去讀相關的檔案、必要時上網查資料,搞懂現況之後,回給你一份「我打算這樣做」的計畫。舉個絲萬萬會遇到的例子:你想在公司官網上加一個「最新活動」的區塊,你切到 plan mode 然後說「我想在首頁加一個最新活動區塊,先幫我搞清楚首頁是哪個檔案在管、加這個東西要動到哪些地方、你打算怎麼做」。它讀完會告訴你計畫,甚至反問你幾個問題(活動要放幾則?要不要放圖?)。這一步是你最該花力氣的地方——因為此刻還沒動到任何一個檔案,你在這裡改方向的成本是零;一旦它開始動手,改起來就貴了。計畫看了不滿意,就指出哪裡不對、叫它重擬,直到對為止。
計畫對了,按核准(approve)放行,進入執行。這時你可以選它自動改檔、還是每步問你(就是上一個技能點的 auto-accept 對 approval)。要讓執行順利,有兩個訣竅特別有用:第一,把「怎樣算做對」講明白——它要有一個清楚的成功標準,才敢確定自己做完了;像「改完之後網站要能正常打開、每一頁的電話都是新號碼」這種驗收條件,寫進計畫裡最好。第二,給它可以自我檢查的工具——如果你的專案本來就有一套「檢查有沒有壞掉」的流程(工程上叫測試),讓它每做一步就拿去驗一次,它就能自己抓錯、少來煩你。執行不是一鍵完成、走開等結果,而是一來一往:它卡住時你補一句話把它拉回正軌。這裡有個好用的小撇步——如果你發現它一直在同一個地方犯同樣的錯,直接叫它「把這個解法記到 CLAUDE.md」,下次它就不會再踩同一個坑(CLAUDE.md 是下一個技能點的主角)。
最後是最容易被跳過、卻最值錢的一步:確認。這裡有一個很聰明的做法——在你把成果定案之前,請它另外開一個「子代理(subagent)」來複查你的改動。子代理你可以想成「請一位剛進來、沒參與剛才那場工作的同事」:它用一顆乾淨、沒有成見的腦袋重看一遍,而剛才親手做事的那個 AI,多少會對自己的成果有「這應該沒問題吧」的偏心,反而看不到自己的盲點。做程式的人會特別要求這個複查員只用唯讀工具——它的任務是挑毛病、不是自己動手改。複查沒問題、你自己也親手打開成果驗收過了,才請它幫你把這次改動存檔定案(commit)——commit 你可以理解成「拍一張存檔快照,替這次的成果寫一句說明、正式記一筆」,之後萬一想反悔,還回得去這個版本。做完一輪,就換下一件事,如此循環。
實作步驟
- 切到 plan mode,先叫它「探索+計畫」 按 Shift + Tab 切到
plan mode。交代任務時要它先搞懂現況、再攤出計畫,例如:「我想幫官網加一個最新活動區塊,先別動手,幫我查清楚要動哪些檔、你打算怎麼做。」 - 把計畫當草稿一起改到滿意 認真讀它的計畫,哪裡不對就明講、叫它重擬。這是改方向最便宜的時機——還沒動到任何檔案。順手把「怎樣算做對」的驗收標準補進去。
- 核准放行,進入執行 計畫 OK 就按 approve。新手先讓它每步問你(approval);熟了、有把握的部分再切 auto-accept 加速。
- 執行中一來一往,卡住就補一句 盯著它做。理解偏了、卡在某個坑,馬上補一句話拉回來。若它反覆犯同一個錯,叫它「把這個解法記到 CLAUDE.md」,一勞永逸。
- 定案前,請一個「子代理」用新的眼睛複查 交代它:「開一個子代理,用唯讀的方式幫我複查這次的改動,挑出可能的問題。」子代理沒有剛才做事的成見,更容易看出盲點。
- 自己驗收,再請它存檔定案 親自打開成果確認無誤,才請它「幫我用我的風格寫一句說明並存檔定案(commit)」。這一筆記錄讓你日後反悔還回得去。
幫公司官網把全站舊電話換成新號碼、順便更新頁尾年份
自己一頁頁開檔案、用尋找取代慢慢換,怕漏掉哪一頁、又怕改壞版面,改完還要一頁頁點開檢查,整個下午提心吊膽。
先用 plan mode 叫它找出全站哪些檔案有舊電話、列出計畫;核准後它一次改好、自己確認網站還能正常打開;再開子代理複查、你親自看過首頁,才請它存檔定案。全程沒有手動改過一個檔。
常見踩雷
- 一句話就叫它「直接做」,跳過探索和計畫——這是最常見的錯,換來的是後面一改再改。
- 計畫隨便掃一眼就核准。計畫階段是你唯一能零成本改方向的時機,值得多花五分鐘看仔細。
- 沒講清楚「怎樣算做對」。沒有驗收標準,它只能自己猜一個「完成」,往往跟你想的不一樣。
- 省略複查、自己也不驗收就定案。少了「新的眼睛」和你的親自把關,小毛病會一路帶到正式版。
深入來源:Claude Code 101・The explore → plan → code → commit workflow
Context 管理:為什麼一個對話塞太多會變笨
AI 有一塊「工作記憶」叫 context window(脈絡視窗),可以想成它的辦公桌面——很大,但不是無限。一個對話塞太多東西、什麼事都在同一個對話裡談,桌面就會亂到它抓不到重點、開始變鈍。學會用 /clear、/compact、/context 三個指令整理桌面,它就能一直保持清醒。
- context window=它的工作記憶/辦公桌面。你打的字、它讀的每個檔案、跑指令的結果,全都堆在這張桌面上,堆越多、可用空間越少。
- 塞太多會變笨、也會漏東西。快滿的時候它會自動「壓縮」——把舊內容摘要掉、丟掉一些細節來騰空間,過程中可能弄丟你在意的細節。
/clear=清空桌面重新開始。要換一件不相干的新任務時用,把上一件事的東西全清掉,免得舊脈絡來干擾新工作。/compact=整理桌面但留記憶。同一件事做到一半、桌面快滿又得繼續時用,它會把前面濃縮成摘要、保留重點、騰出空間。/context=看看桌面現在多滿。顯示目前用了多少、哪些東西占最多空間,讓你知道該不該清一清。
深入研讀 · 實作步驟 收合
影片來源:Anthropic《Claude Code 101》· 在 YouTube 觀看原片
先給你一個好記的比喻。AI 的 context window(脈絡視窗)就是它的辦公桌面,或說「一次能記在腦子裡的工作記憶」。你跟它講的每一句話、它為了做事讀進來的每一個檔案、它跑指令跑出來的每一段結果——全都攤在這張桌面上。桌面很大,能同時攤很多資料,但它終究有邊界,不是無限大。這件事為什麼你要管?因為桌面一旦堆到快滿,它就開始抓不到重點、回應變慢變鈍,甚至把你早先交代的關鍵細節給埋掉——這就是很多人說「怎麼聊到後來 AI 變笨了」的真正原因。
當桌面快滿,Claude Code 會自動做一件事叫壓縮(compaction):它會把前面的對話濃縮成摘要、把一些不再需要的指令結果丟掉,好把桌面清出空間繼續用。這是它的自保機制,但你要知道壓縮有代價——濃縮的過程可能把某個你其實還在意的細節一起摘掉。所以與其被動等它自動壓縮,不如你主動管理,讓桌面一直維持在「清爽、只放這件事需要的東西」的狀態。
你手上有三個指令可以主動整理桌面。/clear是「全部清空、從頭開始」——它把整張桌面掃乾淨,之前談的東西全部忘掉。時機是:你要開始一件全新的、跟剛才不相干的任務。比方你剛弄完官網的活動區塊,接下來要去整理一批報表,這兩件事毫無關係,這時 /clear 一下,別讓官網的脈絡跑來干擾報表的工作。/compact是「整理但保留記憶」——它把目前為止的內容濃縮成摘要、留住重點、騰出空間。時機是:你還在做同一件事、但桌面快滿了、又必須繼續,這時 /compact 讓你不用重講一遍前情就能接著做。/context則是「照鏡子」——它顯示桌面現在多滿、哪些東西占最多空間,讓你自己判斷該 compact、該 clear、還是還撐得住。
最後給幾個省桌面空間的實用習慣。第一,把話講具體:模糊的一句「幫我弄一下」看起來很短,其實更燒空間——因為它得自己去翻一大堆檔案、自己猜你要什麼,這些探索全都堆上桌面;反而一開始就講清楚,它直奔重點,桌面乾淨得多。第二,該記的事寫進 CLAUDE.md(下一個技能點):你希望它跨對話都記得的規矩,寫進檔案,就不必每次重講、也不必怕被 /clear 清掉。第三,善用子代理:像「我的網站設定檔在哪個資料夾」這種你只要一個答案的小事,丟給子代理去查,它用自己那張獨立的桌面做完、只把答案交回來,你主桌面依然清爽。
實作步驟
- 先養成用 /context 看桌面的習慣 覺得它開始變慢、變不精準時,先輸入
/context看一眼:現在多滿、什麼東西占空間最大。用數據判斷,別瞎猜。 - 換不相干的新任務時,先 /clear 上一件事做完、要開始一件全新的事,先
/clear清空桌面。這能避免舊脈絡污染新工作,也一次騰出最多空間。 - 同一件事做到一半快滿了,用 /compact 還在同一個任務、但桌面快滿又得繼續,輸入
/compact。它會濃縮前情、保留重點,你不用重講一遍就能接著做。 - 一開始就把話講具體 交代任務時把目標、對象、成品格式講清楚。具體的 prompt 讓它少繞路、少堆探索紀錄到桌面上——講清楚其實比講含糊更省空間。
- 只要答案的小事,交給子代理去查 像「某個設定在哪個檔案」這種你只需要結論的問題,叫它開子代理去找。子代理用自己的桌面做完、只回你答案,主桌面保持乾淨。
常見踩雷
- 一個對話從早聊到晚、什麼都往裡塞,然後怪 AI 越來越笨——其實是桌面爆了。該 clear 就 clear。
- 換了全新的任務卻不 clear,讓上一件事的脈絡跑來干擾判斷,做出來的東西帶著舊包袱。
- 用 /compact 或自動壓縮後就以為什麼都還在——壓縮會摘掉細節,真正重要、要跨對話留著的東西,寫進 CLAUDE.md 才保險。
深入來源:Claude Code 101・Context management
CLAUDE.md:專案的長期記憶
CLAUDE.md 是一個放在專案資料夾裡的純文字檔,Claude Code 每次啟動都會自動先讀它。你把「這個專案的規矩」寫進去一次——用什麼工具、怎麼命名、有哪些注意事項——以後它每次都自動記得,不用你每天重講。它是你剛學的 context 管理的完美搭檔:該長期記住的事,就放這裡。
- 它是專案的「新人手冊」,每次自動先讀。放在專案資料夾根目錄,Claude Code 一啟動就自動載入,內容等於自動接在你的 prompt 前面。
- 沒有它,它每次都從零重新摸索。沒有這份手冊,它每次都要重新猜你的專案怎麼運作、用什麼慣例,容易做錯方向。
- 放「規矩」,不放「這次的細節」。技術架構、常用指令、命名和風格慣例、固定注意事項——這些每次都適用的才寫進去;一次性的任務細節不要塞。
- 可以分「團隊版」和「個人版」。專案根目錄那份跟著專案走、給整個團隊共用;另有一份放你個人設定資料夾的,只屬於你、套用到你所有專案。
- 不用一開始就寫,用
/init讓它幫你生。先裸著用、把老是要糾正它的地方記下來,再叫它整理進 CLAUDE.md;這樣寫出來的手冊精簡又切中要害。
深入研讀 · 實作步驟 收合
影片來源:Anthropic《Claude Code 101》· 在 YouTube 觀看原片
先講它解決什麼痛。沒有 CLAUDE.md 的時候,你每次打開 Claude Code,它都是一張白紙——它得重新去摸索你這個專案是怎麼組起來的、用了哪些東西、哪些功能已經做過了。摸索的過程它會自己做一堆假設,假設錯了你就得一路糾正,很累。CLAUDE.md 就是來補這個洞的:它是一個放在你專案資料夾根目錄的純文字檔(副檔名 .md 是一種很好寫的純文字格式),Claude Code 每次啟動都會自動把它讀進去。你可以把它想成「這個專案的新人上工手冊」——一個新同事報到,你會先給他一份說明公司怎麼運作的文件,CLAUDE.md 就是給 AI 的那份。
那手冊裡該寫什麼?寫「每次都適用的規矩」。官方的範例長這樣:先寫這個專案是什麼(例如「這是一個公司官網,用某某工具搭的」);再寫常用指令(例如「要預覽網站跑哪個指令、要重新產生跑哪個」);再寫風格和慣例(例如「檔名一律用小寫、日期格式用哪一種、頁尾一定要放公司電話」)。重點是這些都是「不管這次做什麼事都成立」的東西。反過來,這次任務才有的一次性細節(例如「這篇活動貼文限 150 字」)就不要寫進去——那種話當下講給它聽就好,塞進手冊只會把它撐肥、失焦。
這份手冊還分兩種,別搞混。專案版放在專案資料夾根目錄,它會跟著這個專案走,而且你該把它一起交給團隊共用——這樣不只你,全公司用這個專案的人,開 Claude Code 都自動吃到同一套規矩,大家的產出就一致。個人版則放在你自己的設定資料夾裡,只屬於你、而且套用到你電腦上所有專案——把你個人的偏好(例如「回答我一律用繁體中文」)寫這裡最合適。一個負責維護官網的絲萬萬同事,就可以在官網專案的 CLAUDE.md 寫死「電話一律用新號碼、頁尾年份每年初提醒我更新」,往後它每次動這個網站都自動遵守。
最後是最實用的一條心法:不要一開始就埋頭寫一大份 CLAUDE.md。官方的建議反而是——先裸著用(不放手冊),在實際做事的過程中,留意「哪些地方我老是要重複糾正它」(例如它每次都把日期寫成美式格式、你每次都得改回來)。這些「你一再糾正的點」,正是最該寫進手冊的東西。累積幾條之後,你甚至可以直接下 /init 這個指令,讓 Claude Code 自己看過你的專案、幫你生一份初版 CLAUDE.md,你再微調。這樣長出來的手冊,精簡、只放真正必要的資訊,而不是一堆它其實用不到的贅字——這也呼應你上一個技能點學到的:桌面空間寶貴,手冊也要乾淨。
實作步驟
- 先裸著用幾次,記下你老是要糾正的點 別急著寫手冊。先正常用 Claude Code 做幾件事,隨手記下「它每次都做錯、我每次都要糾正」的地方——那些就是手冊該收的內容。
- 在專案根目錄建立 CLAUDE.md 在你的專案資料夾最外層,建立一個名為
CLAUDE.md的純文字檔。它一啟動就會自動讀這個檔。 - 寫三段:這專案是什麼、常用指令、慣例 用最白話的話分三段寫:專案是什麼、常用指令(怎麼預覽、怎麼產生)、命名和風格慣例(含你剛才記下的那些糾正點)。只放「每次都適用」的規矩。
- 把「這次一次性的細節」留在對話裡,別寫進去 手冊要精簡。一次性的任務要求(這篇字數、這批檔案的特例)當下講給它就好,不要塞進 CLAUDE.md 把它撐肥。
- 嫌從零寫麻煩,就用 /init 讓它生一份 直接輸入
/init,讓 Claude Code 看過你的專案、自動生一份初版 CLAUDE.md,你再依實際情況增刪。 - 團隊共用就交出去、個人偏好放個人版 希望全團隊一致,就把專案版 CLAUDE.md 跟專案一起交給同事;只屬於你自己的偏好(例如一律用繁中回答),寫到個人設定資料夾那份。
常見踩雷
- 一開始就寫一份包山包海的巨型 CLAUDE.md,塞一堆它用不到的東西——又肥又失焦,還占桌面空間。先裸用、再從糾正點長出來。
- 把「這次才有的一次性細節」寫進手冊,害它每次都被過期的指示綁住。那種話當下講就好。
- 發現自己一再糾正同一件事,卻懶得寫進 CLAUDE.md——等於每天重踩同一個坑。糾正超過兩次就該寫進去。
深入來源:Claude Code 101・The CLAUDE.md file
為自己的一個資料夾建立 CLAUDE.md,用「先計畫再執行」的方式完成一項多步驟任務。