Claude Code 与 Codex CLI 会话怎么实时分享?生成只读直播链接

想让同事或客户实时查看 Claude Code、Codex CLI 的对话进展,不必共享屏幕或交出控制权。本文演示如何生成公开只读会话链接,开启 1、6 或 24 小时实时刷新,并说明快照、成果页与连接共享的区别及隐私边界。

PandaNpc本文首发于
暖色绘本插画:发起者的 AI 对话通过分享链接同步显示在两位观看者的平板和电脑上
实时对话分享示意:发起者继续与 AI 工作,观看者通过同一链接只读查看更新。

可以,而且不需要共享屏幕或把代理控制权交给对方。 在 PandaNpc 的 Claude Code 或 Codex CLI 会话里生成一个公开只读链接,再打开“实时刷新”,访客就能在浏览器里看到已有对话、后续消息以及工具输出。直播时长可选 1、6 或 24 小时;停止直播后,链接仍显示最后一次快照,需要彻底失效时再撤销分享。

这适合结对调试、远程演示、客户验收和异步评审。Claude Code 与 Codex CLI 仍在你的开发机上运行,访客只是观看者。两种 CLI 的安装和运行方式可分别参考 Anthropic 的 Claude Code 入门文档与 OpenAI 的 Codex CLI 文档。

先分清:快照、实时分享和连接共享不是一回事

方式 访客看到什么 能否实时更新 能否发送指令或批准命令 适合场景
会话快照 生成链接时的完整对话 否 否 发记录、留档、异步阅读
会话实时分享 快照 + 后续消息和工具输出 是 否 直播调试、演示、旁观协作
成果页 AI 提炼的总结、改动和结果 更新快照后重建 否 汇报、交付、作品展示
连接共享 对方进入你的编码代理连接 是 可以 只与可信协作者共同操作
Snapshot、Live Session、Result Page 与 Connection Sharing 的权限对比
实时会话分享是公开只读观看;连接共享则允许协作者实际操作代理,两者权限完全不同。

本文讲的是前两种:先生成公开只读快照,再按需打开实时刷新。如果你只想展示最终产出,可改用会话成果页;如果对方需要实际发送指令,请先阅读共享 Claude Code 连接的权限边界。

开始前需要什么

  • 开发机上的 Claude Code 或 Codex CLI 已经可以正常工作;
  • PandaPaw 已连接该开发机,并且目标会话能在 PandaNpc Agent 中打开;
  • 会话里至少已有一条可分享的消息;
  • 你已经检查过历史内容,确认其中没有密码、API Key、私钥、客户数据或其他不该公开的信息。

分享链接无需访客登录。方便之处也意味着它本质上是一个 bearer link:任何拿到链接的人都能查看。因此不要把“链接难猜”当成权限控制。

如何实时分享 Claude Code 或 Codex CLI 会话

第一步:打开要分享的会话

进入 PandaNpc Agent,选择运行 Claude Code 或 Codex 的项目,再打开正在执行或已经完成的会话。先检查标题和对话内容,确保你分享的是正确项目。

第二步:生成公开只读链接

点击会话右上角的分享按钮。首次分享时:

  1. 选择链接有效期:7 天、30 天或永久;
  2. 如果需要结构化总结,保留“生成成果页”;只想直播原始对话时可以关闭;
  3. 点击生成链接并复制。

生成链接的瞬间会保存当前完整对话作为快照。即使之后没有开启直播,访客也能通过该链接阅读这份快照。

第三步:开启“实时刷新”

链接生成后,在同一个分享弹窗中找到实时刷新,选择 1 小时、6 小时或 24 小时,再点击“开始直播”。页面会显示剩余时间;任务比预计更久时,可以延长直播窗口。

从编码代理会话生成只读链接并开启实时刷新的流程
创建快照链接后开启 1、6 或 24 小时的 Live Refresh,访客浏览器会持续取得新消息。

第四步:用无痕窗口验证

不要只相信“链接已复制”。在无痕窗口或另一台未登录设备中打开分享链接,然后在原会话发送一条不含敏感信息的测试消息。访客页通常会在约 3~10 秒内出现新内容,并显示直播状态。

这一步同时验证了四件事:公开链接可访问、访客不需要登录、当前直播窗口有效、新消息确实来自正确会话。

访客能实时看到什么

开启直播后,拿到链接的人可以看到:

  • 开始分享时已经存在的完整对话;
  • 直播期间新增的用户消息和代理回复;
  • 后续工具输出,包括读取到的文件内容、Shell 命令及其输出;
  • 会话是否仍在工作,以及模型、上下文和文件改动等只读状态;
  • 如果生成了成果页,还可以切换到结构化的结果摘要。

访客不能通过这个页面发送消息、回答代理问题、批准命令或控制开发机。想从手机继续操作自己的 Codex,请使用Codex CLI 远程控制方案,不要把观看链接误当作远程控制入口。

隐私与安全:开始直播前必须检查

实时分享比普通快照更需要谨慎,因为你还不知道代理接下来会读取什么。开始前至少完成下面几项检查:

  1. 清理历史内容。 已经出现在对话中的密钥和文件片段,会随初始快照一起公开。
  2. 预判后续工具调用。 代理读取 .env、配置文件、日志或客户数据后,相应工具输出可能直接出现在访客页。
  3. 选择最短够用时长。 十几分钟的演示通常选 1 小时,不必为了省一次点击直接开 24 小时。
  4. 只发给需要观看的人。 公开只读不等于适合公开发布;群聊转发仍可能扩大传播范围。
  5. 结束后停止或撤销。 停止直播只会冻结为最后快照;要让原链接完全不可访问,必须撤销分享。
实时分享前后的安全检查与停止、撤销关系
直播窗口到期或手动停止后,页面保留最后快照;只有撤销分享才会让链接失效。

还有一个容易混淆的点:会话分享是只读,连接共享是可操作。 后者可能允许对方在你的主机上发指令和批准工具调用,只应给可信成员使用。

直播结束后会发生什么

直播有三种结束方式:

  • 到达 1、6 或 24 小时的截止时间后自动停止;
  • 你在分享弹窗里手动点击“停止直播”;
  • 你撤销整个分享。

前两种只停止继续更新,访客仍能阅读截至停止时的快照。撤销分享则会让原公开链接失效。以后重新分享同一会话时,应把它当作一个新的公开入口,再次检查内容和有效期。

常见问题排查

已经开启实时刷新,但访客只看到旧快照

先确认分享弹窗仍显示“直播中”和剩余分钟数,再检查开发机、PandaPaw 与目标会话是否在线。实时数据暂时不可用时,页面会安全地退回最后快照,不会因此开放额外权限。

也可以让访客把页面切回前台。浏览器标签长期处于后台时会暂停刷新,重新打开标签后会继续获取新消息。

新消息不是立刻出现

访客页采用近实时刷新,而不是逐字符同步。一般几秒内更新;连续没有新消息时,刷新间隔会逐步放宽到约 10 秒,以减少无意义请求。这种延迟不影响会话在开发机上继续执行。

“开始直播”后开关又关闭

通常说明服务端没能定位当前在线会话。确认你是在目标会话内操作、设备仍在线,并刷新 Agent 页面后重试。历史快照仍然可读,不需要反复生成新链接。

链接显示不存在或已经失效

检查是否复制完整、是否超过 7/30 天有效期,或者是否已经撤销。过期或撤销的链接不能由访客恢复,只能由分享者重新生成。

成果页一直在生成

成果页需要额外的 AI 总结,因此可能比只读快照更晚出现。它与实时刷新彼此独立:即使成果页还在生成,原始会话直播仍可正常观看。

FAQ

Claude Code 和 Codex CLI 都能用同一个方法分享吗

可以。只要相应会话已经出现在 PandaNpc Agent 中,就从会话右上角使用同一个分享入口。页面只需要一篇,因为核心任务都是“把 AI 编码会话变成公开只读的实时观看链接”。

访客需要 PandaNpc、Claude 或 ChatGPT 账号吗

不需要。分享页是公开只读页面,访客用浏览器打开即可。也正因为无需登录,链接应按敏感信息对待。

访客能控制 Claude Code 或 Codex 吗

不能。会话分享页只能观看,不能发送消息、批准命令或操作主机。如果你需要双人共同操作,应使用权限更高的连接共享,并只邀请可信协作者。

这和屏幕共享有什么区别

屏幕共享传输整个桌面画面,通常还要保持会议或投屏连接;会话分享只呈现这条 AI 编码会话的结构化消息和工具输出。访客可以自己滚动、回看,也不会看到桌面上的其他窗口。

停止直播会删除链接吗

不会。停止后链接保留最后快照;选择“撤销分享”才会使链接失效。

可以只分享最终结果,不公开完整对话吗

可以。在分享时生成成果页,用结构化摘要展示做了什么、修改了哪些文件和还有哪些待办。需要注意:同一分享链接仍可能提供完整会话入口;如果原始对话不适合公开,应先清理内容或不要创建公开分享。

小结

实时分享 Claude Code 或 Codex CLI 会话,最稳妥的流程是:先检查内容,生成公开只读快照,选择最短直播时长,用无痕窗口验证,结束后停止或撤销。 它保留了现场观看 AI 编码过程的价值,同时把访客权限限制在只读范围内。

准备开始时,打开 PandaNpc Agent,选择目标会话并点击右上角分享按钮即可。