AI 会话：把 Claude Code 会话变成文章
用 @postion/cli 把 Claude Code 编程会话私密同步到 Postion，在本机脱敏后上传，一键或自动整理成草稿文章。
AI 会话会把你和 Claude Code 的编程过程同步到 Postion，形成一条只有你自己能看到的时间线。想分享时，一条命令就能把会话整理成草稿文章；也可以为项目开启自动化，让草稿自动生成、甚至延迟自动发布。
整个流程只需要在终端里做一次设置，之后不用再手动操作。
准备工作
- 已安装 Claude Code
- Node.js 18 或更高版本（
npx随 Node 自带） - 一个 Postion 账号，并至少创建了一个站点（草稿会创建在站点下）
快速开始
第 1 步：登录
npx @postion/cli login命令会打开浏览器并显示一个确认码，确认页面上的码与终端一致后点击授权。终端显示 Logged in as <你的用户名> 即完成。
生成的密钥权限很小：只能上传和读取会话、创建私密草稿，不能发布任何内容。可以随时在 控制台 → Developers → API keys 里撤销。
第 2 步：开启自动同步
npx @postion/cli install这一步会在 ~/.claude/settings.json 中添加 Claude Code 的 Stop / SessionEnd 钩子（原文件会备份为 settings.json.postion-backup），并把 CLI 复制到 ~/.postion/runtime，这样即使 npx 缓存被清理，钩子也能正常运行。
之后 Claude Code 每回复一次，会话就会在后台上传，不会拖慢 Claude。新打开的 Claude Code 窗口一定会同步。
第 3 步：导入已有会话（可选）
# 在项目目录里运行：导入这个项目过去的会话
npx @postion/cli sync
# 导入所有项目的会话
npx @postion/cli sync --all第 4 步：把会话变成文章
在 Claude Code 里完成一段工作后，直接对 Claude 说：
运行
npx @postion/cli draft
它会把当前目录最近的一个会话整理成私密草稿，并在浏览器中打开编辑器。你检查、修改后点击发布，文章才会公开。
也可以在网页上操作：进入 控制台 → AI Sessions，打开某个会话，点击 Create draft。
命令一览
所有命令都可以用 npx @postion/cli <命令> 运行；如果经常使用，也可以全局安装 npm i -g @postion/cli，之后直接用 postion <命令>。
| 命令 | 作用 |
|---|---|
login | 在浏览器中确认并登录。也支持 --key <API key> 直接使用已有密钥，--no-browser 不自动打开浏览器 |
install | 为 Claude Code 安装自动同步钩子 |
uninstall | 移除钩子，停止自动同步 |
sync | 立即上传当前目录的会话；--all 上传所有项目；--force 重新上传（包括在网页上删除过的会话） |
draft | 把当前目录最近的会话变成私密草稿。--site <子域名> 指定站点，--tools 在文章中附带工具调用记录，--no-browser 不打开编辑器 |
ignore / unignore | 在项目目录中运行，不再上传 / 恢复上传这个项目的会话 |
status | 查看登录账号、钩子状态、已同步会话数和最近的后台同步记录 |
logout | 退出登录（本地同步记录保留） |
--version / --help | 查看版本 / 帮助 |
草稿是怎么生成的
- 每一轮「你的提问 + Claude 的回答」会成为文章中的一节，标题和摘要会自动生成
- 工具输出永远不会出现在文章里；工具调用默认也不包含，需要时用
--tools或在网页的 Customize 中打开 - 可能包含隐私信息的提问会被自动跳过：公网 IP 地址、数据库连接串、邮箱地址、已脱敏的密钥标记。跳过的内容会列出来，确认无误后可以在网页上勾选加回
- 站点默认使用你上次发布 AI 会话的站点
自动化：自动生成草稿，可选延迟发布
如果不想每次都手动生成草稿，可以按项目授权自动化（只能在网页上开启，CLI 密钥无法修改）：
- 进入 控制台 → AI Sessions，选择项目或打开该项目的任意会话
- 点击 ⚡ Automation off 按钮
- 打开 Create drafts automatically，选择站点
- （可选）打开 Publish automatically after 24 hours
开启后的规则：
- 会话静止 10 分钟、且至少有 3 个提问时，自动生成私密草稿，并通过站内通知和邮件提醒你
- 会话继续进行时，草稿会随之更新；一旦你编辑过草稿，就不会再覆盖你的修改
- 开启自动发布时，草稿会在会话静止 24 小时后发布，前提是整个会话没有任何隐私标记；发布前还会对最终正文再检查一次，发现问题就取消发布并通知你
- 会话页面会显示倒计时，随时可以点击 Cancel auto-publish 取消；关闭自动化会立即取消所有待发布的草稿
- 只处理开启自动化之后有新活动的会话，历史会话不会被自动发布
隐私与安全
- 本机脱敏：上传前在你的电脑上把 API key、token、私钥、URL 中的密码、
.env中的密钥等替换为[REDACTED:…]，主目录路径替换为~ - 默认私密：同步的会话只有你自己能看到，只有你发布的文章才会公开
- 最小权限：CLI 密钥不能发布内容，自动发布只能由你在网页上授权
- 排除项目：在不想同步的项目中运行
npx @postion/cli ignore - 删除会话：在会话页面点击 Delete 即可删除，之后不会再被上传（除非使用
sync --force）
常见问题
同步没有生效？
运行 npx @postion/cli status 查看。确认账号已登录、钩子为 installed，并查看最近的后台同步记录。安装钩子之前就已打开的 Claude Code 窗口可能不会同步，新开一个窗口即可。
status 提示 outdated？
运行 npx @postion/cli@latest install 更新本地运行时。
提示密钥被拒绝？
密钥可能已被撤销，重新运行 npx @postion/cli login。
想完全停用？
运行 npx @postion/cli uninstall 移除钩子，再运行 npx @postion/cli logout，并在控制台撤销对应的 API Key。