如何使用 Claude 程式碼自動模式:完整步驟教學

先決條件
在使用 Claude 程式碼自動模式之前,請確保您具備以下條件:
-- Claude 訂閱:團隊方案(研究預覽版所需)或企業方案(即將推出)。自動模式不適用於 Pro、Max 或免費帳戶。 -- Claude 模型:Claude Sonnet 4.6 或 Opus 4.6(自動模式所需)。 -- 已安裝 Claude Code:最新版本的 CLI、桌面應用程式或 VS Code 擴充功能。 -- 專案目錄:您要操作的本地程式碼庫。 -- 終端機存取權:用於 CLI 使用(推薦以獲得完整控制權)。
注意:自動模式目前是研究預覽版。管理員可以透過管理設定在組織範圍內停用它。
步驟 1:安裝 Claude Code
-
打開您的終端機。
-
根據您的作業系統執行相應的安裝命令:
macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bashWindows (PowerShell)
irm https://claude.ai/install.ps1 | iex -
驗證安裝:
claude --version -
(可選)適用於 macOS 上的 Homebrew:
brew install --cask claude-code
安裝完成後,Claude Code 將在背景自動更新。
步驟 2:登入 Claude Code
- 啟動互動式工作階段:
claude - 遵循螢幕上的登入提示(僅首次使用時)。
- 使用團隊或企業帳戶。
登入後,憑證將安全儲存。
步驟 3:啟用自動模式
自動模式必須在模式切換循環中出現之前,明確進行解鎖。
CLI 方法(推薦)
使用啟用標記啟動:
claude --enable-auto-mode
或直接以自動模式啟動:
claude --enable-auto-mode --permission-mode auto
設定檔方法
建立或編輯 ~/.claude/settings.json(使用者層級)或 .claude/settings.local.json(專案層級):
{
"defaultMode": "auto"
}
重要:--enable-auto-mode 標記在啟動時仍然是必需的,才能使該模式出現在 Shift+Tab 切換循環中。
桌面應用程式 / VS Code 擴充功能
- 打開 Claude Code 設定。
- 切換 自動模式 為開啟(僅在透過 CLI 標記或管理員設定啟用後才會顯示)。
步驟四:配置自動模式分類器(建議)
自動模式使用背景分類器來核准安全的操作。請根據您的環境進行自定義設定。
-
檢查內建規則:
claude auto-mode defaults -
複製輸出內容,並使用受信任的基礎設施創建/編輯您的設定檔:
{ "autoMode": { "environment": [ "組織:Acme Corp. 主要用途:軟體開發", "版本控制:github.com/acme-corp 及所有儲存庫", "雲端儲存桶:s3://acme-build-artifacts" ], "allow": [ "允許部署至暫存環境:隔離環境" ], "soft_deny": [ "絕不在官方 CLI 之外執行資料庫遷移" ] } } -
驗證您的配置:
claude auto-mode config -
獲取 AI 對自訂規則的回饋:
claude auto-mode critique
步驟五:啟動工作階段並切換至自動模式
-
導航至您的專案目錄:
cd /path/to/your-project -
啟動啟用自動模式的 Claude Code:
claude --enable-auto-mode -
在工作期間切換模式:
- 重複按下 Shift + Tab(或 Alt + M)循環切換:
default→acceptEdits→plan→auto。 - 當前模式會顯示在狀態列中。
- 重複按下 Shift + Tab(或 Alt + M)循環切換:
-
指派任務給 Claude。範例:
重構驗證模組,新增單元測試,並執行完整的測試套件。
自動模式現在會自動核准低風險的工具調用(檔案讀取、目標編輯、標準建置/測試),同時分類器會阻擋任何高風險操作。
步驟六:有效使用的最佳實務
- 先在計畫模式下開始:切換至
plan模式(按兩次 Shift+Tab),審查 Claude 的計畫,然後切換至自動模式。 - 新增專案上下文:在根目錄建立
CLAUDE.md檔案,包含編碼標準、建置指令與禁止的操作。 - 使用檢查點:Claude 會在變更前自動儲存狀態。透過按兩次
Esc或輸入/rewind來回退。 - 結合掛勾功能:配置
.claude/settings.json以在編輯後自動執行代碼檢查或測試。 - 監控進度:使用詳細模式(
Ctrl + R)查看完整的推理過程。
常見問題與疑難排解
-
自動模式未出現在循環中:
- 請確保您使用
--enable-auto-mode參數啟動。 - 確認您處於 Team/Enterprise 版本,且使用 Sonnet 4.6 或 Opus 4.6。
- 若處於組織中,請檢查管理員設定。
- 請確保您使用
-
分類器阻擋合法操作:
- 在
autoMode.allow或environment中添加明確規則。 - 使用
claude auto-mode critique獲取建議。 - 提供更清晰的任務指示,或暫時切換至
acceptEdits模式。
- 在
-
延遲較高或令牌使用量增加:
- 這是因為背景分類器運作所致,屬於正常現象。建議僅在長時間工作階段中使用。
-
受保護路徑上的權限錯誤:
.git、.claude等路徑在多數模式下仍會觸發提示。若需完全自主操作,請使用隔離環境(如 Docker/虛擬機)。
-
工作階段意外結束:
- 執行
claude -c以繼續最近的對話。
- 執行
後續步驟
- 嘗試使用計劃模式處理複雜重構任務,再切換至自動模式。
- 設定自訂命令和鉤子,以建立可重複的工作流程。
- 使用子代理處理平行任務(例如前端 + 後端)。 .
- 透過 GitHub Actions 與 CI/CD 整合,建立完全自動化的流水線。
- 為確保安全,可在一次性 Git 分支或 Docker 容器中進行實驗。
啟用並適當設定自動模式後,您可以執行長達數小時的自動化編碼工作階段,大幅減少中斷次數,同時維持強大的安全防護機制。建議從簡單任務開始,隨著信心增長逐步擴充受信任的環境規則。