启动参数看官方文档重新发出stdin中的用户消息到stdout进行确认Syntax--replay-user-messages示例claude -p --input-format stream-json --output-format stream-json --replay-user-messages全网调研整理典型场景配合 enable_file_checkpointing=True 使用时必须开启,用于在 stream-json 输出流中获取每条用户消息的 UUID 作为文件还原点构建程序化 agent 管道时,通过捕获用户消息回显来确认 CLI 已接收并处理 stdin 输入多轮对话中追踪每个 turn 的边界 UUID,实现多个检查点(checkpoint)以支持跨 turn 的精准文件回退在自动化 CI/CD 场景中,用于审计日志或调试——将用户消息事件嵌入输出流以便事后重放分析实用技巧在 Python SDK 中通过 extra_args={"replay-user-messages": None} 传递,TypeScript 用 extraArgs: { 'replay-user-messages': null },无需手拼 CLI 参数字符串捕获 stream 中第一条 UserMessage 的 uuid 即可作为「会话开始前」状态的还原点,覆盖最常见的「全量撤销」场景将所有 UserMessage UUID 存入数组可实现多还原点:可回退到任意中间 turn,而非只能回到最初始状态回退文件时必须先 resume 会话并发送空 prompt(""),再调用 rewindFiles(checkpointId)——流结束后直接调用会报 ProcessTransport 错误也可从 CLI 直接回退:claude -p --resume <session-id> --rewind-files <checkpoint-uuid>,不需要写 SDK 代码常见坑不设置此 flag 时,stream 中 UserMessage 的 uuid 字段为 undefined,file checkpointing 功能完全失效且不会报错在 Claude 活跃 turn(工具执行期间)通过 stdin 发送的消息不会持久化到会话历史 JSONL 文件,影响 replay 一致性(Issue #41230)此 flag 长期未出现在官方 CLI reference 文档中(Issue #20763),但 file checkpointing 指南强依赖它,升级 SDK 后需确认 enable_file_checkpointing 是否已内置处理该 flag 以避免重复传递来源Rewind file changes with checkpointing - Claude Code Agent SDK[DOCS] CLI flag `--replay-user-messages` required for file checkpointing but not in CLI reference · Issue #20763[DOCS] `--input-format stream-json` usage is undocumented · Issue #24594Messages sent to stdin during active turn are not persisted · Issue #41230Run Claude Code programmatically - Claude Code Docs创建于v1.0.86最近更新v1.0.86变化次数1新增 1变化时间线(按版本倒序)新增v1.0.86· 2025/08/21 · 2025/08/21新增 CLI flag 以将用户消息重放回 stdout。上一个--remote-control-session-name-prefix回到命令字典下一个--resume