第10章 一行运行与自动化
必读 想跟着这个阶段学下去,一定要读这一章。一句话总结:
claude -p回答一次就结束。写入要事先许可,成功与否看退出码。把这三样组合起来,就成了一行命令就能运行的每周整理。
本章的输出是 2026年11月6日在 Linux 上用 Claude Code 2.1.318 运行的结果。觉得难也没关系。一块一块地看,其实就是把前面几章做好的东西接起来。
claude -p 与对话式的区别
加上 -p(或 --print),就不进入对话,回答一次就结束。[1] 用 /exit 退出,在终端里进入练习文件夹后输入。
claude -p "inbox 文件夹里有几个文件?只用一行回答。"它回答了 inbox 文件夹里有 1 个文件。,然后马上回到了 Shell。
对话式的 claude 会一直持续到你退出,并以自动(auto)模式启动。claude -p 给出回答就结束,并以手动(Manual)模式启动。[1:1] 只有在没人值守、要运行同样的工作时才需要 -p。其余情况用对话式就够了。
理解检查
`claude -p "请求"` 和对话式的 `claude` 有什么不同?
为什么写入会被挡住
这次请它创建一个文件。为了不覆盖第4章的文件,把文件名定为 minutes-one-line.md(会议记录-一行)。
claude -p "读取 inbox 里的会议笔记,整理成 minutes-one-line.md 文件并保存。"文件没有生成。回答里告诉你 文件写入权限没有被批准。这不是故障。-p 以手动模式启动,却没有可以询问的人。所以需要批准的调用会被拒绝。[1:2] 只要事先许可需要的工具就行。[1:3]
claude -p "读取 inbox 里的会议笔记,整理成 minutes-one-line.md 文件并保存。回答只用一行。" --allowedTools "Read,Write"--allowedTools 是事先指定哪些工具不用询问就能使用的选项。Read 是读取文件,Write 是写入文件。用逗号连起来,再用引号括住。
这次文件生成了。如果 ls 里没有,也看看 ls notes。因为第8章的规则,它可能被保存到了那里。
与其因为不知道需要什么而给得很宽,不如只给这项工作需要的 Read,Write。许可给得窄,就算 Claude 判断错了,它能做的事也相应更少。
理解检查
用 `claude -p` 让它保存文件,文件却没生成。为什么?
用管道传递内容
管道(Pipe,|)是把前一条命令的输出交给后一条命令作为输入的符号。想象水顺着管子流过去就行。claude -p 也能通过管道接收内容。[1:4]
cat inbox/meeting-2026-10-27-weekly.txt | claude -p "从这份笔记里只挑出待办事项,写成三行。"- 瑞妍:今天(10/27)买卫生间灯泡
- 瑞妍:周三前写好套餐菜单文案初稿
- 俊浩:周五前查好热红酒成本在 Windows 上,通过管道传过去的韩文可能会变成乱码。如果回答不对劲,就不用管道,改成在文件名前加 @ 传过去。把 文件名 换成实际的笔记文件名。这条命令我们在 Linux 上运行确认过,在 Windows 上没有试过。
claude -p "从 @inbox/文件名 里只挑出待办事项,写成三行。"不能信任的内容,不要直接用管道传过去。[2] 比如从网上下载的文字,或者陌生人发来的邮件。文字里可能藏着第7章里看到的提示词注入。[2:1] 提示词注入是在文字里偷偷混入给 AI 的指示,让它去做奇怪事情的手法。
练习笔记 meeting-2026-10-29-adhoc.txt(会议-2026-10-29-临时会议)里就有这种句子的例子。现在只点开链接,在浏览器里读一读。先不要放进 inbox 文件夹。因为后面要做的脚本会处理 inbox 里的所有笔记。这份笔记要等到第13章学习如何安全处理时再放进去。
理解检查
想把陌生人发来的邮件正文直接交给 `claude -p`。怎么做比较好?
保存输出、改变格式
想把回答存成文件,就在最后加上 > todo.txt(待办.txt)。[1:5] 回答不会显示在屏幕上,而是写进文件。如果已经有同名文件,会被覆盖,要小心。
本章的练习不需要下面的 JSON 输出。知道有这么个东西就行。
如果需要别的程序来读取回答,就用第8章里看到的 JSON 格式接收。[1:6] 写法是 claude -p "1+1等于几?只要数字。" --output-format json。会输出很长的一行。回答在 result 这一项里。
total_cost_usd 这一项里是美元金额。不用吃惊。这是程序算出的估算值,可能和实际账单不同。[1:7] 对订阅用户来说,会话费用的数字在计费上没有意义。[3]
理解检查
`--output-format json` 结果里的 `total_cost_usd` 该怎么理解?
次数限制与退出码
没人看着的时候,Claude 运行太久就麻烦了。用 --max-turns 给轮次(Claude 接着做一次工作的单位)的次数设上限。默认没有限制。[4] 我们故意把它降到 1 试试。
claude -p "读取 inbox 文件夹里的所有笔记,总结成三行。" --allowedTools "Read" --max-turns 1
echo $?Error: Reached max turns (1)
1最下面的 1 就是退出码(Exit code)。成功是 0,失败是不为 0 的值。[1:8] 人读文字,脚本读这个数字。echo $? 显示刚刚那条命令的退出码。在 PowerShell 里输入 $LASTEXITCODE。
理解检查
脚本判断 `claude -p` 是否成功时,看的是什么?
制作 weekly-summary.sh
现在把这些零件拼起来。脚本(Script)就是把命令写进文件,一次性运行。需要有第8章的 CLAUDE.md 和 notes 文件夹,以及第9章的技能。用 /exit 退出,在终端里进入练习文件夹。Mac 和 Linux 把下面整段粘贴进去(以文件查看:ch10-weekly-summary.sh.txt)。
cat > weekly-summary.sh <<'EOF'
#!/bin/bash
# 把 inbox 里的会议笔记逐个整理成会议记录。
for memo in inbox/meeting-*.txt; do
echo "正在整理:$memo"
if claude -p "/meeting-notes $memo" --allowedTools "Read,Write" --max-turns 10; then
echo "完成:$memo"
else
echo "失败:$memo"
fi
done
EOF粘贴后如果还没运行,就再按一次 Enter。什么都没显示就是成功了。用 ls 看看 weekly-summary.sh(每周整理.sh)有没有生成。
第一行 #!/bin/bash 表示用 bash(Shell 的一种)来读这个文件。下一行以 # 开头,是给人看的说明。for 那一行把名字以 meeting- 开头的笔记逐个放进 memo。这里的 memo 是变量(Variable)。可以看成暂时存放值的名牌。在名字前面加 $,写成 $memo,就能取出里面的值来用。第一轮时,$memo 会变成 inbox/meeting-2026-10-27-weekly.txt。
if 那一行调用第9章的技能,退出码是 0 就打印 完成,否则打印 失败。
变量名要像 memo 这样用英文写。bash 不接受韩文变量名。文件名用韩文也没关系。
运行只要一行。
bash weekly-summary.sh
正在整理:inbox/meeting-2026-10-27-weekly.txt
已保存到 `notes/minutes-2026-10-27.md`,待办事项有 5 个。
顺便说一下,笔记里把 10/27 和 11/3 写成了星期一,但按 2026 年的日历两天都是星期二,所以星期和日期保持了笔记原样。
完成:inbox/meeting-2026-10-27-weekly.txt没人按任何键,会议记录就生成了(查看结果)。你的结果措辞不同也没关系,只要有三个部分和表格就行。
在 Windows 上,这个脚本不能在 PowerShell 里直接运行。因为它是给 bash 用的。请用下面的 PowerShell 版。Mac 和 Linux 跳过这部分就行。
同样的工作用 PowerShell 写是下面这样。每次运行时,把这个框里的内容粘贴到窗口里。这是没有实际运行过的示例。如果你用 WSL,就在 WSL 终端里运行上面的脚本。[5]
foreach ($file in Get-ChildItem inbox/meeting-*.txt) {
$memo = "inbox/$($file.Name)"
Write-Output "正在整理:$memo"
claude -p "/meeting-notes $memo" --allowedTools "Read,Write" --max-turns 10
if ($LASTEXITCODE -eq 0) { Write-Output "完成:$memo" } else { Write-Output "失败:$memo" }
}理解检查
在脚本里把变量名写成 `메모`,结果报错了。该怎么改?
订阅账号要知道的事
如果是订阅账号,只要记住两点。
- 运行脚本前后各看一次用量。在会话里输入
/usage,会显示用量条。[3:1] - 就算别的文章推荐
--bare这个选项,也不要加。
-p 运行会怎样从订阅限额里扣除,本指南确认过的官方文档里没有写。所以不要猜,用 /usage 亲眼看最可靠。
不能加 --bare 的原因是这样的。官方文档推荐在脚本里用 --bare,但 --bare 不会读取订阅登录信息。CLAUDE.md 和技能也不会加载。[6] 我们的脚本这三样都需要。
反过来,不加 --bare 使用 -p,就会加载那个文件夹的设置。连从没信任过的文件夹里的钩子和 MCP 服务器也一样。[6:1] 所以只在你清楚内容的自己的文件夹里运行。
理解检查
用订阅账号运行脚本时,`--bare` 选项该怎么处理?
离开座位前的检查
交给它运行、自己离开座位之前,确认三件事。[7] 对照我们的脚本是这样的。
- 结束时是什么样子?每份笔记在
notes里生成一个会议记录文件,就算结束。 - 它能检查自己的工作吗?用退出码区分
完成和失败。 - 它只碰该碰的东西吗?只许可了
Read,Write,但并没有限制文件夹。所以只在练习文件夹里运行。次数用--max-turns 10限住了。
脚本会处理 inbox 里的全部会议笔记。所以放进新笔记再运行。没读过的笔记不要放进去。另外,退出码 0 只表示正常结束了。并不表示会议记录的内容也是对的。头几周请亲自读一读结果。
理解检查
脚本打印出了 `完成`。这两个字是什么意思?
动手试一试
在终端里用
claude -p发一个读取类的问题,再不加许可发一个写入请求。用ls确认文件没有生成。加上
--allowedTools "Read,Write"再发一次。用管道挑出待办事项并保存。在 Windows 上如果回答不对劲,就用前面的
@方法。bashcat inbox/meeting-2026-10-27-weekly.txt | claude -p "从这份笔记里只挑出待办事项,写成三行。" > todo.txt用
--max-turns 1让它失败,看看退出码。做好
weekly-summary.sh,用bash weekly-summary.sh运行。Windows 粘贴上面的 PowerShell 代码框。
问问自己:没人值守也跑完了吗?结果和笔记一致吗?下周笔记多了,用同一条命令也行吗?
小结
claude -p以手动模式启动,没有可以询问的人。写入要用--allowedTools事先许可。- 不能信任的内容不要用管道传过去。JSON 里的费用是估算值。
- 用
--max-turns限制次数,用退出码判断是否成功。 - bash 变量名用英文写。bash 脚本不能在 PowerShell 里直接运行。
- 订阅账号不要用
--bare,用量用/usage亲自查看。
术语整理
| 术语 | 中文名称 | 一句话解释 |
|---|---|---|
| Pipe | 管道 | 把前一条命令的输出交给后面的符号 |
| Exit code | 退出码 | 结束时留下的数字(0 表示成功) |
| Script | 脚本 | 写好命令、一次性运行的文件 |
这一章读完了吗?
学习记录只保存在这个浏览器中。整体进度可以在 全部目录中查看。
下一章:第11章 钩子与界面定制
参考资料(7 条)
Claude Code 官方文档,「Run Claude Code programmatically」。"Add the
-p(or--print) flag to anyclaudecommand to run it non-interactively." / "With Claude Code v2.1.302 or later,claude -pruns start in Manual mode when nothing sets a permission mode." / "In a Manual modeclaude -prun, a call that needs approval is denied unless something approves it" / "Use--allowedToolsto let Claude use certain tools without prompting." / "Non-interactive mode reads stdin, so you can pipe data in and redirect the response out like any other command-line tool." / "json: structured JSON with result, session ID, and metadata" / "Both figures are client-side estimates and can differ from your actual bill." / "Claude Code exits with code 0 on success and a non-zero code when the run fails, so your scripts can branch on the exit status." code.claude.com (确认日期 2026-11-06) ↩︎Claude Code 官方文档,「Security」。"Avoid piping untrusted content directly to Claude" / "Prompt injection is a technique where an attacker attempts to override or manipulate an AI assistant's instructions by inserting malicious text." code.claude.com (确认日期 2026-11-06) ↩︎
Claude Code 官方文档,「Manage costs effectively」。"Claude Pro, Max, and Ultra subscribers have usage included in their subscription, so the session cost figure isn't relevant for billing purposes." / "Subscribers see plan usage bars, activity stats, and a usage breakdown on the same screen." code.claude.com (确认日期 2026-11-06) ↩︎
Claude Code 官方文档,「CLI reference」。"Limit the number of agentic turns (print mode only). No limit by default." code.claude.com (确认日期 2026-11-06) ↩︎
Claude Code 官方文档,「Advanced setup」。"You install and launch
claudeinside the WSL terminal, not from PowerShell or CMD." code.claude.com (确认日期 2026-11-06) ↩︎Claude Code 官方文档,「Run Claude Code programmatically」。"
--bareis the recommended mode for scripted and SDK calls, and will become the default for-pin a future release." / "In bare mode, Claude Code never reads OAuth credentials or the system keychain." / "Add--bareto reduce startup time by skipping auto-discovery of hooks, skills, custom commands, subagents, installed plugins, MCP servers, auto memory, and CLAUDE.md." / "Without--bare, a-psession runs the hooks in a project's.claude/settings.jsonand connects the servers in its.mcp.json, even in a folder you've never trusted." code.claude.com (确认日期 2026-11-06) ↩︎Claude Code 官方文档,「Best practices for Claude Code」。"Before a run goes unattended, make sure it knows what done looks like, can check its own work, and can only touch what it should." code.claude.com (确认日期 2026-11-06) ↩︎