터미널 설정 최적화

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 (줄 합치기)

전체 참조는 대화형 모드에서 확인할 수 있습니다.

터미널 설정 최적화

Claude Code는 터미널이 올바르게 구성되어 있을 때 가장 잘 동작합니다. 다음 가이드라인을 따라 사용 경험을 최적화하세요.

테마 및 외관

줄바꿈

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+"로 설정합니다

알림 설정

터미널 알림

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 (줄 합치기)

전체 참조는 대화형 모드에서 확인할 수 있습니다.

16. 터미널 설정 최적화

터미널 설정 최적화

테마 및 외관

줄바꿈

알림 설정

터미널 알림

알림 훅

대용량 입력 처리

Vim 모드

16. 터미널 설정 최적화

터미널 설정 최적화

테마 및 외관

줄바꿈

알림 설정

터미널 알림

알림 훅

대용량 입력 처리

Vim 모드