📌 本文重點
- Auto 模式會自動判斷你在寫新功能、改舊程式或除錯
- 能整合看錯誤、改程式、再執行的完整 workflow
- 適合用來快速理解專案結構並分階段重構
- Claude Code 是雲端 AI pair programmer,可搭配既有 IDE / Git
Claude Code 的 Auto 模式,就是一個會自己判斷你現在在寫新功能、改舊程式還是除錯,主動選工具幫你的 AI 助手,讓你少切視窗、多寫程式。
一句話先懂:Auto 模式在解決什麼事?
一般用 AI 寫程式,你要自己決定「現在是要叫它生程式碼、還是幫我跑測試、還是查錯?」;Claude Code 的 Auto 模式直接幫你讀懂上下文與指令,自己決定要:
- 生成程式碼(Code generation)
- 讀檔案、理解專案結構
- 執行程式或測試來 debug
- 對現有程式碼做重構與優化
你只要「像對同事講話」描述需求,它會自己選對功能、跑對步驟。
Auto 模式介紹原文(英):https://claude.com/blog/auto-mode-default-in-claude-code
核心功能:你可以拿它來做什麼?
1. 程式碼生成:從需求到檔案結構,一次到位
Auto 模式不只會產生一個函式,而是會:
- 根據你的描述設計檔案與目錄結構
- 建立/修改多個檔案
- 必要時幫你寫簡單測試或使用說明
實際用法:
在 Claude Code 裡直接丟一句:
幫我用 Node.js + Express 寫一個簡單的 REST API,有
/usersCRUD,資料先用記憶體暫存就好,請建立基本專案結構,包含入口index.js和路由檔。
Auto 模式會:
- 自動建立
index.js、routes/users.js等檔案草稿 - 解釋怎麼啟動 server
- 提出可以加測試或 logging 的建議(你可以選要不要做)
你可以立刻把這些檔案複製到本機專案,或之後改用 API / IDE 插件串接。
💡 關鍵: Auto 模式會從需求一路幫你拉到完整檔案結構與啟動方式,減少你查 boilerplate 的時間
2. 錯誤修正:看 log、改程式、再跑一次
Auto 模式最大的差別是:它能整合「看錯誤 +改程式+再執行」的流程,而不是只回你「原因可能是什麼」。
基本 workflow:
- 貼上錯誤訊息或測試失敗 log
- 說你想要的結果
- 讓 Auto 模式決定哪個檔案要改、改什麼
範例 prompt:
這是 pytest 的錯誤輸出,
test_calculate_price一直 fail。請幫我找出原因並修改對的檔案,然後給我修正後的程式碼片段就好。
Auto 模式會:
- 根據 stack trace 推斷是哪個函式有問題
- 在對應檔案裡標出問題區塊,提出修改
- 說明為什麼這樣改可以解決測試失敗
如果你在 Claude Code 裡有上傳整個 repo,它還能 cross-file 看「其他地方怎麼用這個函式」,避免修一個地方壞一片。
3. 重構與優化:不只是「換個寫法」
Auto 模式的重構能力,不只做到「把程式碼變漂亮」,而是會考慮:
- 函式命名與責任分界
- 檔案拆分與模組化
- 重複邏輯抽取
- 加上必要的 docstring 或註解
實際用法:
我這個檔案功能太多了,請你先幫我讀完整檔,整理現在的功能清單,再給一個重構計畫,最後一步一步修改程式碼(可以分成幾個 commit 的建議)。
你可以照它的「重構計畫」拆成多次對話,逐步套用變更,避免一次大改爆掉。
4. 多檔案理解:真正懂你的專案結構
Claude Code 可以讓你上傳整個專案(zip 或接 repo),Auto 模式就能:
- 建立專案索引(檔案、目錄、framework)
- 在回答時引用相關檔案片段
- 針對特定模組做修改而不干擾其他部分
建議使用方式:
- Side project:直接把整個專案 zip 上去
- 公司專案:選擇跟要改的功能相關的子資料夾(避免洩漏敏感資訊)
之後問問題時,多加一句:
以上是整個
backend/資料夾,請先幫我看懂架構,再建議要改哪個檔案比較安全。
適合誰用?4 個常見場景 workflow
1. Side project:快速起專案 + 小步調整
目標: 少查 boilerplate,多花時間在核心功能。
建議 workflow:
- 在 Claude Code 開一個新 Project,upload 空白或半成品 repo
- 用 Auto 模式下指令:
- 「幫我補上 basic auth middleware」
- 「加一個簡單的設定檔,讓環境變數可以統一管理」
- 每次改完都讓它幫你檢查:
- 「請確認這個改動不會影響現有路由」
2. LeetCode / 刷題:不只拿答案,而是練思路
目標: 用 Claude 當「教練」,不是答案機器。
建議用法:
- 先自己寫出初版解法,貼上程式碼
- 對 Auto 模式說:
這題是 LeetCode [題號],我現在這個解法是 O(n^2),你先不要直接給最優解,請先用中文講解我這個解法的缺點,再給我 1~2 個提示,讓我自己改成更好的做法。
- 如果真的卡住再說:
好,我卡住了,請給我最優解程式碼,並註解標註關鍵步驟。
💡 關鍵: 明講「先不要給最優解」,能把 Auto 模式變成教練角色,幫你訓練思路而不是只抄答案
3. 公司專案 debug:看 log + 看多檔案一次搞定
目標: 把時間留在理解業務邏輯,而不是瞎猜錯在哪。
安全建議:不要上傳含敏感資料的設定檔(例如 .env、金鑰)。
實際流程:
- 上傳與出錯功能相關的資料夾(例如
services/+routes/) - 貼上 production log(可匿名化部分內容)
- 指令範例:
這個錯誤只會在特定客戶出現,請幫我看 log 和程式碼,推論最可能的 2–3 個原因,並給我修正建議,請避免大改架構,先以最小修補為主。
Auto 模式會:
- 依 log 指到對應函式
- 確認相關呼叫鏈(跨檔案)
- 提出幾種修法(你可以挑最保守的)
4. 重構舊程式碼:從「先讀懂」到「分階段改」
目標: 讓 AI 先幫你梳理舊專案,再陪你一起拆成小改動。
建議 prompt 流程:
- 先丟整個舊模組:
這是 5 年前寫的舊模組,請幫我用中文整理:主要功能、依賴關係、明顯的技術債。
- 再要求重構計畫:
請幫我規劃三個階段的重構:第一階段只做安全重構(不改 public API),第二階段開始調整資料結構,第三階段再考慮換框架。
- 每個階段再開新對話,讓 Auto 模式只針對相關檔案提出修改建議。
怎麼開始用 Claude Code Auto 模式?
1. 入口在哪?怎麼開啟 Auto 模式
- 進入 Claude 網站:https://claude.com
- 登入帳號(目前有免費層級)
- 左側選單點 Claude Code
- 建立一個新的 Code project
- Auto 模式現在是預設啟用,你在對話框直接輸入需求即可
在 Auto 模式下,你會看到它自動在右側「檔案區」建立或修改檔案,並標示變更。
💡 關鍵: Auto 模式預設啟用,加上有免費層級,讓你幾乎沒有門檻就能開始實驗這套 workflow
2. 上傳專案與基本設定
上傳方式:
- 直接拖曳 zip 檔到 Claude Code 頁面
- 或選擇多個檔案 / 資料夾上傳
實際設定建議:
上傳完第一件事,先講明規則:
這個專案是 Next.js + Prisma,請你之後所有建議都遵守現有架構與命名規則,不要改動資料庫 schema,除非我有明講可以改。
這可以避免 Auto 模式「好心重構」結果打壞你既有設計。
3. Prompt 寫法:幾個好用範例
你可以用這幾個模板直接改關鍵字使用:
- 加新功能
現在的程式已經有 [功能 A],我想加一個 [功能 B]。請先說明你打算改哪些檔案,然後一步一步給我要新增的程式碼片段,避免一次大改。
- 找 bug
這裡是錯誤 log + 相關程式碼。請幫我推論可能原因,優先從最小修補開始,並標出你建議修改的行數與內容。
- 重構
請先用中文說明這個檔案目前在專案裡的角色,再幫我做「不改行為」的重構:只優化可讀性與結構,不要改動任何輸入輸出格式。
4. 和現有 IDE / Repo 搭配的方式
目前 Claude Code 本身是「雲端工作區」,典型搭配方式:
- Repo 主控權在 Git
- 在本機 / 公司標準 Git flow 照常開分支
- 把要改的檔案複製到 Claude Code(或壓成 zip 上傳)
- 讓 Auto 模式生成 /修改程式碼
-
再把修改貼回本機,自己下 commit
-
與 IDE 搭配的建議
- 在 IDE 裡跑程式與測試(確保環境一致)
- Claude Code 負責「看多檔案、出建議」
- 你在 IDE 裡套用變更並做最後檢查
這樣你不用完全換工作環境,只是多一個「雲端 AI pair programmer」,專門處理跨檔案的理解與改動建議。
延伸比較:Claude Code 跟其他工具怎麼選?
如果你也在看 Muse Code 或 Codex CLI,可以參考 Towards AI 的架構比較文:
https://pub.towardsai.net/muse-code-vs-claude-code-vs-codex-cli-7-architecture-differences-worth-evaluating-428c935997f2
以下是簡化後的使用情境比較:
| 名稱 | 核心功能 | 免費方案 | 適合誰 |
|---|---|---|---|
| Claude Code | 雲端對話式 Auto 模式、讀多檔案 | 有免費層級 | 想用瀏覽器做 code review、重構 |
| Muse Code | 偏 IDE 插件、即時補全 | 依產品方案而定 | 喜歡在原本 IDE 即時輔助 |
| Codex CLI | 命令列整合、腳本自動化 | 視使用方案而定 | 愛用 terminal、寫自動化腳本 |
如果你常在瀏覽器看 PR、或需要快速理解陌生 repo,Claude Code + Auto 模式會特別合用;要深度整合 IDE 再考慮搭配其他工具。
小結:先讓 Auto 模式幫你「看懂專案」,再叫它出手
建議第一次使用 Claude Code Auto 模式時,不要直接叫它改一大堆,而是:
- 先上傳你要改的部分專案
- 叫它用中文整理架構與風格
- 再從小需求開始讓它出手(修一個 bug、重構一個檔案)
習慣這種「先理解、再修改」的工作流後,你會發現 Auto 模式最適合拿來處理那些「自己看得懂但看很久」的問題,把時間留給真正需要你決策的設計與產品細節。
🚀 你現在可以做的事
- 到 https://claude.com 開一個新的 Claude Code 專案,試著用 Auto 模式生成一個小型 REST API
- 把你現在一個正在 debug 的 side project 壓成 zip 上傳,請 Auto 模式依 log 幫你找出 2–3 個可能原因
- 挑一個舊專案模組,上傳後讓 Auto 模式先用中文整理架構,照文中「三階段重構」流程實驗一次


發佈留言