Appearance
Claude Code对话导出2种方法:WayLog CLI自动归档+SessionEnd Hook
两种方案不是"谁替代谁",而是面向不同需求。想少折腾选WayLog CLI,想完全控制选Hook。
为什么需要导出对话?
用Claude Code写代码、排查问题时,一次对话里可能包含:
- 大量方案讨论
- 命令执行记录
- 报错排查过程
- 思路沉淀
如果不及时保存,后续复用成本非常高。
两种实用方案:
| 方案 | 特点 | 适合人群 |
|---|---|---|
| WayLog CLI | 开箱即用,自动归档 | 想少折腾、快用起来 |
| SessionEnd Hook | 完全定制,精细控制 | 想按自己方式导出 |
方案一:WayLog CLI(推荐大多数人)
核心优势
- 不用写脚本
- 不用折腾配置
- 自动监听会话
- 导出为可搜索的Markdown
支持Claude Code、Gemini CLI、OpenAI Codex CLI等多种工具。
安装启动
bash
# 安装
npm install -g waylog-cli
# 启动
waylog start启动后自动监听会话,不需要每次手动触发。
适合谁?
| 用户类型 | 说明 |
|---|---|
| 想做日常知识沉淀 | 自动保存调试过程、命令记录 |
| 想建立对话档案库 | 低成本长期归档 |
| 不想折腾配置 | 开箱即用 |
一句话:想少折腾、快用起来,选WayLog CLI。
方案二:SessionEnd Hook(自定义能力强)
核心思路
利用Claude Code的SessionEnd Hook,在会话结束时自动触发导出动作。
SessionEnd触发时机
| 场景 | 说明 |
|---|---|
| 用户手动清空会话 | /clear |
| 会话被恢复替代 | 新session覆盖旧session |
| 用户退出 | Ctrl+D |
| 输入阶段直接退出 | Ctrl+C |
Hook配置示例
示例1:保存会话摘要
json
{
"hooks": {
"SessionEnd": [
{
"command": "node ~/.claude/hooks/save-session.js",
"matcher": "user_exit"
}
]
}
}示例2:导出为Markdown
json
{
"hooks": {
"SessionEnd": [
{
"command": "python ~/.claude/hooks/export_markdown.py --session $SESSION_ID",
"matcher": "*"
}
]
}
}示例3:同步到Obsidian
json
{
"hooks": {
"SessionEnd": [
{
"command": "cp ~/.claude/sessions/$SESSION_ID.md ~/Obsidian/DevLogs/",
"matcher": "user_exit"
}
]
}
}matcher匹配规则
| matcher | 匹配场景 |
|---|---|
user_exit | 用户主动退出 |
cleared | 会话被清空 |
replaced | 会话被新session替代 |
* | 所有结束场景 |
适合谁?
| 用户类型 | 说明 |
|---|---|
| 想控制导出时机 | 只在特定场景保存 |
| 想自定义格式 | 导出为JSON/HTML/自定义模板 |
| 想集成到现有工作流 | 与Obsidian、Notion等联动 |
一句话:想完全按自己方式定制,选Hook。
两种方案对比
| 维度 | WayLog CLI | SessionEnd Hook |
|---|---|---|
| 安装难度 | 一行命令 | 需写脚本 |
| 自动化程度 | 全自动 | 按规则触发 |
| 定制能力 | 固定格式 | 完全自定义 |
| 适用场景 | 日常归档 | 精细化控制 |
| 学习成本 | 低 | 中 |
选型建议
| 需求 | 推荐 |
|---|---|
| 马上用起来,不想配置 | WayLog CLI |
| 只在退出时保存,不需要实时 | Hook |
| 要导出到特定目录/格式 | Hook |
| 支持多种CLI工具归档 | WayLog CLI |
| 与知识库(Obsidian等)联动 | Hook |
总结
两种方案不是"谁替代谁",而是面向不同需求:
| 方案 | 一句话 |
|---|---|
| WayLog CLI | 开箱即用,省事 |
| SessionEnd Hook | 完全定制,可控 |
选择标准很简单:想少折腾选WayLog,想按自己方式来选Hook。
关键词:Claude Code, 对话导出, WayLog CLI, SessionEnd Hook, 归档, Markdown
