Claude Code 会话怎么收成 Claude Docs spec 或 runbook

Anthropic 2026 年 9 月 Claude Docs beta 支持从 Claude Code 终端或 desktop 把当前 session 转为 spec、runbook、readout。本文写操作路径、权限与和 Cowork 的分工。

Claude Code 会话怎么收成 Claude Docs spec 或 runbook

Claude Docs beta（2026-09-16 随 One Claude 发布）不只给 Chat 用户：Help Center 明确 Claude Code 里可以「把当前 session 变成 spec、runbook 或 readout」。Desktop 在侧栏打开 doc；纯终端则给 web 链接。这对「Agent 改了一晚上代码，早上要给同事一份可读说明」的场景，比复制 chat log 干净。

作者：CodePass 技术编辑

前置条件

账号：Pro、Max、Team 或 Enterprise（Docs beta 不含 Free）。

Enterprise：默认 Docs 关闭，需 owner 在 Organization settings > Artifacts 开启；CMEK/ZDR/HIPAA-ready 暂不支持。

Claude Code 版本：随 One Claude rollout，建议 claude --version 到 2026-09 中旬 changelog 段。

额度：长 session 转长 doc 消耗 message/token，与 9/14 周 cap 同一桶；大文档前先 /compact 或新开会话专做 doc。

推荐工作流

  1. 在 Claude Code 完成实现或 spike，保留关键 decision 在对话里（别 /clear）。

  2. 提示词示例方向：「把本会话收成 engineering spec：背景、决策、未决问题、测试命令；格式适合 Claude Docs。」

  3. Desktop：侧栏打开 doc，补人工 comment；终端：打开返回的 web 链接编辑。

  4. 需演示给非工程同事：在同一 Docs 里让 Claude 生成 Claude Slides 摘要页。

  5. 分享：Team 内 link；勿把含密钥路径的 session 直接 export（即使 ultrareview 已过滤 prod.env，对话文本仍可能含 token）。

和 Cowork / Cursor 怎么选

Cowork：批量改本地文件夹、多文件自动化，偏「执行」。

Claude Code → Docs：偏「记录决策与交接」。

Cursor：IDE 内无原生 Docs；可 export markdown 或用 Cursor Projects 协调，但 collab 编辑弱于 Claude Docs。

OpenAI 侧 ChatGPT Work + Codex 是对位产品，见 Codex 软件工厂 内部用法；外部团队按订阅选边。

安全提醒（9 月 Git 漏洞语境）

Docs 导出不会执行 .git/config，但 session 内容若来自不可信 repo 的 Agent 输出，仍可能含恶意链接。intake 先过 GitSpawn 总览。ultrareview 用户另见 CHANGELOG 2.1.248 密钥过滤与 GitSpawn 总览表 ultrareview 行（THN 2026-09-17）。

参考资料