Claude Code 시간 표시, 내 방식대로 정한다

무엇이 바뀌었나

확인 깃허브에 올라온 Claude Code v2.1.257 공식 릴리스 노트(2026-09-01)에 따르면 이번 판에서 "Time format"(timeFormat) 과 timeZone 설정 두 개가 새로 생겼다. 같은 릴리스에서 클로드 페이블 5.1이 기본 모델로 바뀐 것이 더 큰 소식이었는데, 그 이야기는 이미 9월 1일 글에서 다뤘으니 여기서는 시간 표시 쪽만 본다.

확인 timeFormat이 받는 값은 릴리스 노트에 그대로 적혀 있다 — 12-hour, 24-hour, 24-hour-utc, 그리고 strftime 패턴 (예: %H:%M) 중 하나다.

추정 여러 정리 글을 보면 % 글자가 들어간 값은 strftime 패턴으로, 아니면 auto(시스템 로캘을 따름)로 취급된다고 한다. 또 /config 메뉴에는 timeFormat 항목만 있고 timeZone은 메뉴에 없어 설정 파일에 직접 적어야 한다는 설명도 있었다 — 릴리스 노트 원문에는 그 세부까지는 안 적혀 있어 추정으로 둔다.

왜 이런 작은 설정이 눈에 띄는가

이 사이트 교육 과정 CLAUDE 과정 · STEP 15 에서 "규칙을 파일에 박아 두기"를 이야기했다 — 매번 말로 설명하는 대신 설정 파일 하나에 원하는 동작을 적어 두면 다음부터 안 물어봐도 된다는 것. timeFormat·timeZone도 같은 모양이다. 한 번 ~/.claude/settings.json에 적어 두면 세션마다 다시 고를 필요가 없다.

확인 원격 서버에서 Claude Code를 돌리거나, 화면 녹화를 하면서 시각을 남기거나, 여러 시간대를 오가며 작업하는 사람에게는 사소해 보여도 매번 헷갈리던 지점이다. 시스템 로캘에 맞춰 자동으로 뜨던 시각을 내가 정한 형식·시간대로 고정할 수 있게 된 것이다.

직접 해 보기 — 5분

1. 버전을 확인한다. timeFormat은 2.1.257부터 있으니 그 아래 버전이면 먼저 올린다.

   claude --version

2. /config를 열어 Time format 항목을 찾는다. 확인 12시간제·24시간제·24시간제(UTC) 중 하나를 골라 본다.

   /config

3. 세션을 하나 끝내 본다. 화면 아래 "done 6:05 PM" 식으로 뜨는 문구가 고른 형식대로 바뀌었는지 확인한다.
4. 시간대까지 고정하고 싶으면 설정 파일에 직접 적는다. timeZone은 메뉴에 없다고 하니 파일을 연다.

   {
     "timeFormat": "24-hour",
     "timeZone": "Asia/Seoul"
   }

   추정 이름을 잘못 적으면 에러 없이 시스템 시간대로 조용히 돌아간다는 설명이 있었다. 오타를 냈는지는 화면에 뜨는 시각으로 확인하는 수밖에 없다.
5. 24-hour-utc로 바꿔서 timeZone이 정말 무시되는지 본다. 확인 이 프리셋을 쓰면 timeZone 값과 관계없이 UTC로 고정된다고 릴리스 쪽 설명에 나온다. timeZone을 다른 값으로 바꿔 봐도 시각이 그대로면 맞게 이해한 것이다.

한 줄 정리

1. Claude Code 2.1.257(9월 1일)에 timeFormat · timeZone 설정이 생겼다.
2. 형식은 /config에서, 시간대는 설정 파일에 직접 적는다.
3. 24-hour-utc를 쓰면 timeZone은 무시된다 — 둘을 같이 쓰지 않는다.