会话管理

入门 Starter 工具型 Tool ⚡ Claude Code 专属 ⚡ Claude Code Optimized
3 min read · 150 lines

管理 Claude Code 会话历史:列出、加载、设置别名

会话管理

概述

管理 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 个字符通常足够唯一)
  • 建议为常用会话设置别名,方便快速访问

相关技能 Related Skills