Cursor 단축키 완벽 가이드 [Windows/Mac, 실전 예제 포함]

Cursor를 사용하기 시작하는 순간 바로 체감하게 되는 점이 있습니다. 바로 키보드 단축키를 실제로 익혔느냐에 따라 생산성이 극적으로 달라진다는 것입니다.

이 글에서는 공식 문서를 바탕으로 Windows 및 Mac 단축키 전체 목록을 다루며, 사람들이 흔히 “어디에 쓰는 거지?” 하고 의아해하는 기능들에 대해서는 더 자세히 살펴봅니다.

단축키 확인 방법 모든 단축키는 Ctrl R → Ctrl S (Mac: Cmd R → Cmd S)를 누르거나, 커맨드 팔레트(Ctrl Shift P / Cmd Shift P)에서 “Keyboard Shortcuts”를 검색하면 확인할 수 있습니다.

Cursor 전용 키보드 단축키는 [Keyboard Shortcuts] 설정에서 언제든지 자유롭게 재할당할 수 있습니다.

일반 / 전역 작업

🔍 Ctrl I / Cmd I — Agent와 Chat의 차이

Ctrl I(Cmd I)은 Agent 모드(구 Composer)를 열고, Ctrl L(Cmd L)는 Chat 모드를 엽니다. 둘 다 AI 사이드 패널을 호출하지만 목적이 다릅니다.

• Agent (Ctrl I): 파일 전체를 아우르는 대규모 변경이나 새 기능 추가 등 전체 작업을 한 번에 맡길 때 사용합니다.
• Chat (Ctrl L): 코드에 대한 설명을 듣거나, 조언을 구하거나, 코드를 직접 수정하지 않고 질문만 하고 싶을 때 사용합니다.

예시: “이 컴포넌트를 TypeScript로 마이그레이션해 줘”라고 말하고 싶다면? Ctrl I을 사용하세요. “이 함수가 하는 일을 평문(영문)으로 설명해 줘”라고 하고 싶다면? Ctrl L을 사용하세요.

🔍 Ctrl . — 모드 메뉴란 무엇인가요?

Ctrl .(Cmd .)를 누르면 Agent / Ask / Plan 모드 전환 메뉴가 나타납니다.

• Agent: 코드를 자율적으로 수정하고 실행합니다.
• Ask: 코드를 수정하지 않고 질문에 답변합니다 (코드베이스 전체를 검색해 답변).
• Plan: 구현 계획만 세우고 실제 코드는 변경하지 않습니다.

경험칙: “먼저 어떤 일이 일어날지 확인하고 싶다” → Plan. “개념을 이해하고 싶다” → Ask. “그냥 바로 만들어 줘” → Agent.

🔍 Ctrl / — 즉시 모델 전환하기

Ctrl /(Cmd /)을 누를 때마다 사용 가능한 다음 AI 모델로 순환 전환됩니다. 까다로운 작업에는 Opus 같은 고성능 모델을 쓰고, 속도가 더 중요할 때는 가벼운 모델을 사용하여 작업 중 실시간으로 비용과 속도의 균형을 맞출 수 있습니다.

AI Chat

채팅 입력창에서 사용하는 단축키입니다.

🔍 Enter 대 Ctrl Enter — “Nudge”와 “Queue”의 차이

기본 Enter는 “Nudge” 전송으로, Agent에게 “다음 단계만 살짝” 진행하도록 유도합니다. 반면 Ctrl Enter은 메시지를 대기열(Queue)에 추가하여, Agent가 현재 작업을 마친 후 이어서 처리할 지시사항들을 쌓아둘 수 있게 해줍니다.

예시: Agent가 인증 기능을 한창 만드는 도중에 “아, 로그아웃 플로우를 깜빡했네”라는 생각이 들었다면? Ctrl Enter로 대기열에 추가해 두세요. 현재 작업이 끝나면 바로 이어서 처리됩니다.

🔍 Ctrl V 대 Ctrl Shift V — 에러 로그 붙여넣기

터미널에서 에러를 복사해 채팅창에 붙여넣을 때, 두 단축키는 다르게 작동합니다.

• Ctrl V: 컨텍스트로 첨부합니다 (UI에 코드 블록 스타일로 깔끔하게 렌더링됨).
• Ctrl Shift V: 입력 필드에 일반 텍스트 형태로 곧바로 붙여넣습니다.

