16. 터미널 설정 최적화
테마·알림·줄바꿈·Vim 모드 등 터미널 환경 최적화 가이드
터미널 설정 최적화
Claude Code는 터미널이 올바르게 구성되어 있을 때 가장 잘 동작합니다. 다음 가이드라인을 따라 사용 경험을 최적화하세요.
테마 및 외관
Claude는 터미널의 테마를 직접 제어할 수 없습니다. 테마는 터미널 애플리케이션에서 관리됩니다. /config 명령어를 통해 언제든지 Claude Code의 테마를 터미널에 맞출 수 있습니다.
Claude Code 인터페이스 자체를 추가로 커스터마이징하려면, 커스텀 상태 표시줄을 설정하여 현재 모델, 작업 디렉토리, git 브랜치 등의 컨텍스트 정보를 터미널 하단에 표시할 수 있습니다.
줄바꿈
Claude Code에서 줄바꿈을 입력하는 방법은 여러 가지가 있습니다:
- 빠른 이스케이프:
\를 입력한 후 Enter를 눌러 줄바꿈을 생성합니다 - Shift+Enter: iTerm2, WezTerm, Ghostty, Kitty에서 바로 사용할 수 있습니다
- 키보드 단축키: 다른 터미널에서는 줄바꿈을 삽입하는 키바인딩을 설정할 수 있습니다
다른 터미널에서 Shift+Enter 설정하기
Claude Code 내에서 /terminal-setup을 실행하면 VS Code, Alacritty, Zed, Warp에서 Shift+Enter를 자동으로 구성할 수 있습니다.
참고:
/terminal-setup명령어는 수동 구성이 필요한 터미널에서만 표시됩니다. iTerm2, WezTerm, Ghostty, Kitty를 사용하는 경우 Shift+Enter가 기본적으로 동작하므로 이 명령어가 표시되지 않습니다.
Option+Enter 설정하기 (VS Code, iTerm2 또는 macOS Terminal.app)
Mac Terminal.app의 경우:
- Settings → Profiles → Keyboard를 엽니다
- "Use Option as Meta Key"를 체크합니다
iTerm2 및 VS Code 터미널의 경우:
- Settings → Profiles → Keys를 엽니다
- General 아래에서 Left/Right Option key를 "Esc+"로 설정합니다
알림 설정
Claude가 작업을 완료하고 사용자의 입력을 기다릴 때 알림 이벤트가 발생합니다. 이 이벤트를 터미널을 통해 데스크톱 알림으로 표시하거나, 알림 훅으로 커스텀 로직을 실행할 수 있습니다.
터미널 알림
Kitty와 Ghostty는 추가 설정 없이 데스크톱 알림을 지원합니다. iTerm 2는 설정이 필요합니다:
- iTerm 2 Settings → Profiles → Terminal을 엽니다
- "Notification Center Alerts"를 활성화합니다
- "Filter Alerts"를 클릭하고 "Send escape sequence-generated alerts"를 체크합니다
알림이 표시되지 않는 경우, OS 설정에서 터미널 앱의 알림 권한을 확인하세요.
기본 macOS Terminal을 포함한 다른 터미널은 네이티브 알림을 지원하지 않습니다. 대신 알림 훅을 사용하세요.
알림 훅
알림이 발생할 때 소리 재생이나 메시지 전송과 같은 커스텀 동작을 추가하려면 알림 훅을 설정하세요. 훅은 터미널 알림을 대체하는 것이 아니라 함께 실행됩니다.
대용량 입력 처리
긴 코드나 긴 지시사항을 작업할 때:
- 직접 붙여넣기 지양: Claude Code는 매우 긴 붙여넣기 내용을 처리하는 데 어려움을 겪을 수 있습니다
- 파일 기반 워크플로우 사용: 내용을 파일에 작성한 후 Claude에게 읽도록 요청하세요
- VS Code 제한 사항 인지: VS Code 터미널은 긴 붙여넣기가 잘리는 현상이 특히 발생하기 쉽습니다
Vim 모드
Claude Code는 Vim 키바인딩의 일부를 지원하며, /vim 명령어로 활성화하거나 /config를 통해 설정할 수 있습니다.
지원되는 기능은 다음과 같습니다:
- 모드 전환:
Esc(NORMAL로),i/I,a/A,o/O(INSERT로) - 이동:
h/j/k/l,w/e/b,0/$/^,gg/G,f/F/t/T(;/,로 반복) - 편집:
x,dw/de/db/dd/D,cw/ce/cb/cc/C,.(반복) - 복사/붙여넣기:
yy/Y,yw/ye/yb,p/P - 텍스트 객체:
iw/aw,iW/aW,i"/a",i'/a',i(/a(,i[/a[,i{/a{ - 들여쓰기:
>>/<< - 줄 작업:
J(줄 합치기)
전체 참조는 대화형 모드에서 확인할 수 있습니다.