Claude Code 會定期把後台 Agent 的 transcript 送回模型。這不僅影響上下文成本,也可能擴大敏感資訊的曝露範圍。本文將拆解同步機制,並提出可供實作的稽核方法。
Claude Code 後台代理日誌機制深度解析
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
後台 Agent 的 transcript 到哪去了
先區分三個經常混為一談的概念:
- Agent 的工作紀錄:執行過哪些命令、讀取過哪些檔案,以及修改過哪些程式碼。
- transcript:依序組織起來的會話紀錄。
- 模型上下文:目前請求實際傳送給模型的內容。
後台 Agent 獨立執行時,模型一開始只會看到任務描述。接著,Agent 可能呼叫檔案讀取、Shell、搜尋等工具。工具結果會回到後台執行環境,主會話並不會自然擁有完整過程。
Claude Code 會定期把每個後台 Agent 的會話 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 命令及其標準輸出;
- 檔案路徑、目錄結構與相依套件資訊;
- 環境變數、使用者目錄與部署設定;
- Agent 處理過程,以及工具呼叫參數。
它的風險範圍大於單獨上傳的程式碼檔案。程式碼檔案通常是使用者主動選擇並傳送的內容;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
再搭配本機匯出入口,保存目前會話即將傳送的上下文。先對敏感欄位去識別化,再過濾憑證。如此雖不能消除所有風險,但至少能把隱藏機制轉化為可檢查的對象。
編輯觀察
後台 Agent 日誌回傳的核心矛盾,不在於「是否上傳」,而在於使用者能否看清上傳內容、用途與成本。Claude Code 將後台 transcript 週期性送回模型,換來全域狀態同步;代價則是重複輸入、額外延遲,以及更廣的敏感資訊曝露範圍。
這與一般聊天紀錄不同:聊天紀錄通常對應使用者主動傳送的訊息,transcript 卻會夾帶命令輸出、路徑、環境資訊與 Agent 處理過程。
後續的競爭重點,可能不只是 Agent 能否執行長任務,而是企業能否稽核每一次同步。可關閉、可匯出,以及可依批次檢視請求載荷,可能比模型能力提升更早成為採購門檻。
目前資料能確認回傳機制與社群爭議,但尚未完整揭露服務端保留週期及實際壓縮策略,因此不能僅憑這份 Gist 判斷真實的資料邊界。