会话管理
概述
管理 Claude Code 会话历史 -- 列出、加载、设置别名、查看存储在 ~/.claude/sessions/ 中的会话信息,支持按日期过滤、按 ID 搜索、分页浏览等功能。
使用方法
/sessions [list|load|alias|info|help] [选项]
操作说明
列出会话
显示所有会话及其元数据,支持过滤和分页。
/sessions # 列出所有会话(默认)
/sessions list # 同上
/sessions list --limit 10 # 显示 10 个会话
/sessions list --date 2026-02-01 # 按日期过滤
/sessions list --search abc # 按会话 ID 搜索
显示格式:
Sessions (showing N of M):
ID Date Time Size Lines Alias
────────────────────────────────────────────────────
a1b2c3d4 2026-02-01 14:30 12.5KB 320 my-alias
加载会话
按 ID 或别名加载并显示会话内容。
/sessions load <id|alias> # 加载会话
/sessions load 2026-02-01 # 按日期(适用于无 ID 的会话)
/sessions load a1b2c3d4 # 按短 ID
/sessions load my-alias # 按别名
加载后显示:
- 会话文件名和路径
- 统计信息(行数、总项目数、已完成数、进行中数、文件大小)
- 别名列表
- 标题和时间戳
创建别名(Alias)
为会话创建一个便于记忆的别名。
/sessions alias <id> <name> # 创建别名
/sessions alias 2026-02-01 today-work # 创建名为 "today-work" 的别名
删除别名
/sessions alias --remove <name> # 删除别名
/sessions unalias <name> # 同上
会话详情
显示会话的详细信息。
/sessions info <id|alias> # 显示会话详情
显示内容包括:
Session Information
════════════════════
ID: a1b2c3d4
Filename: session-2026-02-01-a1b2c3d4.md
Date: 2026-02-01
Modified: 2026-02-01 14:30:00
Content:
Lines: 320
Total items: 15
Completed: 12
In progress: 3
Size: 12.5KB
Aliases: today-work
列出所有别名
/sessions aliases # 列出所有别名
参数说明
| 命令 | 说明 |
|---|---|
list [选项] |
列出会话 |
--limit <n> |
最多显示的会话数(默认:50) |
--date <YYYY-MM-DD> |
按日期过滤 |
--search <pattern> |
在会话 ID 中搜索 |
load <id|alias> |
加载会话内容 |
alias <id> <name> |
为会话创建别名 |
alias --remove <name> |
删除别名 |
unalias <name> |
同 --remove |
info <id|alias> |
显示会话统计信息 |
aliases |
列出所有别名 |
help |
显示帮助信息 |
使用示例
# 列出所有会话
/sessions list
# 为今天的会话创建别名
/sessions alias 2026-02-01 today
# 通过别名加载会话
/sessions load today
# 查看会话详情
/sessions info today
# 删除别名
/sessions alias --remove today
# 列出所有别名
/sessions aliases
注意事项
- 会话以 Markdown 文件形式存储在
~/.claude/sessions/中 - 别名存储在
~/.claude/session-aliases.json中 - 会话 ID 可以缩短使用(前 4-8 个字符通常足够唯一)
- 建议为常用会话设置别名,方便快速访问