用途:在每个新的 Claude Code 会话开始时,或切换到明显不同的任务时,自动把终端窗口标题设为当前高层任务的简洁描述,帮助运行多个 Claude Code 实例的开发者快速分辨各终端在做什么。
主要能力:分析用户提示提炼任务摘要;生成不超过 40 字符的描述性标题;调用 scripts/set_title.sh 设置标题;运行在后台,无需用户确认。标题格式为「[动作/类别]: [具体焦点]」,例如「API Integration: Auth Flow」「Fix: Login Bug」「DB Migration: Users Table」「Build: Dashboard UI」「Refactor: Payment Module」。
触发时机:每个新会话收到首个用户提示后;切换到实质不同的任务时,如从前端转向后端、从调试转向新功能开发、更换模块或组件、系统不同部分之间切换。不应触发:同一任务的追问、对当前工作的小幅调整、刚构建功能的调试、澄清问题、同一组件或模块的迭代、任务中途的状态更新。
使用方式:执行 bash scripts/set_title.sh "Your Title Here"。脚本使用 ANSI 转义序列设置标题,兼容 macOS Terminal、iTerm2、Alacritty 及大多数现代终端(xterm、rxvt、screen、tmux)。脚本接受单个标题参数,未提供标题时静默退出。
可选自定义:可设置环境变量 export CLAUDE_TITLE_PREFIX="🤖 Claude" 为标题加前缀,生成如「🤖 Claude | Build: Dashboard UI」的标题,脚本自动处理,无需手动检查或修改行为。
限制与注意事项:标题须简洁、可操作、易于识别,避免过长、过于笼统或包含系统信息(如主机名、路径),也不使用完整句子。尽量控制在 40 字符内。