前言
剛裝好 Claude Code 的新手最常做的事，是直接開一個專案就開始打字。它不是問一句答一句的聊天機器人，比較接近一個剛加入團隊的工程師：規則講清楚才會照做，沒講就自己猜。這篇整理 10 個技巧，從開專案前的設定、下指令的日常習慣，到四種權限模式怎麼選，一次講完。
開專案之前，先把這 4 個 Claude Code 設定弄好
這幾件事是開專案前就該先弄懂、先做好的事，能省下不少麻煩，也能避免不少錯誤。
1. CLAUDE.md 怎麼寫
/init 指令會在專案根目錄生一份 CLAUDE.md，之後每次啟動都會自動讀進去。剛生成的版本通常只有這個專案用什麼工具做的、常見指令這些讀程式碼就看得出來的東西，真正該手動補的是規則和個人偏好，像是：
- 對話請稱呼我「○○」，全程用繁體中文回覆
- 改動超過 3 個檔案要先說明會動哪些、等我確認才能動手
- 修改完成後簡短講一下改了什麼，不用長篇報告
以上是幾個規則範例。新手常犯的錯是把整份技術文件或 README 整包塞進去，覺得資訊越多越好，實際上剛好相反：內容太肥反而會被忽略，重要規則被淹沒在一堆它自己就查得到的東西裡，官方文件建議控制在 200 行以內。這份文件也不是寫一次就結束，每次跑完一個 session 學到什麼新的專案慣例，回頭花一分鐘補進去，下次它就不會再犯同樣的錯。分析 401 個開源專案規則檔的研究也發現，這類檔案的效果不只看寫得準不準，還要看給的背景範圍夠不夠精準，專案的目標、架構、協作規範才是真正影響回應品質的關鍵（Jiang & Nam, 2025）。
2. 常用安全指令設允許清單
權限設定新手常卡在兩個極端：預設每個動作都要點確認，開個瀏覽器查資料都要按一次；另一種是乾脆全部放行，結果哪天不小心把重要檔案刪掉都不會發現。比較實際的做法是用白話先講清楚界線：「不要刪除檔案」「動到正式環境或資料庫前一定要先問我」這種有風險的動作，直接講讓它記住；「自動開瀏覽器查資料」「讀取檔案」這類本來就不會出事的動作，可以放行讓它不用每次都問。
3. 例行性的操作用 Hooks 處理
CLAUDE.md 寫的規則比較像是「建議」，Claude Code 讀了會盡量照做，但真正想鎖死某個行為，要用 Hooks。Hooks 會在特定時機點自動觸發、跑一段你指定的動作，屬於一定會執行，不是盡量遵守。例行性、每次都要做的操作適合交給 Hooks 處理，像是「每次它改完程式碼，自動跑一次檢查工具」，或是「工作做完自動播放提示音，不用一直盯著螢幕等結果」，這種重複性高的小動作設一次，之後就不用每次都提醒它。設定 Hooks 不需要自己去改設定檔，跟平常下指令一樣：
- 把時機和動作講清楚，例如「檔案存檔之後，自動跑一次檢查工具」
- 直接請 Claude Code 幫你把這個規則設定好，它會自己處理技術細節
- 設定完成後，打
/hooks就能確認有沒有生效
4. 敏感資料別貼進對話框
身分證字號、信用卡卡號、還沒公開的財報這類敏感資料，不要直接貼進對話框，判斷標準是這段資訊萬一外流會不會惹麻煩，會的話就先遮掉再貼。同樣的道理也適用於 API 金鑰，原始金鑰不要貼進對話，改存在環境變數，需要的時候讓它讀環境變數就好。
📖 延伸閱讀：2026 Claude Code 新手教學｜從安裝到 GitHub 部署
用 Claude Code 該養成的 5 個下指令習慣
設定做完之後，接下來是每天實際在用時該養成的幾個習慣。
5. 提示詞要有檔案名、行號、錯誤訊息
新手最常犯的動作，是把 Claude Code 當成搜尋框在用：丟一句「幫我修登入頁的錯誤」，然後等結果。這句話沒有檔案名、沒有錯誤訊息、也沒有期待的行為，它只能自己猜是哪個檔案、猜錯誤是什麼。提示詞寫得越具體，它花在猜測上的力氣就越少。
比較有效的做法是先把終端機整段錯誤訊息複製下來貼在最前面，再說要改哪個檔案、預期應該長怎樣。長篇資料放在問題前面而不是問完才補，這個順序會影響它抓重點的準確度，來回猜測的空轉會少很多。分析真實開發者對話紀錄的研究也證實，用結構化的提示寫法取代隨口丟一句模糊問題，能用更少的來回次數拿到堪用的結果（DiCuffa et al., 2025）。
用文字形容想要的格式或語氣也常常詞不達意，直接給 3 到 5 個範例，比堆形容詞準得多。畫面上的問題，直接截圖貼進對話框，比用文字描述「按鈕跑版了」「顏色怪怪的」準確得多，它看得到實際畫面，比猜你講的哪裡有問題快很多。
6. 用 @路徑 直接引用檔案
知道要改哪個檔案的時候，直接打 @ 加上檔案路徑，它會馬上把那份檔案讀進來，比讓它自己滿專案搜尋快得多。很多新手不知道有這個語法，習慣用文字描述「那個處理登入的檔案」，讓它自己猜半天，一個 @ 符號就解決了。不想記語法的話，直接把資料夾、圖片或檔案拖進對話框也可以，效果一樣，是更直覺的做法。
7. 一次只執行一個任務
一次塞好幾個不相關的任務，例如「順便把登入頁改好、資料庫也調一下、深色模式也加上」，通常只會換來一個做一半的結果。拆成一次一個功能、確認完再進下一步，反而比較快，也比較好抓出哪一步出了問題。
8. 話題一換就開新對話
上下文窗口不是儲存空間，是它現在正在用的工作環境；塞太多不相關的東西進去，品質會跟著往下掉。不滿意某次回覆時，也別一直往下追加「不對，我是要⋯⋯」，改用編輯功能修改前一則訊息重送，或是用 /clear 直接清乾淨重新開始，比讓它背著一長串失敗歷史繼續猜要快。
9. 別自己動手修
發現它把東西改壞的時候，別自己默默手動修完就算了，讓它自己回頭查出問題出在哪、把發現寫進 CLAUDE.md 或相關文件。手動修好的那次只是治標，同樣的錯下次還是會再犯一次，寫進文件才是能持久化的修正。
📖 延伸閱讀：AI 提示詞怎麼寫？
這 10 個技巧其實都在講同一件事：先把規則和邊界定義清楚，工具才幫得上忙。同樣的邏輯放到團隊每天在跑的流程上也成立。
Claude Code 四種權限模式 (permission mode) 差在哪，什麼情境用哪個
10. 權限模式怎麼選
按 Shift+Tab 可以在幾種模式之間切換，決定 Claude Code 做事之前要不要先問過你。官方文件列出的完整模式有六種，新手實際會用到的是這四種：
/clear 清掉整串上下文重新開始；② 終端機最下面這行就是目前的權限模式，按 Shift+Tab 循環切換| 模式 | 免確認範圍 | 適合情境 |
|---|---|---|
| Manual（預設） | 只有讀取 | 剛開始用、處理敏感內容 |
| Accept Edits | 讀取、檔案編輯、常見檔案指令 | 邊看修改內容邊確認的開發階段 |
| Plan Mode | 讀取，不能真的動檔案 | 動手前先探索、牽動多檔案的複雜任務 |
| Auto | 幾乎全部，背景分類器把關 | 長任務、減少反覆被打斷 |
Manual 就是每個動作都要點確認的預設狀態，剛裝好第一天用這個最安全。Accept Edits 讓它自動編輯檔案不用逐次確認，改動完自己看一輪改了哪些地方，適合已經抓到節奏、想邊審邊改的階段。Plan Mode 是唯讀沙箱，能讀遍專案、提出一份完整計畫，但在你點頭之前一個檔案都不會動，牽動多個檔案、或是自己都還沒想清楚該怎麼改的任務，先用這個看過一輪計畫，比較容易在寫進磁碟之前就發現方向錯了，等它已經動手改了一半才發現不對，回頭收拾的時間往往比先看計畫多花的那五分鐘還久。Auto Mode 是自動化程度最高的協作模式，一個分類器模型會在背景審查每個動作，攔下明顯超出範圍或有風險的操作，其餘的都不會再跳出來問，長任務用這個能明顯減少被打斷的次數，但分類器不是萬無一失，真正敏感的操作還是自己留意一下比較好。
常見問題 FAQ
Q1：Claude Code 新手一定要先讀完官方文件才能開始用嗎？
不用。可以先動手用，遇到卡住的地方（像是權限一直跳出來問、CLAUDE.md 不知道該寫什麼）再回頭查對應章節就好。這篇整理的 10 個技巧涵蓋了新手最常卡住的幾個地方，先看過這篇再上手，會比從頭讀完整份文件快很多。
Q2：CLAUDE.md 沒有 200 行會怎樣，一定要壓到這個數字嗎？
200 行是一個經驗值，不是硬性規定。真正的重點是放規則、個人偏好設定，不是整份文件的複製貼上。內容本來就精簡、天生用不到 200 行完全沒問題，反過來硬湊到 200 行塞一堆廢話也沒有意義。
Q3：Plan Mode 跟 Auto Mode 該選哪一個？
差在「要不要先看過計畫」。Plan Mode 適合你自己都還沒想清楚該怎麼改的複雜任務，先看過計畫再放行；Auto Mode 適合你已經清楚要做什麼、只是不想一直被打斷的長任務。兩個不是互斥的，可以先用 Plan Mode 看過計畫，核准之後再選擇切到 Auto Mode 繼續跑。
Q4：允許清單設好之後，會不會反而不安全？
允許清單只白名單「本來就不會出事」的安全指令，例如查狀態、跑測試，真正有風險的操作依然會跳出來問你，不是把所有動作都設成自動放行。這跟權限全開是兩回事，全開才是真正的風險。
Q5：CLAUDE.md 跟 Hooks 都是設定規則，差在哪？
CLAUDE.md 寫的是「希望它怎麼做」，讀了會盡量照辦，但終究是建議；Hooks 是「一定要發生什麼」，在特定時機點自動觸發跑指令，不會因為它判斷別的方式更好就跳過。想確保某件事每次都發生，例如改完程式碼一定要跑 lint，用 Hooks 才靠得住。中文回覆這種偏好用 CLAUDE.md 寫就夠了，不需要每件事都用 Hooks 鎖。
總結
這 10 個技巧說穿了都是同一個心態：Claude Code 越具體、越有邊界，表現就越穩定。CLAUDE.md 寫輪廓、權限設允許清單、提示詞給檔案跟範例、話題一換就用 /clear 清掉 上下文、模式挑對場景，這些設定花的時間不多，但省下來的返工時間遠比想像中多。把它當團隊裡的工程師合作，而不是當一次問完就結束的聊天機器人，是這篇最核心的一句話。
如果你也在幫團隊導入 AI 開發工具、想聊聊怎麼把 Claude Code 這類工具落地成實際流程，歡迎聯絡我們，直接聊聊你的需求。
