~/教學/OVERNIGHT.md

文章 / Claude Code

讓 Claude Code 整晚自己跑:claude -p、--allowedTools、--max-turns 三個設定,睡前丟任務,起床只審核

睡前把任務清單丟給 Claude Code,用 claude -p、--allowedTools、--max-turns 讓它不卡住、不亂繞,早上看 logs 和 git diff 再合併。

Claude Code 平常每做一步都問你 Yes,你一睡著它就卡在那裡等。這篇是 Reels 裡 OVERNIGHT 那支的完整版:三個官方設定,加一個十幾行的小腳本,讓它整晚逐一跑完任務清單,早上你只要審核。所有指令和參數都在 2026-11-17 對照 Claude Code 官方文件確認過。

01你會得到什麼:一晚跑完一整份任務清單

Reels 畫面:筆電上是 tasks.txt,十行任務,Claw'd 坐在旁邊,標題寫 Claude Code 整晚自己跑
Reels 畫面:睡前丟 10 個任務,起床只剩審核。

做完之後你會有:

  1. 一個 tasks.txt:一行一個任務。
  2. 一個 overnight.sh:逐行把任務交給 claude -p,不會停下來問你。
  3. 每個任務一份 logs/task-N.json 紀錄,和一行完成時間與結束碼。
  4. 早上用 git diff 看它改了什麼,確認後才合併。
Reels 畫面:一連串 Allow Edit? Allow Bash? 1. Yes 2. No 的確認,標籤寫一直問 Yes
Reels 畫面:平常它一直問 Yes,一睡著就卡住。

02第 1 步:任務一行一個寫進 tasks.txt

在專案資料夾建一個 tasks.txt。每一行是一個獨立、說得清楚的小任務,最好一個任務只動一兩個檔案。這是我 Reels 裡用的清單(前三行):

tasks.txt(範例)
Add a JSDoc comment to src/cart.js and write a small test in test/cart.test.js
Add a JSDoc comment to src/price.js and write a small test in test/price.test.js
Add a JSDoc comment to src/date.js and write a small test in test/date.test.js
tasks.txt 編輯器畫面:十行 Add a JSDoc comment to src/….js and write a small test
我 Reels 用的真實 tasks.txt,十個任務。

03第 2 步:三個設定,讓它不卡住、不亂繞

① claude -p(或 --print):不開對話,跑完就結束。官方文件寫的是用非互動模式執行,適合腳本。

Claude Code 官方文件 headless 頁:Basic usage,claude -p "Find and fix the bug in auth.py" 範例
官方文件:加 -p 就是非互動模式(2026-11-17 截圖)。

② --allowedTools "Read,Edit,Write":列好它可以直接用的工具。沒列到、又需要批准的動作會直接被拒絕,不會整晚停在那裡等你按 Yes。

官方文件 headless 頁:Auto-approve tools,--allowedTools "Bash,Read,Edit" 範例與說明
官方文件:--allowedTools 自動核准列出的工具,其他需要批准的會被拒絕。

③ --max-turns 8:限制它最多走幾步(只在 -p 模式有效,預設沒有上限)。到了上限就停,不會整晚繞圈。

官方文件 CLI reference:--max-turns 那一列,Limit the number of agentic turns (print mode only)
官方文件 CLI reference 的 --max-turns。

04第 3 步:用一個迴圈跑整份清單

把下面這段存成 overnight.sh,放在專案資料夾。它逐行讀 tasks.txt,每個任務跑一次 claude -p,結果存到 logs/task-N.json,並印出時間和結束碼(0 = 成功)。

overnight.sh(Mac / Linux / Windows 的 Git Bash)
#!/bin/bash
# overnight.sh: one run per task
mkdir -p logs
n=0
while IFS= read -r task; do
  n=$((n+1))
  claude -p "$task" \
    --allowedTools "Read,Edit,Write" \
    --max-turns 8 \
    --output-format json \
    < /dev/null > "logs/task-$n.json"
  rc=$?
  echo "$(date +%H:%M) task $n exit=$rc"
done < tasks.txt
overnight.sh 編輯器畫面:while 迴圈裡 claude -p 加 --allowedTools、--max-turns 8、--output-format json
Reels 裡的真實 overnight.sh。
  1. 先開一個 git 分支:git checkout -b overnight
  2. 睡前在終端機跑:bash overnight.sh
  3. 電腦不要進入睡眠,筆電接上電源。

05第 4 步:早上看紀錄、看 diff,再合併

Reels 畫面:tasks.txt 十個任務,標題寫早上只要審核 看紀錄・看 diff
Reels 畫面:早上只要審核。
  1. 看終端機印出的每一行:exit=0 是成功,不是 0 的先打開那個 logs/task-N.json 看原因。
  2. 跑 git diff(或 git diff main)一個一個看改了什麼。
  3. 跑一次測試,確認沒有改壞。
  4. 沒問題再合併回主分支;不滿意的就 git restore 丟掉。

06要注意

  1. 不要用 --dangerously-skip-permissions。官方 CLI reference 說它等於 bypassPermissions,所有動作都不再問,整晚沒人看著風險最大。用 --allowedTools 只開需要的工具就好。
  2. 在 git 分支或 worktree 裡跑,早上確認後才合併,隨時可以整批丟掉。
  3. 這份範例只開 Read、Edit、Write,不開 Bash,所以它不能跑指令(包括跑測試)。需要時再加特定指令,不要整個 Bash 都開。
  4. 每個任務都會用到額度或 API 費用;先用兩三個任務試跑,看 logs 確認沒問題再丟十個。
  5. 參數以 2026-11-17 的官方文件為準,之後版本可能會變,跑之前看一下 claude --help。

資料來源

延伸閱讀