Claude Code + Ghostty 터미널 알림 설정 가이드
이 문서는 Ghostty 터미널에서 Claude Code 작업 완료 시 알림을 받기 위한 설정 방법을 설명합니다.
개요
Claude Code가 작업을 완료하면 다음과 같은 방식으로 알림을 받을 수 있습니다:
- Dock 아이콘 바운스 및 배지 표시
- 타이틀바에 벨 이모지 표시
- 시스템 알림
설정 방법
1. Claude Code 알림 설정
Claude Code에서 터미널 벨 알림을 활성화합니다.
claude config set --global preferredNotifChannel terminal_bell또는 Ghostty 전용 알림 채널을 사용할 수 있습니다:
claude config set --global preferredNotifChannel ghostty설정 확인:
claude config get preferredNotifChannel설정 파일 위치: ~/.claude.json
2. Ghostty 터미널 설정
Ghostty 설정 파일을 생성하거나 수정합니다.
설정 파일 위치: ~/.config/ghostty/config
# 디렉토리 생성 (없는 경우)
mkdir -p ~/.config/ghostty설정 내용:
# Ghostty Configuration
# Bell notification settings for Claude Code
# title: 타이틀바에 벨 이모지 표시
# attention: Dock 아이콘 바운스 및 배지 표시
# system: 시스템 알림 활성화
bell-features = title,attention,system
3. macOS 시스템 설정
Ghostty 알림이 정상적으로 작동하려면 macOS에서 알림을 허용해야 합니다.
- 시스템 설정 열기
- 알림 선택
- Ghostty 찾아서 알림 허용
알림 테스트
터미널에서 벨이 정상적으로 작동하는지 테스트합니다:
echo -e "\a"또는:
printf '\a'설정 옵션 상세
Claude Code preferredNotifChannel 옵션
| 값 | 설명 |
|---|---|
terminal_bell | 표준 터미널 벨 사용 |
ghostty | Ghostty 최적화 알림 |
none | 알림 비활성화 |
Ghostty bell-features 옵션
| 옵션 | 설명 |
|---|---|
title | 타이틀바에 벨 이모지 표시 |
attention | Dock 아이콘 바운스 및 배지 표시 |
system | 시스템 알림 사용 |
audio | 오디오 벨 (현재 macOS에서 지원 안됨) |
비활성화하려면 앞에 no-를 붙입니다 (예: no-title, no-attention)
문제 해결
알림이 오지 않는 경우
- macOS 시스템 설정에서 Ghostty 알림이 허용되어 있는지 확인
- Ghostty를 재시작
- Claude Code 세션을 새로 시작
오디오 벨이 작동하지 않는 경우
현재 Ghostty macOS 버전에서는 bell-features = audio 옵션이 완전히 지원되지 않을 수 있습니다. 시각적 알림(title, attention)을 사용하는 것을 권장합니다.
참고 자료
마지막 업데이트: 2025-12-27