~/教學/OVERNIGHT.md
讓 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你會得到什麼:一晚跑完一整份任務清單

做完之後你會有:
- 一個 tasks.txt:一行一個任務。
- 一個 overnight.sh:逐行把任務交給 claude -p,不會停下來問你。
- 每個任務一份 logs/task-N.json 紀錄,和一行完成時間與結束碼。
- 早上用 git diff 看它改了什麼,確認後才合併。

02第 1 步:任務一行一個寫進 tasks.txt
在專案資料夾建一個 tasks.txt。每一行是一個獨立、說得清楚的小任務,最好一個任務只動一兩個檔案。這是我 Reels 裡用的清單(前三行):
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

03第 2 步:三個設定,讓它不卡住、不亂繞
① claude -p(或 --print):不開對話,跑完就結束。官方文件寫的是用非互動模式執行,適合腳本。

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

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

04第 3 步:用一個迴圈跑整份清單
把下面這段存成 overnight.sh,放在專案資料夾。它逐行讀 tasks.txt,每個任務跑一次 claude -p,結果存到 logs/task-N.json,並印出時間和結束碼(0 = 成功)。
#!/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

- 先開一個 git 分支:git checkout -b overnight
- 睡前在終端機跑:bash overnight.sh
- 電腦不要進入睡眠,筆電接上電源。
05第 4 步:早上看紀錄、看 diff,再合併

- 看終端機印出的每一行:exit=0 是成功,不是 0 的先打開那個 logs/task-N.json 看原因。
- 跑 git diff(或 git diff main)一個一個看改了什麼。
- 跑一次測試,確認沒有改壞。
- 沒問題再合併回主分支;不滿意的就 git restore 丟掉。
06要注意
- 不要用 --dangerously-skip-permissions。官方 CLI reference 說它等於 bypassPermissions,所有動作都不再問,整晚沒人看著風險最大。用 --allowedTools 只開需要的工具就好。
- 在 git 分支或 worktree 裡跑,早上確認後才合併,隨時可以整批丟掉。
- 這份範例只開 Read、Edit、Write,不開 Bash,所以它不能跑指令(包括跑測試)。需要時再加特定指令,不要整個 Bash 都開。
- 每個任務都會用到額度或 API 費用;先用兩三個任務試跑,看 logs 確認沒問題再丟十個。
- 參數以 2026-11-17 的官方文件為準,之後版本可能會變,跑之前看一下 claude --help。
資料來源
下一支 Reel 想學什麼?
我每天測 Claude 和 AI 工具,把真的有用的做成 Reel。追蹤 @vivianlin.tech,新教學一出來就看得到。