클로드코드 16-terminal-config

1. 터미널 설정

참고: Shift+Enter, 알림, tmux, 테마, Vim 모드 등 터미널 환경 구성

1.1. 멀티라인 프롬프트 입력

Enter는 메시지를 제출한다. 줄바꿈만 하려면:

- Ctrl+J - 모든 터미널에서 작동
- \ + Enter - 모든 터미널에서 작동
- Shift+Enter - 터미널 에뮬레이터에 따라 다름

- 터미널: Shift+Enter 지원
- Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal, Windows Terminal: 별도 설정 없이 작동
- VS Code, Cursor, Windsurf, Alacritty, Zed: /terminal-setup 한 번 실행
- gnome-terminal, JetBrains IDEs: 미지원; Ctrl+J 또는 \ 사용

참고: tmux 내부에서 실행 중이면 tmux 설정도 필요하다.

1.2. macOS Option 키 단축키

일부 Claude Code 단축키는 Option 키를 사용한다(예: Option+Enter로 줄바꿈, Option+P로 모델 전환). macOS 터미널에서 Option을 Meta 키로 활성화해야 한다.

- Apple Terminal: Settings → Profiles → Keyboard → "Use Option as Meta Key"
- iTerm2: Settings → Profiles → Keys → General → "Esc+"
- VS Code: "terminal.integrated.macOptionIsMeta": true

1.3. 알림 설정

Claude가 작업을 마치거나 권한 프롬프트를 멈출 때 알림 이벤트가 발생한다.

1.3.1. 기본 동작

- Ghostty, Kitty, iTerm2: 기본적으로 데스크톱 알림
- 기타 터미널: preferredNotifChannel을 "terminal_bell"로 설정

1.3.2. Notification Hook

{
  "hooks": {
    "Notification": [{
      "hooks": [{
        "type": "command",
        "command": "afplay /System/Library/Sounds/Glass.aiff"
      }]
    }]
  }
}

1.4. tmux 설정

tmux 내부에서는 Shift+Enter와 데스크톱 알림이 기본적으로 작동하지 않는다.

~/.tmux.conf에 추가:

set -g allow-passthrough on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

변경 적용: tmux source-file ~/.tmux.conf

1.5. 테마 설정

1.5.1. 내장 테마

/theme 또는 /config에서 선택. "auto"는 터미널의 밝기/어두움을 감지한다.

1.5.2. 커스텀 테마

/theme → "New custom theme…"로 생성하거나 ~/.claude/themes/에 JSON 파일 작성.

{
  "name": "Dracula",
  "base": "dark",
  "overrides": {
    "claude": "#bd93f9",
    "error": "#ff5555",
    "success": "#50fa7b"
  }
}

참고: 파일 변경 시 자동으로 재로드된다.

1.6. Fullscreen 렌더링

화면이 깜빡이거나 스크롤백이 점프하면 fullscreen 모드를 사용한다.

CLAUDE_CODE_NO_FLICKER=1 claude

또는 세션 중 /tui fullscreen 실행.

1.7. Vim 키 바인딩

/config → Editor mode에서 "vim"을 선택하거나 설정:

{
  "editorMode": "vim"
}

- NORMAL/VISUAL 모션 지원: hjkl, v/V, d/c/y
- INSERT 모드에서 Enter는 여전히 제출
- o/O 또는 Ctrl+J로 줄바꿈

1.8. 대용량 붙여넣기

10,000자 이상 붙여넣으면 [Pasted text] placeholder로 축소된다. 매우 큰 입력은 파일로 저장 후 Claude에게 읽도록 요청하는 것이 좋다.

1.9. 관련 문서

- Interactive mode: 전체 키보드 단축키
- Keybindings: Claude Code 단축키 재매핑
- Fullscreen: 검색, 복사, 스크롤