CATEGORY

카테고리 (674)
AI (72)
Language & Specs (260)
FrameWork (36)
Library (20)
App (41)
Git (10)
Build & Dependency (2)
AWS (15)
DataBase (45)
OS (33)
Tool (17)
IT (120)
SEEMINGLY ONLINE

Seemingly
Online

이모저모 방방곡곡 두루두루 개발지식 저장소

RECENT POSTS

AI/Claude

클로드 코드 단축키 정리 — 모드 전환·줄바꿈·모델 변경 한 번에

반응형

클로드 코드에서 가장 많이 쓰는 단축키는 넷입니다. 권한 모드 전환은 Shift+Tab(default → acceptEdits → plan 순환), 실행 중단은 Esc, 모델 변경은 Option+P(맥)·Alt+P(윈도우·리눅스), 프롬프트 줄바꿈은 \ + Enter입니다. 맥에서 Option(Alt) 단축키가 안 먹으면 터미널에서 "Option을 Meta로" 설정해야 합니다. 아래는 Claude Code 2.1.202 기준으로 상황별로 정리한 것입니다.

💡 단축키는 터미널·OS마다 조금씩 다릅니다. 세션 안에서 빈 입력에 ?를 누르면 지금 내 환경에서 쓸 수 있는 단축키 도움 패널이 뜹니다. 아래 목록과 함께 그걸로 확인하세요.

꼭 알아야 할 핵심 단축키

나머지는 몰라도 이 여섯 개만 손에 익히면 작업 흐름이 크게 빨라집니다.

단축키 하는 일
Shift+Tab 권한 모드 순환 (Manual → acceptEdits → plan → 켜 둔 모드)
Esc 응답·도구 실행 중단 (지금까지 한 작업은 유지). 열린 대화창은 닫기
Esc Esc 입력 지우기(초안은 히스토리에 저장). 입력이 비어 있으면 되감기(rewind) 메뉴
Ctrl+C 중단, 또는 입력 지우기. 실행 중인 게 없을 때 두 번 누르면 종료
Ctrl+R 이전에 친 프롬프트 역방향 검색
\ + Enter 여러 줄 입력(줄바꿈) — 모든 터미널에서 동작

모드 전환·모델 변경·확장 사고

탐색할 땐 plan 모드, 실제로 고칠 땐 acceptEdits 모드로 바꿔 가며 쓰면 확인 횟수가 줄어듭니다. 전환은 전부 Shift+Tab 한 키로 순환합니다.

단축키 하는 일
Shift+Tab 권한 모드 순환. 윈도우에서 런타임이 VT 입력을 못 켤 땐 Alt+M
Option+P / Alt+P 모델 변경 (입력한 프롬프트는 지워지지 않음)
Option+T / Alt+T 확장 사고(extended thinking) 켜기·끄기
Option+O / Alt+O 패스트 모드 켜기·끄기

Shift+Tab이 순환하는 default·acceptEdits·plan·bypassPermissions 각 모드가 무엇을 허용하는지는 클로드 코드 권한 설정 글에서 자세히 정리했습니다.

⚠️ 맥에서 Option+P·Alt+* 계열이 안 먹으면 대부분 "Option을 Meta 키로" 설정하지 않았기 때문입니다(맨 아래 §맥 사용자 주의 참고). 단 확장 사고 Option+T는 2.1.132부터 이 설정 없이도 동작합니다.

여러 줄 입력(줄바꿈)이 바로 전송될 때

Enter를 치면 줄이 안 바뀌고 바로 전송돼 버리는 문제입니다. 터미널이 Shift+Enter를 기본 지원하는지에 따라 방법이 갈립니다.

방법 언제
\ + Enter 가장 확실 — 모든 터미널에서 동작
Ctrl+J 설정 없이 어느 터미널에서나 동작
Shift+Enter iTerm2·WezTerm·Ghostty·Kitty·Warp·기본 터미널·Windows Terminal은 그대로 됨
Option+Enter 맥에서 "Option을 Meta로" 설정한 뒤

VS Code·Cursor·Alacritty·Zed에서 Shift+Enter로 줄바꿈하고 싶으면 세션에서 /terminal-setup을 한 번 실행해 바인딩을 설치하면 됩니다.

입력 편집·커서 이동

프롬프트를 길게 쓸 때 마우스 없이 커서를 옮기고 지우는 readline 계열 단축키입니다.

