Claude Code

Deftty는 자기 pane에서 실행 중인 Claude Code를 감지해 훅과 상태줄을 읽습니다. 다른 터미널의 Claude Code는 무시합니다.

알림

설정(⌘,)에서 "Claude 알림"을 켭니다. Deftty가 ~/.claude/settings.json에 훅 다섯 개를 넣고 원본을 settings.json.deftty-backup으로 백업합니다. 끄면 훅을 제거합니다.

알림을 클릭하면 그 pane으로 이동합니다. pane이 보이는 동안은 알림을 건너뛰며, "보고 있을 때도 알림"을 켜면 받습니다. 소리는 Claude Code가 입력을 기다릴 때만 납니다.

pane 상태

pane 헤더마다 경로, git 브랜치가 보이고, Claude Code가 있으면 모델, 컨텍스트 사용량, 상태가 보입니다. 상태는 작업 중, 입력 대기, 대기 세 가지입니다. 하단바는 현재 워크스페이스의 pane을 상태별로 셉니다. 알림이 꺼져 있으면 대신 Claude Code 세션 수를 보여 줍니다. pane-info로 헤더를 하단바로 옮기거나 숨길 수 있습니다.

사용량

하단바에 세션 한도와 주간 한도가 보이고, 70%부터 주황색, 85%부터 빨간색으로 바뀝니다. 클릭하면 재설정까지 남은 시간이 나옵니다. pane 헤더의 컨텍스트 비율도 같은 기준을 씁니다.

이 값을 읽기 위해 Deftty는 시작할 때 ~/.claude/settings.json의 Claude Code statusLine 명령을 ~/.deftty/statusline-tee.sh로 감쌉니다. 원래 상태줄은 계속 실행됩니다. 모델별 주간 한도는 사용자 자격 증명으로 Claude 사용량 API에서 가져오며, 시작할 때 한 번과 30분마다 조회합니다.

세션 복원

재시작하면 모든 Claude Code pane에 claude --resume <id>가 입력된 채 Enter를 기다립니다. 자동으로 실행하려면 다음을 적습니다.

claude-auto-resume = true

Shift+Enter

Shift+Enter는 Claude Code 입력창에서 제출하지 않고 줄을 바꿉니다. Deftty는 Claude Code가 이 줄바꿈을 인식하도록 TERM_PROGRAM=Deftty를 설정합니다.

깨어있기

하단바의 ☕ 칩은 맥을 30분에서 24시간까지, 또는 무기한 깨어 있게 합니다. 팝오버에서 화면만 끄도록 두거나, 시간이 다 되면 알림을 받도록 할 수 있습니다. Deftty를 종료해도 설정이 남고, 시간제는 남은 시간부터 이어집니다. 덮개를 닫으면 맥은 잠듭니다. 외부 디스플레이와 전원이 연결된 상태만 예외입니다.