Claude Code 会定期把后台 Agent 的 transcript 送回模型。这会影响上下文成本,也可能扩大敏感信息暴露面。本文拆解同步机制,并给出审计方法。
Claude Code 会定期把每个后台 Agent 的会话 transcript 发送回其模型。
这不是单纯的日志存储问题。它会改变输入 Token、任务延迟和代码泄露边界。
依据发布在 GitHub Gist 的技术说明,Claude Code 的后台 Agent transcript 会周期性回到模型侧。该条目登上 Hacker News 首页时,获得 304 分和 92 条评论。
争议集中在三点:
- 默认回传是否合理;
- 记录保留多久;
- 用户能否检查实际发送内容。
原文:https://gist.github.com/flamerix-ai/c3905705cc4205e5de3011fa2e74efce
Hacker News 条目:https://news.ycombinator.com/item?id=50284255
后台代理的 transcript 去哪了
先区分三个容易混在一起的东西:
- Agent 的工作记录:执行过哪些命令、读过哪些文件、改过哪些代码。
- transcript:按顺序组织起来的会话记录。
- 模型上下文:当前请求实际发给模型的内容。
后台 Agent 独立运行时,模型首先看到任务描述。随后 Agent 可能调用文件读取、Shell、搜索等工具。工具结果返回后台执行环境,主会话不会天然拥有完整过程。
Claude Code 会定期将每个后台代理的会话 transcript 发送回其模型。调用链大致变成:
后台 Agent
├─ 调用模型
├─ 读取文件、执行命令
└─ 累积 transcript
│
└─ 定期回传至模型侧
│
└─ 更新主会话的全局状态
关键不是“日志传到服务器”,而是 transcript 回流后,模型能重新掌握后台任务进度:做过什么、发现了什么、还缺什么。
普通并行任务通常只能等 Agent 结束后收到摘要。摘要有时够用,也可能丢掉关键异常。
但 transcript 回流后,调用链里会多出周期性输入。每轮同步都要读取既有记录,再附加最新片段。输入 Token 不是常量增长,会随着回传次数和记录长度累积。
上下文同步不是免费午餐
上下文同步解决了状态可见性问题,也带来三项成本。
第一是输入 Token
假设 Agent 的一次 transcript 有 12,000 tokens,每隔一个检查周期回传一次,共回传 8 次。仅按重复计入,便可能产生接近 96,000 tokens 的输入量。
这还没有算系统提示词、工具定义和用户消息。
实际实现未必每次都完整重发,可能使用增量、日志引用或压缩。但只要主模型需要保留完整任务状态,长任务仍会推高上下文规模。
第二是延迟
后台 Agent 在本地执行命令时,主循环可能正在等待下一次同步。
同步频繁,模型获得的信息更及时,调用次数也更密。同步稀疏,单次请求更小,但主模型对任务变化的反应更慢。
第三是语义噪声
完整 transcript 不只有最终结论,还有失败尝试、调试输出和被放弃的路径。
这些内容能帮助模型避免重复踩坑,也可能把注意力拉回已经解决的小问题。
摘要与完整 transcript 之间存在明确取舍:
| 方案 | 优点 | 代价 |
|---|---|---|
| 只返回最终摘要 | Token 少、延迟低 | 可能遗漏异常和中间依据 |
| 周期性返回完整 transcript | 状态完整、可追踪 | 输入重复、上下文膨胀 |
| 增量返回关键事件 | 成本与可见性较平衡 | 需要可靠的事件筛选机制 |
下面这个最小观察脚本,可以先测出“完整回传”与“只回传摘要”的输入差异:
import json
def count_tokens(text: str) -> int:
# 粗略估算,只用于比较传输策略,不代表官方 tokenizer。
return max(1, (len(text) + 3) // 4)
def simulate(transcript: str, intervals: int = 8) -> dict:
full_payload = transcript
summary_payload = transcript[:500]
full_input_tokens = intervals * count_tokens(full_payload)
summary_input_tokens = intervals * count_tokens(summary_payload)
return {
"intervals": intervals,
"transcript_chars": len(transcript),
"full_input_tokens_estimate": full_input_tokens,
"summary_input_tokens_estimate": summary_input_tokens,
"extra_input_tokens_estimate": full_input_tokens - summary_input_tokens,
}
if __name__ == "__main__":
transcript = json.dumps({
"events": [
{"tool": "Read", "path": "app.py"},
{"tool": "Bash", "command": "pytest -q", "output": "1 failed"},
{"tool": "Edit", "path": "app.py", "status": "applied"},
]
})
print(json.dumps(simulate(transcript), ensure_ascii=False, indent=2))
这不是 Claude Code 内部实现的复刻,也不能替代官方账单数据。它只说明一件事:同步频率和载荷长度会直接进入成本模型。
更稳妥的默认项,可能是用户可调的同步间隔、关闭后台 transcript 回传的选项,以及长记录的结构化压缩。但这三项都会牺牲一部分自动化体验。
代码泄露风险要从日志边界算
讨论代码上传时,人们常盯着 .env、私有仓库和配置文件。风险评估不能只列源码文件。
完整 transcript 可能包含:
- 源码片段与 diff;
- 测试输出和异常堆栈;
- Shell 命令及其标准输出;
- 文件路径、目录结构和依赖信息;
- 环境变量、用户目录与部署配置;
- 代理处理过程,以及工具调用参数。
它的风险范围大于单独上传的代码文件。代码文件通常是用户主动选择并发送的内容;transcript 则可能把命令输出和执行上下文顺带带走。
例如这条命令本身几乎不含秘密:
python -m pytest -q
但输出可能暴露测试使用的内部域名、数据库主机名、临时目录,或者失败堆栈里的配置值。
另一条常见命令:
env
它会把进程环境直接打印到 stdout。只要 stdout 进入工具结果,transcript 就有机会携带其中的敏感信息。
路径也值得单独计算。日志里的 /Users/alice/private/client-b/project/app.py,即使没有源码,也可能泄露用户名、机器目录结构、客户名称和项目结构。
因此,安全检查不该只发生在“上传某个文件”时,还要覆盖:
- 工具输出进入上下文前是否脱敏;
- transcript 是否被截断或分级;
- 用户能否查看最终请求载荷;
- 服务端保留周期和训练使用政策是否明确;
- 企业策略能否禁止特定命令、目录和凭证进入记录。
这些边界不能靠一句“不会用于训练”替代。是否训练、数据保存在哪里、保存多久,是三个不同问题。
可观测性也有观测者偏差
完整 transcript 的工程价值很直接。
当后台 Agent 修改了错误文件,主模型需要知道它读过什么、运行过哪些命令。完整记录可以用于:
- 重放失败任务;
- 对比预期与实际改动;
- 定位工具调用失败的位置;
- 审计凭证是否进入输出;
- 计算真实 Token 与延迟成本。
没有 transcript,Agent 系统只剩一个最终答案。出了问题,工程师往往无法区分是模型判断错、工具返回错,还是上下文同步漏了信息。
但观察本身会改变被观察的系统。Agent 知道自己的过程可能被回传、评估或用于后续推理后,可能改变表达方式和执行路径。
开发者也会因为日志更完整而更频繁地回看过程,继而追加指令。
这就是观测者偏差。日志越完整,调试越有效;同时,Agent 的行为可能更接近“为读者留下证据”,而不是只完成当前任务。
实践里可以先做一次小型对照:同一仓库、同一任务、同一模型,分别运行 10 次,记录成功率、总输入 Token、执行时长和回退次数。
日志回传机制一旦可配置,就值得把它当实验变量,而不是固定背景。
一次值得追问的产品设计
这条技术 Gist 登上 Hacker News 首页时获得 304 分和 92 条评论。高分说明它击中了开发者的日常经验,评论区则把问题推向产品决策。
常见质疑有三类。
第一类是默认行为。开发者知道模型调用会带上上下文,但未必默认理解后台 Agent 的完整 transcript 也会周期回传。如果默认机制不够显式,知情同意就很难成立。
第二类是数据留存。上传内容、保留时长、服务端访问权限、是否进入改进流程,需要拆开说明。把它们合并成一句隐私承诺,信息量太低。
第三类是可观测性。开发者希望看到“这一次到底上传了什么”,而不只是界面上的对话摘要。
能导出请求载荷、标注工具输出来源、按时间查看同步批次,才便于审计。
一个更可控的设计未必更复杂。至少可以提供类似下面的状态:
/agents
agent-1 running transcript-sync: on
agent-2 waiting transcript-sync: off
再配一个本地导出入口,保存当前会话将要发送的上下文。敏感字段先脱敏,凭证再过滤。这样做不能消除所有风险,但至少把隐藏机制变成可检查对象。
编辑思考
后台代理日志回传的核心矛盾,不是“是否上传”,而是用户能否看清上传内容、用途和成本。Claude Code 把后台 transcript 周期送回模型,换来了全局状态同步;代价则是重复输入、额外延迟,以及更宽的敏感信息暴露面。它与普通聊天记录不同:聊天记录通常对应用户主动发送的消息,transcript 却会夹带命令输出、路径、环境信息和代理处理过程。我的判断是,下一步竞争点不会只是 Agent 能不能跑长任务,而是企业能否审计每次同步;可关闭、可导出、可按批次查看请求载荷,可能比模型能力提升更早变成采购门槛。当前材料能确认回传机制及社区争议,但未完整披露服务端留存周期和实际压缩策略,因此不能仅凭这份 Gist 判断真实数据边界。