在线总手册下载材料包常见问题练习1练习2练习3

练习一:两路分头读,靠文件交接,主代理汇总

准备

材料包 01_两路分析/:

文件 内容
数据/生产与景气.csv GDP 当季同比(2025Q1—2026Q2)、制造业 PMI(2025-09—2026-08)
数据/物价与货币.csv CPI 同比、M2 同比(2025-09—2026-08)
交接文件要求.md 子代理写小结要答的六问

练习一是一个很小的流程:不现场取数,不写长分析,看清“两路分头跑、写文件、主代理读文件汇总”这条路走通了。

第 0 步:建项目

做什么

  1. 把材料包里的 01_两路分析 文件夹整个拷到你放作业的位置,改名 两路宏观小结。
  2. VS Code 菜单“文件 → 打开文件夹”,选 两路宏观小结。
  3. 菜单“终端 → 新建终端”,输入 claude 回车。第一次在这个文件夹启动,它会问是否信任这个文件夹:按 ↓ 选到 Yes, I trust this folder,回车。

做对了会看到:左侧文件栏是 两路宏观小结,下面有 数据 和 交接文件要求.md;终端里出现 Claude Code 的欢迎框,第三行是你这个文件夹的路径;欢迎框第二行是你接的模型名(试跑时是 deepseek-flash · API Usage Billing)。

第 1 步:自己先看一眼材料

做什么:在 VS Code 文件栏里点开两份 CSV 和 交接文件要求.md,各扫一遍。

做对了会看到:生产与景气.csv 18 行数据,物价与货币.csv 24 行;每行有指标、期间、数值、单位、来源机构、来源URL、发布日期或取数日期。交接文件要求.md 是六问:解决什么问题、读过哪些来源、结论与证据、下一位该做什么、初稿还是核对版、还要人决定什么。

GDP 是季度数据,到 2026Q2;另外三个指标是月度数据,到 2026-08。记住这一点,第 3 步要看主代理有没有处理。

第 2 步:派两个子代理,各写一份交接文件;主代理读文件写综合简报

做什么:把下面这段话粘贴进输入框,回车。

这个项目要做一份很短的宏观小结。你当主代理,按下面的分工做:
1. 同时派两个子代理,互相不看对方的结果:
   子代理 A 只读 数据/生产与景气.csv,按 交接文件要求.md 写 协作记录/生产与景气.md;
   子代理 B 只读 数据/物价与货币.csv,按 交接文件要求.md 写 协作记录/物价与货币.md。
   每份不超过 300 字。子代理做完只回复一句:文件路径和状态,不复述内容。
2. 两个文件都写好后,你自己打开这两个文件读(不靠子代理的回复),对齐期间与口径,写 简报成品/综合简报.md,不超过 500 字,每个数字注明期间。
3. 最后用三五行告诉我:两个子代理各读了什么、写了什么文件;你综合时做了哪一项对齐。

做对了会看到

  1. 它先看一眼文件夹,然后派出两个子代理。试跑时的屏幕:

    ⏺ 2 background agents launched (↓ to manage)
       ├ 写生产与景气交接文件
       └ 写物价与货币交接文件
    
  2. 十几秒后,两行 Agent "…" finished,后面是各自的用时(试跑时 10—20 秒)。左侧文件栏出现 协作记录/,里面两份 .md。

  3. 主代理打开这两个文件(屏幕上有 Read 2 files),再写 简报成品/综合简报.md(屏幕上有 Write(简报成品/综合简报.md))。

  4. 最后它用几行话说明:A 读了哪份表、写了哪个文件,B 同样;综合时对齐了什么。试跑时它这样说对齐:

    我综合时做的对齐:两份表频率不一致(生产表里 GDP 是季度、PMI 是月度;物价表两个指标都是月度)。
    我把三条月度指标统一取共同窗口 2025-09~2026-08,GDP 只取与窗口重叠的 2025Q3~2026Q2,不做跨频率折算。
    

整个过程试跑时一分半钟左右。

第 3 步:读三份文件,人核一个数

做什么

  1. 打开 协作记录/生产与景气.md、协作记录/物价与货币.md,对照 交接文件要求.md 看六问是否都答了。
  2. 打开 简报成品/综合简报.md,看它怎么处理季度和月度对不上的问题。
  3. 从综合简报里任挑一个数字(例如制造业 PMI 2026-08),回 数据/ 里的原表找到那一行,核对数值和期间。

做对了会看到

✅ 练习一自查

想一想:主代理读到的是两份几百字的小结,而不是两张原表。如果有二十张表、二十个子代理,这样交接省在哪里?哪一步最容易出错?


开始之前

在终端里用 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),这里补两点:

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 只放在自己电脑上,不发给别人,不写进任何文件和截图。