AI가 에러를 제대로 읽게 하고 싶다면 Ctrl V을 사용하는 것이 훨씬 편합니다.

🔍 Ctrl Shift Backspace — 생성 중단 빠르게 하기

AI가 엉뚱한 방향으로 가고 있다면 남은 생성이 완료될 때까지 기다릴 필요 없이 즉시 취소할 수 있습니다. 생성이 멈추면 지시사항을 수정하고 다시 전송하세요.

Inline Edit (인라인 편집)

사이드 패널을 열지 않고 에디터 내에서 선택한 코드에 직접 편집 지시를 내릴 수 있습니다. 모든 작업이 커서 위치에서 바로 이루어집니다.

🔍 Ctrl K / Cmd K — 가장 많이 쓰게 될 AI 단축키

코드를 드래그하여 선택하고 Ctrl K(Cmd K)을 누르면 그 자리에 작은 프롬프트 바가 나타납니다. 사이드 패널을 열 필요 없이 그 자리에서 바로 “이 함수 리팩터링해 줘”, “주석 추가해 줘”, “이 버그 고쳐줘”라고 입력하면 됩니다.

전형적인 워크플로:

1. 변경하고 싶은 코드를 드래그하여 선택합니다.
2. Ctrl K(Cmd K)를 누릅니다.
3. “reduce를 사용해서 이 루프를 다시 작성해 줘” 같은 내용을 입력합니다.
4. Enter를 눌러 전송하면 diff(변경 사항 비교 화면)가 나타납니다.
5. Ctrl Enter(Cmd Enter)를 눌러 수락하거나, Ctrl Backspace(Cmd Backspace)을 눌러 거부합니다.

알아두면 좋은 팁: 아무것도 선택하지 않은 상태에서 Ctrl K를 누르면, 커서 주변의 줄들을 컨텍스트로 활용해 새 코드를 생성합니다. 빈 함수 안에 커서를 두고 Ctrl K을 누른 뒤 “유효성 검사 로직 작성해 줘”라고 입력해 보세요. 알아서 코드를 작성해 줍니다.

🔍 Alt Enter / Option Enter — 코드를 건드리지 않는 “빠른 질문”

Alt Enter(Option Enter)은 “빠른 질문(quick question)” 모드를 엽니다. 일반적인 Enter는 코드를 변경하라는 지시로 처리되지만, 이 단축키는 읽기 전용 질문용입니다 — “이 코드가 무슨 일을 하는 거지?”처럼 단순히 설명을 원할 때 사용합니다. 코드는 전혀 변경되지 않고 채팅 형식의 답변을 받아볼 수 있습니다.

코드 선택 및 컨텍스트 추가

🔍 “Chat에 추가” vs “Edit에 추가” vs “새 Chat에 추가” — 세 가지의 차이점

코드를 선택하고 나면 해당 코드를 보낼 수 있는 곳이 세 군데 있습니다.

예시: 버그가 있는 것으로 의심되는 함수를 발견했다면? 코드를 선택하고 Ctrl L를 눌러 새 채팅을 시작한 뒤 “이 함수에 뭐가 잘못됐지?”라고 물어보세요.

🔍 Ctrl M / Cmd M — 파일 읽기 방식 전환

잘 알려지지 않았지만 대단히 유용한 기능입니다. Cursor가 파일을 읽는 방식(전체 텍스트 읽기 대 아웃라인 읽기 등)을 토글합니다. 용량이 거대한 파일을 다룰 때 토큰을 절약하는 데 매우 유용합니다.

🔍 @ 멘션과 / 단축키

채팅 입력창에 @를 입력하면 파일, 폴더, git 커밋, 웹페이지 등을 컨텍스트로 불러올 수 있습니다.

자주 사용되는 @ 멘션:

• @filename: 특정 파일을 컨텍스트로 불러옵니다.
• @Codebase: 저장소 전체를 시맨틱하게 검색하여 컨텍스트로 활용합니다.
• @Docs: Cursor에 등록해 둔 문서를 참조합니다.
• @Web: 웹 검색 결과를 컨텍스트로 불러옵니다.

