
Claude Code
让 Claude Code 的会话名变成中文:自动生成与手动重命名
Claude Code 的 /resume 列表默认用英文自动生成会话名,时间一长就分不清哪个是哪个。本文说明如何通过 settings.json 的 language 设置让会话标题自动使用中文,以及计划模式批准后标题被改回英文的原因与规避办法,并给出 /rename、Ctrl+R、claude --name 三种手动命名方式。
用 Claude Code 做开发时,一个项目里往往会积累几十个会话。等你想回到前几天那段工作,打开 /resume,看到的却是一排类似 fix-notification-branch-filter 的英文标题——它们由系统自动生成,彼此长得很像,很难一眼判断哪个才是自己要找的那次对话。翻找、点错、再退出重来,这些时间都是白花的。Claude Code 提供了两条解决路径:一是通过全局配置让自动生成的会话标题使用中文,二是在会话进行中或事后手动给会话起一个能看懂的名字。本文把这两条路径的配置方法、生效范围、已知的失效场景和补救手段讲清楚,适合已经在日常工作中使用 Claude Code、希望把会话管理理顺的开发者。
准备工作
开始之前,先确认几件事:
- Claude Code 已安装并可正常启动。本文涉及的都是 Claude Code 自身的配置项与斜杠命令,不需要额外安装插件。
- 知道自己的用户配置目录位置。全局配置文件位于用户主目录下的
~/.claude/settings.json。在 macOS 与 Linux 上就是$HOME/.claude/settings.json;在 Windows 上对应的是用户目录下的.claude\settings.json。 - 能编辑 JSON 文件。用任意文本编辑器打开即可,但要注意保持 JSON 语法合法——多一个逗号、少一个引号都会让整份配置失效。
- 了解会话记录存放位置。会话的原始记录保存在
~/.claude/projects/目录下,按项目分目录,每个会话是一个.jsonl文件。排查标题为什么变了的时候会用到它。
需要说明的是,settings.json 里写下的配置对该用户的所有项目生效,不需要在每个项目里重复配置。这一点对会话标题的语言设置同样成立。
操作步骤
第一步:在全局配置中设置语言
打开 ~/.claude/settings.json,在顶层 JSON 对象中加入 language 字段:
{
"language": "japanese"
}
如果文件里已经有其他配置项,不要覆盖它们,把 language 作为同一个对象里的一个新键加进去即可。例如原本有权限相关的设置,改完之后应当是这样:
{
"language": "japanese",
"permissions": {
"allow": []
}
}
这里的关键点是:language 不只影响 Claude 的回复语言,也影响自动生成的会话标题语言。也就是说,设置一次,回复和标题会一起切换。如果你希望会话标题用中文,就把值改成对应的语言标识;具体支持哪些取值,以官方文档当前列出的为准。
保存文件后,新开始的会话才会应用这项设置。已经存在的会话不会因为改了配置就自动重命名,它们的标题保持原样。
第二步:验证新会话的标题
改完配置后,新开一个会话,随便做一点工作,然后退出并重新打开 /resume。此时列表中应当能看到用目标语言生成的标题,而不是英文的短横线拼接串。
如果标题仍然是英文,先检查这几项:
- 配置文件路径是否正确,是否误改到了某个项目目录下的
settings.json。 - JSON 是否合法,可以用任意 JSON 校验工具检查一遍。
- 这个会话是否是在修改配置之前就已经创建的——旧会话不会追溯改名。
第三步:理解计划模式下的标题重置
配置生效一段时间后,你可能会发现某些会话的标题又变回了英文,例如从一句中文描述变成了 add-email-search 这样的形式。这不是配置写错了,而是计划模式的行为导致的。
在计划模式中批准一份计划后,Claude Code 会依据计划内容重新生成一次会话标题。这次重新生成不受 language 设置影响,标题会以英文形式写入。翻看 ~/.claude/projects/ 下对应的 .jsonl 记录可以确认:标题被替换的时间点,正好是批准计划的那一刻。没有使用计划模式的会话,标题则一直保持中文。
下面是一个对照示意,左侧是会话最初获得的标题,右侧是批准计划之后被替换成的标题:
| 最初生成的标题 | 批准计划后的标题 |
|---|---|
| 添加邮件搜索并更新工单 | add-email-search |
| 配合 API 的 PR 调整 Web 侧处理 | use-given-name-for-username |
规则里有一个例外:如果你已经手动给会话起过名字,批准计划时不会覆盖它。换句话说,自动重命名只作用于那些仍然使用自动标题的会话。
由此可以得出一个实用的操作习惯:在计划模式下工作时,先命名,再批准计划。用下一步介绍的 /rename 给当前会话起一个中文名字,之后批准计划,标题就不会被改回英文。
第四步:用 /rename 给当前会话命名
对于正在进行的会话,直接在输入框里执行:
/rename 通知出现的分支条件调查
命令后面跟的就是新的会话名,可以包含空格,直接写中文即可。命名之后,这个名字会出现在 /resume 列表中,取代原来的自动标题。
命名时建议写清「做什么」而不是「在哪个文件」。例如「通知出现的分支条件调查」比「notification.ts」更容易在几周后唤起记忆。如果同时开着多个会话,可以在名字里带上角色或阶段,比如「通知功能实现」「通知功能评审」,这样在列表里一眼就能区分。
第五步:启动时直接指定名字
如果一开始就知道这次会话要做什么,可以在终端启动时就把名字定下来:
claude --name "通知条件调查"
这样会话从创建的第一刻起就带着可读的名字,既省去了中途 /rename 的一步,也天然规避了计划模式批准后标题被重置的问题——因为它已经是一个被手动命名的会话。
第六步:事后用 Ctrl+R 重命名已有会话
对于已经存在、标题是英文的会话,不需要进去重新操作一遍。打开 /resume 列表,把光标移动到目标会话上,按下 Ctrl+R,即可就地修改名称。
这一步适合批量整理历史会话:把最近几天还在推进的会话逐个改成中文描述,之后回到列表时就能快速定位。改名的粒度建议控制在「一句话说清这次会话的目标」,例如「调查通知出现的分支条件」,既不至于太长挤占列表,也足够区分。
一个完整示例
下面走一遍从配置到命名的完整流程,覆盖计划模式这个容易踩坑的场景。
场景:接手一个通知模块的改造任务,预计要开多个会话,分别做调研、实现和评审。
1. 配置全局语言。编辑 ~/.claude/settings.json:
{
"language": "japanese"
}
保存。此后新开的会话,自动标题会使用配置的语言。
2. 启动调研会话并立即命名。因为这次要用计划模式,所以先命名再进入计划:
claude --name "通知条件调研"
或者在会话内执行:
/rename 通知条件调研
3. 进入计划模式,编写计划并批准。由于会话已经有手动名字,批准计划时不会触发标题重写,名字保持为「通知条件调研」。
4. 另开一个实现会话。同样先命名:
claude --name "通知功能实现"
5. 再开一个评审会话,命名为「通知功能评审」。三个会话在 /resume 里各占一行,职责一目了然。
6. 几天后回到列表。打开 /resume,如果发现某个早期会话仍是英文标题(比如配置生效之前创建的),把光标移上去按 Ctrl+R 改成中文,例如「调查通知出现的分支条件」。
整个流程下来,列表里不会再出现需要点进去才能确认内容的会话。
注意事项
- 语言设置只对新会话生效。修改
settings.json不会追溯重命名已有会话,历史会话需要用Ctrl+R或进入后/rename处理。 - 计划模式批准会重置自动标题。这是最容易让人误以为「配置失效」的地方。规避方式只有一种:在批准计划之前手动命名。已经手动命名的会话不会被覆盖。
- 全局配置影响所有项目。
~/.claude/settings.json中的设置对该用户的所有项目生效,不需要也不应该在每个项目里重复写。 - 修改 JSON 时保留原有字段。把
language追加到现有对象中,不要用新内容整体替换文件,否则会丢掉其他配置。 - 排查标题异常时看会话记录。
~/.claude/projects/下按项目存放的.jsonl文件记录了会话的完整过程,标题被替换的时间点可以在里面找到,比凭印象猜测更可靠。 - 版本与行为可能变化。计划模式下的标题重写行为、
language支持的取值、--name与/rename的具体表现,都可能随版本更新而调整,使用前请以官方文档当前的信息为准。