介入キー早見表

이 기사의 대상

Claude Code가 작업하는 도중에, 사용자 측에서 "멈추기", "방향 수정하기", "나중에 지시 추가하기"와 같은 개입 조작을 퀵 레퍼런스 표와 키별 짧은 해설로 정리합니다. 모든 내용은 공식 문서의 기술을 바탕으로 합니다.

대상은 Claude Code를 일상적으로 사용하면서 다음과 같은 상황에서 망설여지는 분들입니다.

• 멈추고 싶은데 Esc와 Ctrl+C 중 어느 것이 맞는지 매번 헷갈릴 때
• 작업을 멈추지 않고 지시를 추가하고 싶지만, 입력을 해도 되는지 모를 때
• 작성 중인 입력을 잃지 않고 다른 지시를 먼저 보내고 싶을 때

검증 환경은 2026년 6월 기준, Claude Code CLI v2.1 계열(수중 버전은 v2.1.177)입니다. 동작은 변경될 수 있으므로, 사용 중인 버전은 claude --version으로 확인하시기 바랍니다.

진행 컨트롤 단축키 목록 (퀵 레퍼런스 표)

먼저 전체적인 모습입니다. 이후에는 이 표의 위에서부터 순서대로 각 키를 해설합니다.

출처는 공식 문서의 "Interactive mode" / "How Claude Code works" / "Customize keyboard shortcuts"입니다 (끝에 링크).

Enter: 멈추지 않고 방향을 틀기 (steer)

가장 오해하기 쉬운 부분부터 시작합니다. 작업 중에 입력하고 Enter를 눌러도, 실행 중인 툴은 멈추지 않습니다. 공식 "How Claude Code works"의 「Interrupt and steer」에는 다음과 같이 적혀 있습니다.

Type a correction and press Enter to send it without stopping the running tool. Claude reads it as soon as the current action completes and adjusts before deciding its next step.

(수정 내용을 입력하고 Enter를 누르면, 실행 중인 툴을 정지하지 않고 전송할 수 있습니다. 현재 처리가 완료되는 대로 Claude가 이를 읽고, 다음 단계를 결정하기 전에 조정합니다.)

보낸 메시지는 실행을 멈추지 않으며, 현재 동작이 끝난 직후 또는 다음 단계를 결정하기 전에 읽혀 반영됩니다. 이것이 steer (조타/방향 전환) 입니다.

• 적합한 경우: 궤도가 크게 벗어나지는 않았지만, 방향을 조금 더하고 싶거나 좁히고 싶을 때
• 적합하지 않은 경우: 지금 동작 중인 툴 자체를 멈추고 싶을 때 (그것은 후술할 Esc 사용)

queue: 지시를 쌓기·불러오기·취소하기

작업 중에 계속해서 Enter로 보내면, 메시지는 순서대로 처리 대기 상태로 쌓입니다 (복수 가능).

쌓인 것 중 최신 1건은 입력란이 비어 있는 상태에서 ↑를 누르면 입력란으로 되돌릴 수 있습니다 (queue에서 꺼내지는 것이므로, 편집해서 다시 보내거나 그대로 삭제할 수도 있습니다).

단, 중간에 있는 1건만 개별적으로 편집·정렬·취소하는 UI는 없습니다. 오래된 1건을 빼고 싶을 때는 Esc 또는 Ctrl+C로 전체를 중단하고 다시 입력해야 합니다. 이러한 불편함에 대한 요청이 계속되고 있으며, 2026년 6월 기준으로 #34835(큐 기능 전반의 본체) 외 다수가 open 상태입니다.

Esc / Ctrl+C / Esc Esc: 중단하기 · 되돌리기 (rewind)

「중단」처럼 보이는 3가지 조작은 역할이 다릅니다.

Esc: 중단 후 유지 — 실행 중인 응답·도구 (tool)를 그 자리에서 멈추고 입력 대기 상태로 되돌립니다.