/는 단축 명령어를 트리거하여, 자주 사용하는 기능(/edit, /generate 등)을 빠르게 호출할 수 있게 해줍니다.

Tab Completion (탭 자동 완성)

🔍 Ctrl → / Cmd → — “부분 수락”이토록 유용한 이유

Tab 완성 제안이 너무 길어서 일부만 필요할 때 유용합니다. Tab으로 모든 내용을 한 번에 수락하는 대신, Ctrl →(Cmd →)을 누르면 단어 단위로 하나씩 수락할 수 있습니다.

예시: AI가 getUserByEmailAndRole(email, role, includeDeleted)를 제안했지만 includeDeleted 인자는 필요 없다면? Ctrl →을 눌러 단어별로 확인하며 필요한 부분까지만 가져오면 됩니다.

Terminal AI

터미널 내부에서 AI가 직접 셸 명령어를 생성해 주도록 합니다.

🔍 터미널 Ctrl K — 평문으로 셸 명령어 생성하기

터미널에 포커스가 된 상태에서 Ctrl K(Cmd K)를 누르면 일반 에디터의 인라인 편집과는 다른 “터미널 프롬프트 바”가 열립니다. 하고 싶은 작업을 평문(영어 또는 일본어 등)으로 설명하면 셸 명령어를 생성해 줍니다.

사용 방법:

1. 터미널을 클릭하여 포커스를 줍니다.
2. Ctrl K를 누릅니다.
3. “3일보다 오래된 모든 .log 파일을 삭제해 줘” 같은 내용을 입력합니다.
4. Enter를 눌러 명령어를 생성합니다 (예: find . -name "*.log" -mtime +3 -delete).
5. 내용을 검토한 뒤 Ctrl Enter로 실행하거나, 필요 없으면 Esc을 눌러 취소합니다.

복잡한 문법이 가끔 헷갈릴 때 — 특히 find, awk, sed, grep 같은 까다로운 명령어들을 다룰 때 정말 유용합니다.

알아두면 좋은 콤보 기술

몇 가지 단축키는 혼자 쓰는 것보다 연달아 체인처럼 사용할 때 훨씬 더 강력해집니다.

콤보 #1: 타겟형 리팩터링

Select code → Ctrl K → "add error handling" → Enter → review the diff → Ctrl Enter to accept

Agent가 파일 전체를 건드리기를 원치 않을 때, 영향 범위를 선택한 영역으로만 제한해 줍니다.

콤보 #2: 코드베이스 전체를 대상으로 한 질문

Ctrl L (new chat) → @Codebase → "which file handles the auth logic?"

@Codebase을 사용하면 Cursor가 저장소 전체를 시맨틱하게 검색하여 답변해 줍니다. “아, 그 파일이 어디 있었더라?” 하는 순간에 수동으로 검색하는 것보다 훨씬 빠르며, 평문으로 바로 질문할 수 있습니다.

콤보 #3: 터미널 에러를 곧바로 끌어오기

Copy the terminal error output → Ctrl V in the chat input → "how do I fix this error?"

Ctrl V를 사용하면 에러가 깔끔한 코드 블록으로 첨부되므로, 긴 스택 트레이스라도 깨끗하고 유용한 컨텍스트로 전달됩니다.

콤보 #4: 계획을 먼저 세우고 실행하기

Ctrl I → Ctrl . (switch modes) → select Plan → "I want to add user authentication" → review the plan → Ctrl . (switch to Agent) → run it

Agent를 즉시 풀어놓는 대신, Plan 모드에서 먼저 접근 방식을 확인하고 그 후에 Agent로 전환하면 원치 않는 대규모 코드 변경을 방지할 수 있습니다.

요약: 가장 먼저 익혀야 할 단축키 7선

Cursor를 막 시작했다면, 다음 단축키들을 먼저 내 것으로 만드는 것이 생산성을 가장 빠르게 끌어올리는 지름길입니다.

이 모든 걸 한 번에 외우려고 하지 마세요. 오늘은 Ctrl K를 써보고, 내일은 @Codebase를 써보는 식으로 하나씩 늘려가면 됩니다. 쓰면 쓸수록, 단축키 없던 시절에 어떻게 코딩했는지 신기해하게 될 것입니다.

최종 업데이트: 2026년 6월 (Cursor 3.7) 참조: Cursor 공식 문서