피드로 돌아가기
Terminal themes optimize for code. Claude Code is mostly prose.
Dev.toDev.to
Frontend

APCA 대비 최적화로 Claude Code 가독성을 높인 Klein-Void 테마 설계

Terminal themes optimize for code. Claude Code is mostly prose.

J Now2026년 6월 25일2intermediate

Context

기존 Terminal 테마가 Syntax Highlighting 위주로 설계되어 prose 형태의 AI 추론 로그 및 도구 출력물 가독성이 저하되는 한계 발생. 특히 Dark Theme 환경에서 텍스트 뭉치를 장시간 읽을 때 발생하는 시각적 피로도와 낮은 대비 값이 병목 지점으로 작용.

Technical Solution

  • Prose Reading 환경 최우선 설계를 통한 텍스트 중심의 ANSI 슬롯 재정의
  • pure IKB(hex 002FA7)의 APCA 대비 부족(Lc -12) 문제를 해결하기 위한 ANSI 슬롯 이원화 전략 채택
  • Decorative 요소용 ansi:blue에는 pure IKB를 적용하고, 가독성이 필수적인 permission-prompt용 ansi:blueBright에는 보정된 A8BEF0 색상 할당
  • V3 Prot 버전 내 모든 슬롯에 대해 Body >= 90 Lc, Subtle >= 75 Lc 등 엄격한 APCA Contrast Gate 적용을 통한 시각적 무결성 확보
  • Objective-C 기반 빌더를 통한 .terminal 프로필 생성 및 폰트 자동 설치 자동화 체계 구축
  • Claude Code의 /theme dark-ansi 설정을 통한 Terminal.app ANSI 테마 강제 적용 구조 설계

- 텍스트의 역할(Decorative vs Readable)에 따라 서로 다른 ANSI 슬롯을 할당하여 대비 값 최적화 - 단순 색상 선택이 아닌 APCA(Accessible Perceptual Contrast Algorithm) 수치를 기반으로 한 접근성 검증 - 외부 툴의 Hardcoded Palette 우선순위를 파악하여 시스템 설정값이 실제 적용되는 진입점 확인

원문 읽기