跳到主内容

course materials · 2026 秋季本科

上机材料:三个练习导航

Week 6 · 2026-10-13 · 上机材料

返回本周材料

W06 三个练习的导航:每个练习做什么、对应哪种协作模式;开始之前怎样派子代理、省 token;Git worktree 实机演示视频(6 分 1 秒)与分段导览。

切换上机材料(4 篇)

W06 学生材料包

ZIP · 约 85 KB

含三个练习的 22 个素材文件、总手册、三份练习分册与 FAQ(Markdown 和 HTML)。解压后按手册复制对应练习文件夹;公司、人名、单据和制度均为教学虚构。

下载材料包
本页目录

W06 材料入口 · 下载学生材料包 · 常见问题

三个练习(每个练习一页:练习一、练习二、练习三,含讲解录播):

练习做什么对应的模式项目文件夹
练习一:两路分头读,靠文件交接,主代理汇总主代理派两个子代理,各读一份宏观数据表、各写一页小结;主代理读两份小结写综合简报模式一 主控派活+模式二 并行分头做再汇总;靠文件交接两路宏观小结/
练习二:一做一审,审一轮、改一轮给一份写好的简报,派一个只读的审阅子代理按清单挑错,主代理按意见逐条改模式四 评估优化迭代(一做一审,审一轮)简报审阅/
练习三:三路独立审核同一批报销单,交叉比对三个子代理按同一份制度、各自独立审核同一批报销单,主控逐单比对,一致才采纳,不一致的交给人模式二 几路独立做同一件事,再比对取共识报销交叉审核/

材料包里每个练习一个文件夹,放了这个练习要用的数据、简报、单据和制度,见各练习“准备”一节和 材料包/材料包说明.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:每个子代理都要重新读一遍任务说明和材料,派得越多、审得越多轮,用得越多。下面几个做法可以少花:

  1. 子代理用便宜一档的模型。主代理要统筹,用好一点的模型;子代理做的是读表、写小结、照清单核对,便宜的模型一般够用。用 CC Switch 或 settings.json 配 DeepSeek 的,CLAUDE_CODE_SUBAGENT_MODEL 一项填 Flash 档(见下面的常识框),子代理就用这一档。
  2. 限定输出长度。给子代理写清“每份不超过 300 字”“做完只回复一句:文件路径和状态”。子代理交回的话越短,主代理的对话越干净,后面每一轮要带着走的内容也越少。
  3. 定好轮数上限。审阅写“只审一轮”或“最多两轮”。不写的话,它可能审了改、改了再审,一直转下去。
  4. 一个练习一个会话。做完一个练习,退出 Claude Code(两次 Ctrl + C)再在下一个项目文件夹里启动。上一个练习的对话不会被带进下一个练习,每轮请求要带的内容就少。
  5. 自己先看一眼材料。打开数据表、简报、单据扫一遍,比让它“先把所有文件读一遍讲给我听”省得多。
  6. 随时看用了多少。在 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
claude

Windows 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合并后核验代理发现一句过时的说明,修正后打开主分支的实际网页逐项核对

三个要点

  1. worktree 分开的是工作目录。 两位代理各在自己的目录里编辑和提交,不会覆盖对方的文件;版本历史仍在同一个仓库里。
  2. 目录隔开了,内容冲突还要处理。 两边都改了顶部总述和版本号,同一个位置出现两种写法,合并时要综合成一个版本。
  3. 合并完成和内容验收是两件事。 Git 能把改动合在一起,不保证每句话都符合合并后的情况。视频里合并没有再报错,但页面上还留着一句“货币金融板块没有改动”,要打开实际网页才看得出来。

核对时留意

  • 验收看主分支的实际网页,不看同名文件的旧预览。
  • 没有分配修改的物价板块要保持原样。
  • 数字按原材料核对,区分“点”和“百分点”:视频里 GDP 回落 0.7 个百分点,PMI 上升 0.6 点。

说明

  • 网页里的数字是课程材料的示例数据,不是最新宏观数据。
  • 等待代理运行的画面做了加速,操作本身由 WorkBuddy 完成。
  • 这段录屏里两路修改主要是先后完成的,用来看工作区隔离与合并,不用来说明并行能快多少。

附:要记住的几件事

  1. 子代理在自己的上下文里干活,交回一句话;要用它的成果,打开它写的文件。
  2. 交接靠文件:写清读了什么、结论和证据、没核实什么、下一位做什么。
  3. 审阅者只拿成品、原始数据和标准,不拿作者的思路;只写意见,不动手改;轮数先定好。
  4. 几路独立做同一件事,比对出的是“意见不一”的地方,交给人定;一致的也要抽查。
  5. 多派一个子代理、多审一轮,都要多花 token。先问值不值,再决定派几个、审几轮。