Stop the current response or tool call mid-turn so you can redirect. Claude keeps the work done so far
(진행 중인 답변이나 도구 호출을 도중에 정지하여 방향 수정 (steer)을 할 수 있습니다. 그때까지 완료된 작업은 그대로 유지됩니다.)

「그때까지의 작업은 유지된다」는 점이 포인트입니다. 처음부터 다시 하는 것이 아니라 「일단 멈추고 다시 지시하는」 조작입니다.

Ctrl+C: 중단·종료에 가까움 — 실행 중인 작업을 중단합니다. 아무것도 움직이지 않을 때는 1번 누르면 입력 클리어, 2번 누르면 Claude Code를 종료합니다. 「빠져나가는」 방향에 치우친 키이므로, 작업을 계속하고 싶다면 Esc가 안전합니다.

Esc Esc: 초안 삭제 / 되돌리기 (rewind) — 입력란에 글자가 있으면 초안을 지우고 (↑로 복원 가능), 비어 있다면 rewind 메뉴가 열려 코드와 대화를 과거 시점으로 복원할 수 있습니다.

When the prompt input contains text, double Esc clears it and saves the draft to history so Up recalls it. When the input is empty, double Esc opens the rewind menu to restore or summarize code and conversation from a previous point
(프롬프트 입력란에 텍스트가 있는 경우, Esc를 두 번 누르면 텍스트가 삭제되고 초안이 이력에 저장됩니다. 저장된 초안은 ↑ (위쪽 화살표 키)로 불러올 수 있습니다. 입력란이 비어 있는 경우, Esc를 두 번 누르면 리와인드 (rewind) 메뉴가 열려 과거 시점의 코드나 대화를 복원하거나 요약할 수 있습니다.)

Claude는 편집 전에 파일의 스냅샷 (snapshot)을 찍기 때문에, 편집 결과와 함께 이전 상태로 되돌릴 수 있습니다. steer나 Esc로는 되돌릴 수 없는 단계까지 진행했을 때의 최종 수단입니다.

[!tip]
중단 관련 기능은 꾸준히 수정되고 있습니다 (v2.1.160: 턴 시작 직후의 Esc 미작동 수정, v2.1.141: vim 모드 중의 Ctrl+C 수정). 작동하지 않는다고 느껴진다면 먼저 버전을 올려보세요.

Ctrl+S: 작성 중인 프롬프트를 임시 저장하기 (stash)

큐 (queue)와는 반대 방향으로, 지금 입력 중인 프롬프트를 잃지 않고 먼저 다른 용무를 처리하는 조작입니다.

• 작성 중에 Ctrl+S를 누르면 초안이 대피(stash)되고 입력란이 비워집니다 (상태에 "Stashed (auto-restores after submit)"라고 표시됨)
• 다른 질문이나 명령어를 입력하여 전송합니다.
• 해당 전송이 끝나면 대피했던 초안이 입력란에 자동으로 돌아옵니다.

이미지는 「git stash의 프롬프트 버전」입니다. 긴 지시를 구성하는 중에 급한 짧은 확인을 끼워 넣고 싶어도, 작성 중인 내용을 어딘가에 대피시켜 둘 필요가 없습니다.

