项目里欠着一堆单元测试。这类活有几个特点:目标明确、能自动验证、量大但不难------正好属于适合交给 Claude Code 的类型。问题是它一跑就是几个小时,人不可能一直守着。
下面是我现在用的一套流程:睡前十分钟配置,机器自己跑,早上二十分钟验收。中间没有人工干预。
一、先想清楚要解决什么
Claude Code 本质上是一个终端进程。让它在你睡觉时继续干活,有两个硬约束:
- 会话不能断:关掉终端窗口、SSH 掉线,进程会跟着结束
- 机器不能睡:笔记本合盖休眠,一切都停了
第一条用 tmux 解决,第二条靠一台一直开机的机器。剩下的都是配置问题。
二、睡前十分钟:把任务写成可验证的
白天跑偏了可以随时拉回来;晚上它只能照着你写的东西走。所以任务描述的质量,直接决定第二天早上捡到的是一堆能用的提交,还是半小时的垃圾。
1. 开分支、先存档
bash
git checkout -b night/add-tests
git add -A && git commit -m "chore: 过夜任务开始前的存档"
分支是保险,改坏了 git checkout main 就回去了。
2. 在 CLAUDE.md 里写死规则
CLAUDE.md 放在项目根目录,Claude Code 每次启动都会读。过夜任务我固定加这几条:
markdown
## 过夜任务规则
- 完成标准:npm test 全部通过,npm run lint 无报错
- 每完成一个子任务就提交一次,提交信息说明改动
- 拿不准的地方选最简单、最常规的做法,把理由写进 NOTES.md
- 同一个问题试 3 次仍不通过,写进 NOTES.md 的「待处理」,继续下一个
- 不要停下来提问
最后一条是重点。晚上没人回答它,一次提问就能让整个任务停到天亮。
3. 任务描述要写「做完是什么样」
text
为 src/services 下所有没有测试的模块补单元测试。
完成标准:
1. 覆盖每个导出函数的正常和异常分支
2. npm test 全部通过
3. 不修改业务代码;发现业务代码有 bug,记到 NOTES.md,不要直接改
最后在 NOTES.md 里总结:补了哪些测试、发现了哪些可疑点
「补测试」三个字太模糊,它写两个也能交差。给出完成标准,它才知道什么时候该停。
三、权限:既不被打断,也不失控
Claude Code 默认对每个有风险的操作都会询问。白天这是好事,晚上就是灾难------你醒来发现它停在「是否允许运行 npm install」上,一整夜什么都没干。
三种模式的区别:
bash
claude --permission-mode acceptEdits # 改文件不问,执行命令仍问
claude --permission-mode auto # 分类器把关:常规放行,危险拦截
claude --permission-mode bypassPermissions # 全放行,只适合隔离环境
过夜我用 auto。装依赖、跑测试、改文件都能自己完成;强制推送、把下载的脚本直接交给 bash 之类的动作会被拦下。
bypassPermissions 只建议在隔离的容器或虚拟机里用。放在存着全部代码和密钥的机器上,等于把保险丝拆了。
再补一层 deny 规则兜底,写在 .claude/settings.json:
json
{
"permissions": {
"allow": ["Bash(npm test:*)", "Bash(npm run lint:*)", "Bash(git add:*)", "Bash(git commit:*)"],
"deny": ["Bash(git push:*)", "Bash(rm -rf:*)", "Read(./.env)", "Read(./.env.*)"]
}
}
思路很简单:能让它自己干的白名单放行,会造成不可逆后果的黑名单禁止。所有改动留在本地分支,等早上看过再说。
四、tmux:为什么不直接用 nohup
启动会话:
bash
tmux new -s night
cd ~/your-project
claude --permission-mode auto
交代完任务,按 Ctrl+B 再按 D 脱离会话,然后就可以关电脑睡觉。第二天:
bash
tmux attach -t night
几个容易踩的点:
- 脱离用
Ctrl+B D,不要输exit,那会把会话连同 Claude 一起关掉 - 想偷看一眼进度又不进会话:
tmux capture-pane -t night -p -S -50,手机上 SSH 上去最方便 - 别用
nohup claude &代替 tmux。交互式界面需要一个真实的 TTY,丢到后台很容易因为拿不到输入直接退出
五、完全无人值守:claude -p
任务描述足够完整、不需要中途交互时,可以用非交互模式:
bash
claude -p "按 TASK.md 完成任务,测试全部通过后提交" \
--permission-mode auto --max-turns 80 > night.log 2>&1 &
它会跑到完成后退出,过程写进 night.log。--max-turns 是安全阀,防止它在同一个问题上无限循环。配合 cron 还能做成每天固定时间跑的任务。
想早上收到通知,用 Stop Hook:
json
{
"hooks": {
"Stop": [
{ "hooks": [ { "type": "command", "command": "curl -s -X POST https://你的机器人webhook -d '过夜任务结束'" } ] }
]
}
}
地址换成企业微信、飞书或钉钉的群机器人 webhook,醒来手机上就有一条「几点几分收工」。
六、机器怎么选
这一节其实只有一句话:要一台能整夜开机、又不会碰到你本机文件的机器。
| 自己的电脑 | 自建 VPS | 云端开发机 | |
|---|---|---|---|
| 准备工作 | 基本没有 | 装系统、Node、Claude Code、Docker | 基本预装好,开机即用 |
| 合盖 / 断网 | 不行,得一直供电并防休眠 | 可以 | 可以 |
| 与本机文件隔离 | 不隔离 | 隔离 | 隔离(独立虚拟机) |
| 适合 | 偶尔跑一晚 | 要长期跑服务、喜欢自己折腾 | 不想花时间配环境 |
- 自己的电脑 :门槛最低。Mac 上用
caffeinate -i,或在系统设置里关掉接电源时的休眠。代价是 AI 和你所有资料在同一台机器上,前面的权限配置必须做足。 - 自建 VPS:最常见的做法,2 核 4G 起步,跑依赖安装和测试才不至于太慢。
- 云端开发机:本质是一台配好环境的 Ubuntu 虚拟机,有 root,Node、Python、Docker、git、tmux 都在,几分钟能开机,不给 SSH 也有网页终端。我现在用的是一台叫 ApexOne(apex1.us)的云端开发机,Claude Code 和 Codex 都是预装的,开机就能直接跑;闲置会自动待机,有连接进来再唤醒。它解决的仍然只是「机器得一直开着」这一条,没有别的魔法。
三种方案没有优劣,看你愿意在「配环境」上花多少时间。
七、翻车记录
| 现象 | 原因 | 处理 |
|---|---|---|
| 半夜停住,提示用量到上限 | 订阅按时窗限量 | 额度恢复后 claude --continue;任务别一次给太多 |
| 后半夜开始重复做已经做过的事 | 上下文太长,早期细节被压缩 | 让它把进度写进 NOTES.md,/compact 后按 NOTES.md 继续 |
| 一整夜没动静 | 它在等你回答 | CLAUDE.md 里写明「不要提问」 |
| 卡在一个测试上 | 测试不稳定,或问题太难 | 规定试 3 次不过就跳过并记录 |
| 早上改动多到看不过来 | 一次给的任务太大 | 一晚一个目标,要求每步提交 |
八、早上二十分钟验收
bash
git log --oneline night/add-tests # 昨晚提交了什么
npm test # 测试是不是真的都过了
git diff main...night/add-tests # 看具体改动
cat NOTES.md # 它的总结和拿不准的地方
心理预期要放平:过夜产出不可能全部可用,总有一部分要返工或丢弃。好在它跑在单独分支上、每步都提交,挑能用的合并就行。
九、清单
- 一台能整夜在线的机器,装好 tmux 和 Claude Code
- 开分支、提交存档
-
.claude/settings.json写好 deny 规则 -
CLAUDE.md写好过夜规则(完成标准、每步提交、不要提问) - 任务描述写清完成标准
-
tmux new -s night+--permission-mode auto启动 - (可选)配好 Stop Hook 通知
-
Ctrl+B D,睡觉
这套流程的适用边界也很清楚:任务能被自动验证、单个目标可控、一晚上能出结果。反过来,需要频繁判断取舍、或者要跨多个仓库联动的工作,交给它反而更麻烦。
本文环境
- 机器:ApexOne 云端开发机(apex1.us),Ubuntu,2 核 4G
- 工具:Claude Code、tmux、git
- 任务:给一个 TypeScript 项目补单元测试