단축키 하는 일
Ctrl+A / Ctrl+E 현재 줄 맨 앞 / 맨 끝으로 커서 이동
Ctrl+K / Ctrl+U 커서부터 줄 끝까지 / 줄 앞까지 삭제 (지운 건 저장돼 붙여넣기 가능)
Ctrl+W 앞 단어 삭제 (맥은 Option+Delete, 윈도우는 Ctrl+Backspace도 됨)
Ctrl+Y 위에서 지운 텍스트 붙여넣기
Alt+B / Alt+F 단어 단위로 뒤로 / 앞으로 이동 (맥은 Option을 Meta로)
Ctrl+G 기본 텍스트 편집기로 프롬프트 열어서 편집

화면·기록·세션 관리

단축키 하는 일
Ctrl+L 화면 다시 그리기(깨진 표시 복구). 2초 안에 두 번이면 /clear 실행
Ctrl+O 트랜스크립트 뷰어 열기(도구 사용·모델 상세 보기)
Ctrl+T 클로드의 할 일 체크리스트 보이기·숨기기
Ctrl+B 실행 중인 Bash·에이전트를 백그라운드로 (tmux는 두 번)
Ctrl+V / Alt+V 클립보드 이미지 붙여넣기 ([Image #N] 칩 삽입). WSL은 Alt+V
Ctrl+D 세션 종료 (800ms 안에 두 번). 입력에 글자가 있으면 커서 뒤 글자 삭제
Ctrl+Z 일시 중단(유닉스). 셸에서 fg로 복귀

Ctrl+L 두 번으로 실행되는 /clear와 /compact의 차이(대화 기록을 지우느냐 요약하느냐)는 클로드 코드 컨텍스트 관리에서 다뤘습니다. 그리고 /로 실행하는 명령들은 클로드 코드 슬래시 명령어 글에 정리해 두었습니다.

vim 편집 모드 쓰기

프롬프트 편집을 vim처럼 하고 싶으면 /config → Editor mode에서 켭니다. Esc로 NORMAL 모드, i로 INSERT 모드이고 h j k l·dd·yy 같은 기본 조작이 됩니다. 아래처럼 사용자 설정 파일(~/.claude/settings.json)에 넣으면 vim 모드를 켜고 INSERT에서 jj를 Esc로 매핑할 수 있습니다.

{
  "editorMode": "vim",
  "vimInsertModeRemaps": { "jj": "<Esc>" }
}

매핑은 정확히 두 글자 시퀀스이고 대상은 "<Esc>"만 지원합니다. 이 설정은 사용자 설정 파일에서만 읽고, 프로젝트의 .claude/settings.json에 넣은 것은 무시됩니다(체크아웃한 저장소가 내 키 입력을 바꾸지 못하게).

자주 묻는 질문 (FAQ)

Q. Shift+Tab을 눌러도 모드가 안 바뀌어요.
윈도우에서 Node·Bun 런타임이 VT 입력 모드를 못 켜는 경우가 있습니다. 이때는 Alt+M으로 같은 순환을 할 수 있습니다.

Q. 맥인데 Option+P·Alt+B 같은 게 안 먹어요.
터미널에서 Option 키를 Meta로 쓰도록 설정해야 합니다. iTerm2는 Settings → Profiles → Keys에서 Option 키를 "Esc+"로, 기본 터미널은 Settings → Profiles → Keyboard에서 "Use Option as Meta Key" 체크, VS Code는 "terminal.integrated.macOptionIsMeta": true를 설정합니다.

Q. Enter를 치면 줄바꿈 없이 바로 보내져요.
가장 확실한 건 \ + Enter 또는 Ctrl+J입니다. Shift+Enter로 하고 싶은데 안 되는 터미널(VS Code·Cursor 등)은 /terminal-setup을 한 번 실행하세요.

Q. 지금 내 환경에서 되는 단축키 전체를 보고 싶어요.
입력이 비어 있을 때 ?를 누르면 단축키 도움 패널이 열립니다. 단축키는 버전·터미널마다 달라지니 이 패널이 가장 정확합니다.

마무리

정리하면, 흐름을 바꾸는 건 결국 Shift+Tab(모드 전환)·Esc(중단)·Esc Esc(되감기)·Ctrl+R(기록 검색) 네 개입니다. 나머지는 필요할 때 이 글에서 찾아 쓰면 됩니다. 여기 표기는 Claude Code 2.1.202 기준이고, 버전이 오르며 단축키가 늘어나므로 최종 확인은 세션 안 ? 패널과 공식 문서로 하세요. 기본 바인딩을 내 손에 맞게 바꾸고 싶으면 공식 키보드 단축키 사용자 정의 문서를 보면 됩니다.


📚 참고 출처 (2026년 7월 27일 확인 · Claude Code 2.1.202)
· Claude Code — Interactive mode
· Claude Code — 키보드 단축키 사용자 정의
· Claude Code — Terminal configuration

반응형

COMMENTS