메인 콘텐츠로 건너뛰기

​
테마 및 모양

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의 경우:
  1. 설정 → 프로필 → 키보드 열기
  2. “Option을 Meta 키로 사용” 확인
iTerm2의 경우:
  1. 설정 → 프로필 → 키 열기
  2. 일반에서 왼쪽/오른쪽 Option 키를 “Esc+“로 설정
VS Code 터미널의 경우: VS Code 설정에서 "terminal.integrated.macOptionIsMeta": true를 설정합니다.

​
알림 설정

Claude가 작업을 완료하고 입력을 기다릴 때 알림 이벤트를 발생시킵니다. 이 이벤트를 터미널을 통한 데스크톱 알림으로 표시하거나 알림 훅을 사용하여 사용자 정의 로직을 실행할 수 있습니다.

​
터미널 알림

Kitty 및 Ghostty는 추가 구성 없이 데스크톱 알림을 지원합니다. iTerm 2는 설정이 필요합니다:
  1. iTerm 2 설정 → 프로필 → 터미널 열기
  2. “Notification Center Alerts” 활성화
  3. “Filter Alerts”를 클릭하고 “Send escape sequence-generated alerts” 확인
알림이 나타나지 않으면 터미널 앱이 OS 설정에서 알림 권한을 가지고 있는지 확인하세요. Claude Code를 tmux 내에서 실행할 때 알림 및 터미널 진행률 표시줄은 tmux 구성에서 통과를 활성화한 경우에만 iTerm2, Kitty 또는 Ghostty와 같은 외부 터미널에 도달합니다: 
set -g allow-passthrough on
이 설정이 없으면 tmux가 이스케이프 시퀀스를 가로채고 터미널 애플리케이션에 도달하지 않습니다. 기본 macOS 터미널을 포함한 다른 터미널은 기본 알림을 지원하지 않습니다. 대신 알림 훅을 사용하세요.

​
알림 훅

소리 재생 또는 메시지 전송과 같이 알림이 발생할 때 사용자 정의 동작을 추가하려면 알림 훅을 구성하세요. 훅은 터미널 알림과 함께 실행되며 대체가 아닙니다.

​
깜박임 및 메모리 사용량 감소

긴 세션 중에 깜박임이 보이거나 Claude가 작업 중일 때 터미널 스크롤 위치가 맨 위로 점프하면 전체 화면 렌더링을 시도하세요. 메모리를 평탄하게 유지하고 마우스 지원을 추가하는 대체 렌더링 경로를 사용합니다. CLAUDE_CODE_NO_FLICKER=1로 활성화합니다.

​
큰 입력 처리

광범위한 코드 또는 긴 지침으로 작업할 때:
  • 직접 붙여넣기 피하기: Claude Code는 매우 긴 붙여넣은 콘텐츠로 어려움을 겪을 수 있습니다
  • 파일 기반 워크플로우 사용: 파일에 콘텐츠를 작성하고 Claude에 읽도록 요청합니다
  • VS Code 제한 사항 인식: VS Code 터미널은 특히 긴 붙여넣기를 자르는 경향이 있습니다

​
Vim 모드

Claude Code는 /vim으로 활성화하거나 /config를 통해 구성할 수 있는 Vim 키 바인딩의 부분 집합을 지원합니다. 구성 파일에서 모드를 직접 설정하려면 ~/.claude.json에서 editorMode 전역 구성 키를 "vim"으로 설정합니다. 지원되는 부분 집합에는 다음이 포함됩니다:
  • 모드 전환: 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 (줄 결합)
완전한 참조는 대화형 모드를 참조하세요.