sessions — команда для Claude Code: что делает и как установить
Управляет историей диалогов Claude Code в каталоге ~/.claude/sessions/. Находит сохранённые сессии, назначает им короткие псевдонимы и выводит статистику.
MIT ★ 2 037 обновлён 2026-03-05
/plugin marketplace add xu-xiang/everything-claude-code-zh
/plugin install everything-claude-code@everything-claude-codeЧто делает sessions
Команда /sessions работает с файлами сохранённых диалогов в ~/.claude/sessions/. Она позволяет отфильтровать список сессий по дате или идентификатору, ограничить вывод флагом --limit и просмотреть метаданные: число строк, статус выполнения задач и объём файла.
Внутри команды встроены вызовы Node.js, использующие модули session-manager и session-aliases из каталога плагина или ~/.claude/scripts/lib/. Чтобы не оперировать длинными идентификаторами сессий вроде a1b2c3d4, инструмент связывает их с понятными именами через /sessions alias.
Для работы команды в системе требуется установленный Node.js. Если в рабочей среде отсутствуют указанные библиотеки скриптов, вызов команды завершится ошибкой импорта модуля.
Какие задачи решает
- найти сохранённый диалог по дате или фрагменту идентификатора
- привязать короткий псевдоним к сессии вместо длинного ID
- просмотреть количество строк и статус задач внутри сессии
- удалить устаревший псевдоним диалога
Примеры запросов агенту
- /sessions
list --limit 10 - /sessions alias 2026-02-01 today-work
- /sessions load today-work
Как установить sessions
1Через маркетплейс плагинов
/plugin marketplace add xu-xiang/everything-claude-code-zh/plugin install everything-claude-code@everything-claude-code2Вручную: положить файлы
.claude/commands/sessions.mdВызов — /sessions. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/sessions.mdВызов — /prompts:sessions. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/sessions.prompt.mdВручную: положить файлы
.gemini/commands/sessions.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о sessions
Как установить sessions в Claude Code?
Выполните команду /plugin marketplace add xu-xiang/everything-claude-code-zh, а затем /plugin install everything-claude-code@everything-claude-code. Также можно поместить файл команды вручную по пути .claude/commands/sessions.md.
Что делает команда sessions?
Она выводит список сессий Claude Code из каталога ~/.claude/sessions/, показывает их параметры и позволяет обращаться к ним по удобным псевдонимам.
Какие зависимости нужны для работы?
В системе должен быть установлен Node.js, а вспомогательные скрипты session-manager и session-aliases должны находиться в ~/.claude/scripts/lib/ или в директории CLAUDE_PLUGIN_ROOT.
Исходный текст
sessions.md · MIT
# 会话(Sessions)命令
管理 Claude Code 会话历史 - 列出、加载、设置别名(Alias)以及编辑存储在 `~/.claude/sessions/` 中的会话。
## 用法
`/sessions [list|load|alias|info|help] [options]`
## 操作
### 列出会话(List Sessions)
显示所有会话及其元数据、过滤和分页。
```bash
/sessions # 列出所有会话(默认)
/sessions list # 同上
/sessions list --limit 10 # 显示 10 条会话
/sessions list --date 2026-02-01 # 按日期过滤
/sessions list --search abc # 按会话 ID 搜索
```
**脚本:**
```bash
node -e "
const sm = require((process.env.CLAUDE_PLUGIN_ROOT||require('path').join(require('os').homedir(),'.claude'))+'/scripts/lib/session-manager');
const aa = require((process.env.CLAUDE_PLUGIN_ROOT||require('path').join(require('os').homedir(),'.claude'))+'/scripts/lib/session-aliases');
const result = sm.getAllSessions({ limit: 20 });
const aliases = aa.listAliases();
const aliasMap = {};
for (const a of aliases) aliasMap[a.sessionPath] = a.name;
console.log('会话 (正在显示 ' + result.sessions.length + ' / ' + result.total + '):');
console.log('');
console.log('ID 日期 时间 大小 行数 别名');
console.log('────────────────────────────────────────────────────');
for (const s of result.sessions) {
const alias = aliasMap[s.filename] || '';
const size = sm.getSessionSize(s.sessionPath);
const stats = sm.getSessionStats(s.sessionPath);
const id = s.shortId === 'no-id' ? '(none)' : s.shortId.slice(0, 8);
const time = s.modifiedTime.toTimeString().slice(0, 5);
console.log(id.padEnd(8) + ' ' + s.date + ' ' + time + ' ' + size.padEnd(7) + ' ' + String(stats.lineCount).padEnd(5) + ' ' + alias);
}
"
```
### 加载会话(Load Session)
加载并显示会话内容(通过 ID 或别名)。
```bash
/sessions load <id|alias> # 加载会话
/sessions load 2026-02-01 # 按日期(针对无 ID 会话)
/sessions load a1b2c3d4 # 按短 ID
/sessions load my-alias # 按别名
```
**脚本:**
```bash
node -e "
const sm = require((process.env.CLAUDE_PLUGIN_ROOT||require('path').join(require('os').homedir(),'.claude'))+'/scripts/lib/session-manager');
const aa = require((process.env.CLAUDE_PLUGIN_ROOT||require('path').join(require('os').homedir(),'.claude'))+'/scripts/lib/session-aliases');
const id = process.argv[1];
// 首先尝试解析为别名
const resolved = aa.resolveAlias(id);
const sessionId = resolved ? resolved.sessionPath : id;
const session = sm.getSessionById(sessionId, true);
if (!session) {
console.log('未找到会话: ' + id);
process.exit(1);
}
const stats = sm.getSessionStats(session.sessionPath);
const size = sm.getSessionSize(session.sessionPath);
const aliases = aa.getAliasesForSession(session.filename);
console.log('会话: ' + session.filename);
console.log('路径: ~/.claude/sessions/' + session.filename);
console.log('');
console.log('统计信息:');
console.log(' 行数: ' + stats.lineCount);
console.log(' 总项数: ' + stats.totalItems);
console.log(' 已完成: ' + stats.completedItems);
console.log(' 进行中: ' + stats.inProgressItems);
console.log(' 大小: ' + size);
console.log('');
if (aliases.length > 0) {
console.log('别名: ' + aliases.map(a => a.name).join(', '));
console.log('');
}
if (session.metadata.title) {
console.log('标题: ' + session.metadata.title);
console.log('');
}
if (session.metadata.started) {
console.log('开始时间: ' + session.metadata.started);
}
if (session.metadata.lastUpdated) {
console.log('最后更新: ' + session.metadata.lastUpdated);
}
" "$ARGUMENTS"
```
### 创建别名(Create Alias)
为会话创建一个易记的别名。
```bash
/sessions alias <id> <name> # 创建别名
/sessions alias 2026-02-01 today-work # 创建名为 "today-work" 的别名
```
**脚本:**
```bash
node -e "
const sm = require((process.env.CLAUDE_PLUGIN_ROOT||require('path').join(require('os').homedir(),'.claude'))+'/scripts/lib/session-manager');
const aa = require((process.env.CLAUDE_PLUGIN_ROOT||require('path').join(require('os').homedir(),'.claude'))+'/scripts/lib/session-aliases');
const sessionId = process.argv[1];
const aliasName = process.argv[2];
if (!sessionId || !aliasName) {
console.log('用法: /sessions alias <id> <name>');
process.exit(1);
}
// 获取会话文件名
const session = sm.getSessionById(sessionId);
if (!session) {
console.log('未找到会话: ' + sessionId);
process.exit(1);
}
const result = aa.setAlias(aliasName, session.filename);
if (result.success) {
console.log('✓ 别名已创建: ' + aliasName + ' → ' + session.filename);
} else {
console.log('✗ 错误: ' + result.error);
process.exit(1);
}
" "$ARGUMENTS"
```
### 移除别名(Remove Alias)
删除现有的别名。
```bash
/sessions alias --remove <name> # 移除别名
/sessions unalias <name> # 同上
```
**脚本:**
```bash
node -e "
const aa = require((process.env.CLAUDE_PLUGIN_ROOT||require('path').join(require('os').homedir(),'.claude'))+'/scripts/lib/session-aliases');
const aliasName = process.argv[1];
if (!aliasName) {
console.log('用法: /sessions alias --remove <name>');
process.exit(1);
}
const result = aa.deleteAlias(aliasName);
if (result.success) {
console.log('✓ 别名已移除: ' + aliasName);
} else {
console.log('✗ 错误: ' + result.error);
process.exit(1);
}
" "$ARGUMENTS"
```
### 会话详情(Session Info)
显示会话的详细信息。
```bash
/sessions info <id|alias> # 显示会话详情
```
**脚本:**
```bash
node -e "
const sm = require((process.env.CLAUDE_PLUGIN_ROOT||require('path').join(require('os').homedir(),'.claude'))+'/scripts/lib/session-manager');
const aa = require((process.env.CLAUDE_PLUGIN_ROOT||require('path').join(require('os').homedir(),'.claude'))+'/scripts/lib/session-aliases');
const id = process.argv[1];
const resolved = aa.resolveAlias(id);
const sessionId = resolved ? resolved.sessionPath : id;
const session = sm.getSessionById(sessionId, true);
if (!session) {
console.log('未找到会话: ' + id);
process.exit(1);
}
const stats = sm.getSessionStats(session.sessionPath);
const size = sm.getSessionSize(session.sessionPath);
const aliases = aa.getAliasesForSession(session.filename);
console.log('会话信息');
console.log('════════════════════');
console.log('ID: ' + (session.shortId === 'no-id' ? '(none)' : session.shortId));
console.log('文件名: ' + session.filename);
console.log('日期: ' + session.date);
console.log('修改时间: ' + session.modifiedTime.toISOString().slice(0, 19).replace('T', ' '));
console.log('');
console.log('内容:');
console.log(' 行数: ' + stats.lineCount);
console.log(' 总项数: ' + stats.totalItems);
console.log(' 已完成: ' + stats.completedItems);
console.log(' 进行中: ' + stats.inProgressItems);
console.log(' 大小: ' + size);
if (aliases.length > 0) {
console.log('别名: ' + aliases.map(a => a.name).join(', '));
}
" "$ARGUMENTS"
```
### 列出别名(List Aliases)
显示所有会话别名。
```bash
/sessions aliases # 列出所有别名
```
**脚本:**
```bash
node -e "
const aa = require((process.env.CLAUDE_PLUGIN_ROOT||require('path').join(require('os').homedir(),'.claude'))+'/scripts/lib/session-aliases');
const aliases = aa.listAliases();
console.log('会话别名 (' + aliases.length + '):');
console.log('');
if (aliases.length === 0) {
console.log('未找到别名。');
} else {
console.log('别名 会话文件 标题');
console.log('─────────────────────────────────────────────────────────────');
for (const a of aliases) {
const name = a.name.padEnd(12);
const file = (a.sessionPath.length > 30 ? a.sessionPath.slice(0, 27) + '...' : a.sessionPath).padEnd(30);
const title = a.title || '';
console.log(name + ' ' + file + ' ' + title);
}
}
"
```
## 参数(Arguments)
$ARGUMENTS:
- `list [options]` - 列出会话
- `--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` - 显示此帮助信息
## 示例
```bash
# 列出所有会话
/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 个字符通常足以保证唯一性)
- 为经常引用的会话使用别名
© Affaan Mustafa · MIT · xu-xiang/everything-claude-code-zh