공식 키 바인딩 (keybinding)은 chat:stash (기본값 Ctrl+S)입니다. 대피 슬롯은 1개이며, 되돌리기 전에 다시 한번 Ctrl+S를 누르면 덮어쓰기가 되고, 필요 없다면 Ctrl+C로 파기할 수 있습니다. 키 바인딩은 /keybindings (~/.claude/keybindings.json)에서 변경할 수 있으며, 커스텀 대응은 v2.1.18 이후부터 가능합니다. 단일 슬롯을 이력과 통합해 달라는 요청(#20806)도 나와 있습니다.

[!note]
Ctrl+S

문맥에 따라 역할이 달라집니다. 일반적인 입력창에서는 위의 스태시 (stash) 기능이며, Ctrl+R (이력 검색 (history search)) 중에는 검색 범위 (scope) 전환입니다 (historySearch:cycleScope: 이 세션 → 이 프로젝트 → 모든 프로젝트).

Shift+Tab: 권한 모드와 plan

Shift+Tab으로 권한 모드 (permission mode)를 순환합니다.

• default: 파일 편집 및 명령어 실행 시마다 확인
• acceptEdits: 편집이나 mkdir, mv 등을 확인 없이 실행
• plan: 소스를 편집하지 않고 계획만 수립 (Shift+Tab을 2번 눌러 진입)
• auto: 모든 작업을 백그라운드 안전 체크로 평가 (research preview)

"먼저 계획만 세우게 하고, 리뷰한 뒤에 구현한다"라는 2단계 방식은 plan 모드로 구현할 수 있습니다. 작업의 자유도를 그 자리에서 조이거나 풀 수 있는, 진행 제어 (progress control)의 일부입니다.

Ctrl+B / Ctrl+X Ctrl+K: 백그라운드와 일괄 중단

• Ctrl+B: 실행 중인 bash 명령어 또는 에이전트 (agent)를 백그라운드 (background)로 퇴피 (tmux 사용자는 2번 입력). 긴 빌드나 테스트를 실행 중인 상태로 유지하며 다른 작업을 계속할 수 있습니다.
• Ctrl+X Ctrl+K: 이 세션에서 동작 중인 백그라운드 서브 에이전트 (sub-agent)를 모두 중단 (3초 이내에 2번 입력하여 확정).

Ctrl+T: 태스크 리스트 (task list)

Ctrl+T로 태스크 리스트 표시를 전환합니다. 여러 단계의 작업에서 무엇이 대기 중 (pending) / 진행 중 (in progress) / 완료되었는지를 파악하며 진행할 수 있습니다.

/btw: 중단하지 않고 곁다리 질문하기

/btw는 작업을 멈추지 않고 옆에서 질문할 수 있는 명령어입니다. Claude가 처리 중인 도중에도 실행할 수 있으며, 메인 흐름의 턴 (turn)을 중단하지 않습니다. 도구 접근 (tool access)은 없으며 (현재 컨텍스트에 있는 정보로만 답변), 주고받은 내용은 대화 이력에도 남지 않습니다. "방금 읽은 설정 파일 이름이 뭐였지?"와 같은 내용을 메인 흐름을 방해하지 않고 확인하고 싶을 때 적합합니다.

요약

작업 중 개입은 목적에 따라 선택하면 혼란이 없습니다. 자세한 내용은 서두의 요약표에 집약되어 있습니다.

• 방향을 바로잡거나 지시를 추가할 때 → 중단 없이 Enter (steer)
• 현재 동작 중인 처리를 멈추고 다시 지시할 때 → Esc (작업은 유지)
• 편집 결과와 함께 과거로 되돌릴 때 → Esc Esc (빈 입력으로 rewind)
• 작성 중인 내용을 잃지 않고 다른 지시를 먼저 보낼 때 → Ctrl+S (stash, 전송 후 자동 복귀)
• 권한 및 계획을 전환할 때 → Shift+Tab (plan은 2번)

Claude Code는 "실행하면서 키를 잡는 것"은 능숙한 반면, "여러 지시를 쌓아두었다가 나중에 한꺼번에 흘려보내기"나 "queue 중간의 1건만 취소하기"는 아직 취약하여 관련 요청이 지속되고 있습니다. 이러한 비대칭성을 고려하여 Enter와 Esc를 구분해서 사용하는 것만으로도 불필요한 전체 중단을 크게 줄일 수 있습니다.

출처

• Claude Code Docs — Interactive mode
• Claude Code Docs — How Claude Code works
• Claude Code Docs — Customize keyboard shortcuts (keybindings)
• Claude Code Docs — Changelog
• anthropics/claude-code Issues: #34835 / #50246 / #20806 (stash 개선 요청) / #48802 / #6147

Discussion