切换上机材料(4 篇)
W06 学生材料包
ZIP · 约 85 KB
含三个练习的 22 个素材文件、总手册、三份练习分册与 FAQ(Markdown 和 HTML)。解压后按手册复制对应练习文件夹;公司、人名、单据和制度均为教学虚构。
本页目录
三个练习(每个练习一页:练习一、练习二、练习三,含讲解录播):
| 练习 | 做什么 | 对应的模式 | 项目文件夹 |
|---|---|---|---|
| 练习一:两路分头读,靠文件交接,主代理汇总 | 主代理派两个子代理,各读一份宏观数据表、各写一页小结;主代理读两份小结写综合简报 | 模式一 主控派活+模式二 并行分头做再汇总;靠文件交接 | 两路宏观小结/ |
| 练习二:一做一审,审一轮、改一轮 | 给一份写好的简报,派一个只读的审阅子代理按清单挑错,主代理按意见逐条改 | 模式四 评估优化迭代(一做一审,审一轮) | 简报审阅/ |
| 练习三:三路独立审核同一批报销单,交叉比对 | 三个子代理按同一份制度、各自独立审核同一批报销单,主控逐单比对,一致才采纳,不一致的交给人 | 模式二 几路独立做同一件事,再比对取共识 | 报销交叉审核/ |
材料包里每个练习一个文件夹,放了这个练习要用的数据、简报、单据和制度,见各练习“准备”一节和 材料包/材料包说明.md。
每一步写两样:做什么;做对了会看到什么。“做对了会看到”里引用的屏幕文字和文件内容,来自一次实际试跑(Claude Code 2.1.296,在终端里运行,模型接 DeepSeek)。模型每次的措辞、用时和挑出的问题条数会不一样,对照的是结构:有没有派出子代理、文件有没有写出来、该有的几项在不在。灰底方框是常识,已经会的跳过。
开始之前
在终端里用 Claude Code
和 W04 一样,本手册的操作都在终端里运行 claude:VS Code 菜单“终端 → 新建终端”,在下方终端里输入 claude 回车。VS Code 图形面板里显示的内容和本手册有些地方不一样,按终端写的为准。
什么是“派子代理”
你在对话里对 Claude Code 说“派两个子代理……”,它会把任务写成一段说明交给子代理。子代理在自己的上下文里读文件、写文件,做完只交回一句话;它读过的大段内容不回到你和主代理的这段对话里。主代理要用子代理的成果,就去打开子代理写出的文件。
提示词里直接写“子代理”就行,试跑时不用加英文也能派出来。派出去之后,屏幕上会出现这样几行:
⏺ 2 background agents launched (↓ to manage)
├ 写生产与景气交接文件
└ 写物价与货币交接文件
✻ Waiting for 2 background agents to finish
⏺ Agent "写生产与景气交接文件" finished · 10s
├、└ 后面是主代理给每个子代理起的名字,每次不一样。子代理在后台跑,主代理在等的时候可能先做点别的。行尾提示 ctrl+o to expand 的地方,按 Ctrl + O 可以展开看详细过程,再按一次收起。
💡 常识:权限模式与弹窗
屏幕最下面一行显示当前权限模式,试跑时是
⏵⏵ auto mode on:Claude Code 自己判断哪些操作风险低就直接做。你的电脑上可能是别的模式,它要写文件、运行命令时会弹出请你批准的选项,看清是在本项目文件夹里写文件,选Yes回车。按Shift + Tab可以切换模式。接国内模型时,启动或第一次派子代理时可能弹出一段英文说明(例如 auto mode 计费方式的通知、
isn't described by this version's model catalog的提示),不影响使用:前者按回车继续,后者是一行黄字,不用管。
省 token 的几个做法
多代理比一个代理费 token:每个子代理都要重新读一遍任务说明和材料,派得越多、审得越多轮,用得越多。下面几个做法可以少花:
- 子代理用便宜一档的模型。主代理要统筹,用好一点的模型;子代理做的是读表、写小结、照清单核对,便宜的模型一般够用。用 CC Switch 或
settings.json配 DeepSeek 的,CLAUDE_CODE_SUBAGENT_MODEL一项填 Flash 档(见下面的常识框),子代理就用这一档。 - 限定输出长度。给子代理写清“每份不超过 300 字”“做完只回复一句:文件路径和状态”。子代理交回的话越短,主代理的对话越干净,后面每一轮要带着走的内容也越少。
- 定好轮数上限。审阅写“只审一轮”或“最多两轮”。不写的话,它可能审了改、改了再审,一直转下去。
- 一个练习一个会话。做完一个练习,退出 Claude Code(两次
Ctrl + C)再在下一个项目文件夹里启动。上一个练习的对话不会被带进下一个练习,每轮请求要带的内容就少。 - 自己先看一眼材料。打开数据表、简报、单据扫一遍,比让它“先把所有文件读一遍讲给我听”省得多。
- 随时看用了多少。在 Claude Code 里输入
/cost回车,弹出的面板里Usage by model一行列出本次会话的输入(input)、输出(output)和缓存读取(cache read)token 数;按Esc关掉。接国内模型时,面板上的美元金额是按 Claude 的价格估的,不准,看 token 数,以模型平台控制台里的账单为准。
💡 常识:Claude Code 接国内模型
Claude Code 可以接 DeepSeek 等国内模型,按对方平台的价格计费。W01 的环境安装手册已经讲了用 CC Switch 接 DeepSeek 的做法(https://ai.lingnan.top/materials/2026-autumn/w01/installation),这里补两点:
- 主模型和子代理模型可以分开配。几个“模型”项(
ANTHROPIC_MODEL等)决定主代理用哪个模型;CLAUDE_CODE_SUBAGENT_MODEL决定子代理用哪个。DeepSeek 官方文档(2026-10-11 查)现在建议 Flash 档的模型名写deepseek-flash,旧名deepseek-v4-flash仍可用,按 Flash 价格计费。- 只想在一个终端窗口里临时换模型,可以不改配置文件,在启动
claude之前先运行几行环境变量(sk-你的密钥换成你自己的 API Key;关掉这个终端窗口就失效):Mac:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=sk-你的密钥 export ANTHROPIC_MODEL=deepseek-flash export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash claudeWindows PowerShell:
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥" $env:ANTHROPIC_MODEL="deepseek-flash" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash" $env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash" claude这样启动后,欢迎框第二行显示
deepseek-flash,上方会有一行黄字说这个模型名“isn't described by this version's model catalog”,并按 200k 上下文处理。本周三个练习用不到那么长的上下文,不影响;主模型名后面加[1m](如deepseek-flash[1m])可以用满 1M 上下文,写法同 W01 手册。注意:
~/.claude/settings.json的env里写了同名项的,以文件为准,临时变量不起作用(W01 手册有说明)。API Key 只放在自己电脑上,不发给别人,不写进任何文件和截图。
🎬 演示视频:两个代理各用一个 worktree,改同一份网页
时长 6 分 1 秒,带字幕和讲解。播放器右下角可以全屏。
这段视频演示什么
一份宏观数据网页有生产、货币、物价三个板块。两位代理分头改前两个板块:各自另开一个工作目录(worktree)、各自新开一条分支,改完再合回主分支。整个过程在 WorkBuddy 里完成,老师只说要什么结果,建仓库、提交、合并用什么命令都交给代理。
分段导览
点击时间可打开视频对应位置。开场讲完后,直接切到 WorkBuddy 输入指令;原先选工作空间的准备过程不再重复。
| 时间 | 步骤 | 看什么 |
|---|---|---|
| 0:00 | 开场导言 | 初始项目目录、任务场景、为什么这样做、对应知识点和三步看点 |
| 0:36 | 初始化 | 让代理建仓库、做第一次提交。有了这次提交,两路修改才有同一个起点 |
| 1:25 | 代理 A | 指令要求另开工作区、新开自己的分支,只改生产板块 |
| 1:53 | 代理 B | 切到另一个会话,同样另开工作区和分支,只改货币板块 |
| 2:43 | 分叉检查 | 版本图上两条线已经分开,各有新提交;主分支还停在原版 |
| 3:07 | 合回主分支 | 先合货币分支,再合生产分支;第二次合并碰到冲突 |
| 4:03 | 合并后核验 | 代理发现一句过时的说明,修正后打开主分支的实际网页逐项核对 |
三个要点
- worktree 分开的是工作目录。 两位代理各在自己的目录里编辑和提交,不会覆盖对方的文件;版本历史仍在同一个仓库里。
- 目录隔开了,内容冲突还要处理。 两边都改了顶部总述和版本号,同一个位置出现两种写法,合并时要综合成一个版本。
- 合并完成和内容验收是两件事。 Git 能把改动合在一起,不保证每句话都符合合并后的情况。视频里合并没有再报错,但页面上还留着一句“货币金融板块没有改动”,要打开实际网页才看得出来。
核对时留意
- 验收看主分支的实际网页,不看同名文件的旧预览。
- 没有分配修改的物价板块要保持原样。
- 数字按原材料核对,区分“点”和“百分点”:视频里 GDP 回落 0.7 个百分点,PMI 上升 0.6 点。
说明
- 网页里的数字是课程材料的示例数据,不是最新宏观数据。
- 等待代理运行的画面做了加速,操作本身由 WorkBuddy 完成。
- 这段录屏里两路修改主要是先后完成的,用来看工作区隔离与合并,不用来说明并行能快多少。
附:要记住的几件事
- 子代理在自己的上下文里干活,交回一句话;要用它的成果,打开它写的文件。
- 交接靠文件:写清读了什么、结论和证据、没核实什么、下一位做什么。
- 审阅者只拿成品、原始数据和标准,不拿作者的思路;只写意见,不动手改;轮数先定好。
- 几路独立做同一件事,比对出的是“意见不一”的地方,交给人定;一致的也要抽查。
- 多派一个子代理、多审一轮,都要多花 token。先问值不值,再决定派几个、审几轮。