它到底是什么

/rename 是一个会话内 slash 命令,用于为当前 Claude Code 会话设置一个人类可读的名称。官方 /commands 文档对它的描述:"Rename the current session and show the name on the prompt bar. Without a name, auto-generates one from conversation history"——即重命名当前会话并将名称显示在提示栏(prompt bar);不带参数时,从对话历史自动生成名称。据二手来源,该名称同时出现在 /resume 会话选择器的列表项中。名称设置后,可在启动时直接通过 claude --resume <name> 跳回该会话,无需记忆自动生成的会话 ID。

怎么触发 / 怎么使用

1. 手动指定名称

/rename auth-refactor

紧跟命令之后的所有文本作为名称参数传入。名称立即生效并显示在提示栏。

2. 不带参数(AI 自动命名)

/rename

触发自动命名:官方 /commands 文档明确"Without a name, auto-generates one from conversation history"——从当前会话的对话历史中提取上下文生成名称。据二手来源,生成的是 kebab-case 格式的 2-4 词短语(例如 fix-auth-token-expiry)。若会话尚无任何对话记录,命令返回提示信息而非名称。

保存 / 配置 / 集成

/rename 只是会话命名的其中一种方式,官方文档记录了四种等效入口:

命名后,通过以下方式恢复会话:

claude --resume auth-refactor   # 命令行直接跳回
/resume auth-refactor           # 在另一个活跃会话中切换

名称在跨 worktree 的同一仓库范围内解析。精确匹配时直接恢复;名称模糊时,--resume 打开预填了该名称的选择器,/resume 则报错并提示运行无参数的 /resume。

跟同类原语对比

经典使用场景

• 并行任务管理:同时开多个会话处理不同功能分支时,用 /rename feature-payment-flow 等名称区分,避免在 /resume 里凭摘要猜测。
• 任务开始时立即命名:在第一条消息之后立即执行 /rename,使会话名称与任务语义绑定,便于 claude --resume <name> 精确跳回。
• 替代手动命名:在已有一定对话量后执行无参数的 /rename,让 AI 从上下文提炼名称,省去手动起名的步骤。

常见坑

1. 空会话无法自动命名:在没有任何对话记录的会话里执行 /rename(无参数),命令无法生成名称并返回提示,此时需手动传入名称参数。
2. Plan mode 自动命名格式不同:接受计划时触发的自动命名使用句子格式(Fix login button on mobile),而 /rename 无参数生成的名称是 kebab-case(fix-login-button-on-mobile),两者在 /resume 列表中外观不一致。
3. Swarm 子会话无法重命名(据二手来源):在 swarm 模式的子会话(teammate session)内执行 /rename 会被拒绝并报错。

来源

• Commands — Claude Code 官方文档
• Manage sessions — Claude Code 官方文档
• Claude Code /rename: Find Old Sessions Without Guessing — Vincent's Blog
• Claude Code Slash Commands — prg.sh