읽는 시간: 6분 | 난이도: 초급자
Claude Code는 터미널 환경이 제대로 구성되어 있을 때 최상의 성능을 발휘합니다. 이 가이드에서는 테마 설정, 줄바꿈 단축키, 알림, Vim 모드 등 터미널 환경을 최적화하는 방법을 안내합니다.
테마 및 외관
Claude Code는 터미널 자체의 테마를 제어할 수 없습니다. 터미널 색상 등의 외관은 터미널 애플리케이션에서 설정해야 합니다. Claude Code 인터페이스의 테마는 언제든지 /config 명령으로 변경할 수 있습니다.
인터페이스를 더 세밀하게 커스터마이징하려면 커스텀 상태 표시줄을 설정해 현재 모델, 작업 디렉토리, Git 브랜치 등의 정보를 터미널 하단에 표시할 수 있습니다.
줄바꿈 입력 방법
Claude Code에서 줄바꿈을 입력하는 방법은 여러 가지가 있습니다.
| 방법 | 단축키 | 지원 환경 |
|---|---|---|
| 빠른 이스케이프 | \ + Enter |
모든 터미널 |
| Shift+Enter | Shift+Enter |
iTerm2, WezTerm, Ghostty, Kitty |
| 키보드 단축키 | 설정 필요 | 기타 터미널 |
| Control sequence | Ctrl+J |
줄바꿈 문자 입력 |
다른 터미널에서 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의 경우:
- 설정 → 프로파일 → 키보드 열기
- "Option을 Meta 키로 사용" 체크
iTerm2 및 VS Code 터미널의 경우:
- 설정 → 프로파일 → 키 열기
- 일반 항목에서 좌/우 Option 키를 "Esc+"로 설정
알림 설정
Claude가 작업을 완료하고 입력을 기다릴 때 알림 이벤트가 발생합니다. 이 이벤트를 데스크탑 알림으로 받거나 알림 훅으로 커스텀 동작을 실행할 수 있습니다.
터미널 알림
Kitty와 Ghostty는 추가 설정 없이 데스크탑 알림을 지원합니다.
iTerm2는 다음 설정이 필요합니다:
- iTerm 2 설정 → 프로파일 → 터미널 열기
- "Notification Center Alerts" 활성화
- "Filter Alerts" 클릭 후 "Send escape sequence-generated alerts" 체크
알림이 표시되지 않으면 OS 설정에서 터미널 앱의 알림 권한을 확인하세요.
macOS 기본 Terminal을 포함한 기타 터미널은 기본 알림을 지원하지 않으므로 알림 훅을 사용하세요.
알림 훅
소리 재생이나 메시지 전송 등 알림 발생 시 커스텀 동작을 추가하려면 알림 훅을 설정하세요. 훅은 터미널 알림과 함께 실행되며, 대체하지 않습니다.
대용량 입력 처리
긴 코드나 긴 지시사항을 다룰 때 주의할 점:
- 직접 붙여넣기 피하기: Claude Code는 매우 긴 붙여넣기 내용을 처리하는 데 어려움이 있을 수 있습니다.
- 파일 기반 워크플로우 활용: 내용을 파일에 작성하고 Claude에게 해당 파일을 읽도록 요청하세요.
- VS Code 제한 사항 인지: VS Code 터미널은 긴 붙여넣기를 잘라낼 수 있으므로 특히 주의가 필요합니다.
Vim 모드
Claude Code는 /vim 명령으로 활성화하거나 /config에서 영구적으로 설정할 수 있는 Vim 키바인딩의 하위 집합을 지원합니다.
지원되는 Vim 기능
모드 전환:
| 명령 | 동작 | 시작 모드 |
|---|---|---|
Esc |
NORMAL 모드 진입 | INSERT |
i / I |
커서 앞 / 줄 시작에 삽입 | NORMAL |
a / A |
커서 뒤 / 줄 끝에 삽입 | NORMAL |
o / O |
아래/위에 새 줄 열기 | NORMAL |
이동 (NORMAL 모드):
| 명령 | 동작 |
|---|---|
h/j/k/l |
좌/하/상/우 이동 |
w / e / b |
다음 단어 / 단어 끝 / 이전 단어 |
0 / $ / ^ |
줄 시작 / 줄 끝 / 첫 비공백 문자 |
gg / G |
입력 시작 / 입력 끝 |
f{char} / F{char} |
다음/이전 문자로 점프 |
t{char} / T{char} |
다음/이전 문자 직전/직후로 점프 |
; / , |
마지막 f/F/t/T 동작 반복 / 역방향 반복 |
편집 (NORMAL 모드):
| 명령 | 동작 |
|---|---|
x |
문자 삭제 |
dd / D |
줄 삭제 / 줄 끝까지 삭제 |
dw/de/db |
단어/끝까지/뒤로 삭제 |
cc / C |
줄 변경 / 줄 끝까지 변경 |
cw/ce/cb |
단어/끝까지/뒤로 변경 |
yy/Y |
줄 복사 |
yw/ye/yb |
단어/끝까지/뒤로 복사 |
p / P |
커서 뒤/앞에 붙여넣기 |
>> / << |
들여쓰기 / 내어쓰기 |
J |
줄 합치기 |
. |
마지막 변경 반복 |
텍스트 객체:
| 명령 | 동작 |
|---|---|
iw/aw |
단어 안/주변 |
iW/aW |
WORD(공백 구분) 안/주변 |
i"/a" |
큰따옴표 안/주변 |
i'/a' |
작은따옴표 안/주변 |
i(/a( |
괄호 안/주변 |
i[/a[ |
대괄호 안/주변 |
i{/a{ |
중괄호 안/주변 |
전체 Vim 참조는 인터랙티브 모드 문서를 확인하세요.
자주 묻는 질문
Q: 터미널을 새로 시작했을 때 설정이 유지되지 않아요.
A: /config 명령으로 설정한 내용은 Claude Code의 사용자 설정 파일에 저장됩니다. 터미널 자체의 설정(폰트, 색상 등)은 터미널 애플리케이션 설정에서 저장해야 합니다.
Q: Shift+Enter를 눌러도 줄바꿈이 안 돼요.
A: 사용 중인 터미널에 따라 /terminal-setup 명령으로 자동 설정하거나, 터미널 설정에서 직접 구성해야 할 수 있습니다. iTerm2, WezTerm, Ghostty, Kitty가 아닌 경우 수동 설정이 필요합니다.
Q: 알림이 전혀 오지 않아요.
A: iTerm2 사용자라면 위의 알림 설정 단계를 따르세요. macOS 기본 Terminal 사용자는 알림 훅을 설정하는 것이 유일한 방법입니다.
다음 단계
터미널 설정을 완료했다면 다음 주제를 살펴보세요: