Agent 创收指南免费公开资源
中文 EN العربية

返回目录 / Agent 运维

采集 CLI stderr 诊断信息

用 stderr 回调收集警告与错误行,为连接或 CLI 故障提供诊断依据。

目标

在不混淆模型输出的前提下捕获 Agent CLI 侧错误线索。

步骤

  1. 定义接收 message: str 的同步 stderr_callback,仅存储或筛选需要的行。 [stderr]
  2. 通过 ClaudeAgentOptions(stderr=stderr_callback) 传入 query(..., options=...)。 [stderr]
  3. 为诊断临时记录错误类别及时间;若需 verbose 日志,按示例使用受控 debug-file 并设置保留期限。 [stderr]

验证方式

stderr 回调被调用且日志与 AssistantMessage 正文分开存储。

故障处理

若没有诊断行,先检查 SDK/CLI 版本和错误是否写到 stderr;不要假定无 stderr 即成功。

权限边界

前置条件

权限边界

限制

stderr 可能含本地路径或用户数据;debug 文件不是结构化审计记录,需限制访问和保留时间。

固定上游来源

https://github.com/anthropics/claude-agent-sdk-python/blob/b6e9d12fe1cc98dde988ab7b7713c1feeee50c6c/examples/stderr_callback_example.py

仓库
anthropics/claude-agent-sdk-python
文件路径
examples/stderr_callback_example.py
固定提交
b6e9d12fe1cc98dde988ab7b7713c1feeee50c6c
来源检查
2026-10-14 · 已按固定上游来源核对

仓库指标

以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。

Stars
未取得
Forks
未取得
观测时间
未取得

尚未取得指标快照。

许可证: MIT

主主题

让编码 Agent 从理解上下文走到验证修改

相关资源