Claude Code의 영어 고정 제목 버그를 해결하는 다국어 세션 제목 생성기

실용적 조언

macOS 사용자라면 제공된 설치 스크립트를 통해 즉시 적용 가능하며, 설정 파일에서 기본 제목 기능을 반드시 꺼야 한다.

섹션별 상세

Claude Code의 내장 제목 생성 기능을 비활성화하고 사용자 정의 훅을 통해 다국어 제목을 생성한다. CLAUDE_CODE_DISABLE_TERMINAL_TITLE 환경 변수를 1로 설정하여 기본 기능을 끄고, UserPromptSubmit 훅을 등록하여 첫 프롬프트 시점에 제목 생성을 트리거한다. 이를 통해 기존 시스템과의 충돌을 방지하면서 사용자가 원하는 언어로 터미널 제목을 설정할 수 있다.

json

{
  "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1"
}

~/.claude/settings.json에서 기본 터미널 제목 생성 기능을 비활성화하는 설정

경량 모델인 Claude Haiku를 활용하여 비용 효율적이고 정확한 제목 생성을 수행한다. 첫 세션 시작 시 백그라운드에서 claude-haiku-4-5 모델을 호출하며, JSON 스키마를 통해 입력 언어와 일치하는 제목을 출력하도록 강제한다. 생성된 제목은 로컬 경로에 저장되어 세션 재개 시 별도의 API 호출 없이 즉시 재적용되도록 설계됐다.

세션 중간에도 제목을 갱신할 수 있는 스킬 기능을 포함하여 유연성을 높였다. 사용자가 대화 도중 제목 갱신을 요청하면 추가적인 외부 모델 호출 없이 현재 대화 컨텍스트를 활용해 즉시 새로운 제목을 구성한다. 제어 문자 제거, 60자 제한, 경로 형태 거부 등의 데이터 정제 과정을 거쳐 터미널 환경에서의 안정성을 확보했다.

용어 해설

훅(Hook): — 특정 이벤트가 발생할 때 자동으로 실행되도록 설정된 코드 메커니즘이다. 이 글에서는 사용자 프롬프트 제출 시점에 맞춰 세션 제목을 생성하는 로직을 실행하는 용도로 사용됐다.
JSON 스키마(JSON Schema): — 데이터의 구조를 정의하고 검증하기 위한 명세이다. LLM이 응답할 때 특정 형식을 강제하여 프로그램이 결과를 안정적으로 파싱할 수 있도록 돕는 역할을 한다.
분리된 프로세스(Detached Process): — 부모 프로세스와 독립적으로 백그라운드에서 실행되는 프로세스이다. 메인 작업의 흐름을 방해하지 않고 별도의 작업을 수행할 때 활용된다.

언급된 도구

Claude Code중립

Anthropic의 공식 CLI 코딩 에이전트

Claude Haiku추천

제목 생성을 위한 저비용 고속 LLM

언급된 리소스

GitHubcc-session-title GitHub Repository