Cursor 에디터 필수 단축키 모음 — 코딩 속도 2배 올리는 실전 가이드
AI 코드 에디터 Cursor에서 매일 쓰는 핵심 단축키를 Mac과 Windows 기준으로 정리했습니다. 인라인 편집, 컴포저(Composer), @ 심볼 컨텍스트 활용법과 Diff 수락 요령까지 확인해 보세요.
안녕하세요. Jay입니다!
VS Code 기반의 AI 코드 에디터 Cursor를 사용할 때, 마우스로 사이드바 아이콘을 클릭하고 채팅창을 마우스로 찍어 프롬프트를 입력하고 계신가요? 에디터에서 손이 키보드를 떠나는 순간 코딩의 흐름과 몰입이 끊기게 됩니다.
Cursor는 AI 특화 기능들이 키보드 단축키와 긴밀하게 결합되어 있어, 몇 가지 핵심 조합만 손에 익혀도 작업 속도와 체감 생산성이 크게 달라집니다. 오늘은 제가 매일 코딩하며 가장 빈번하게 사용하는 Cursor 필수 단축키와 실전 워크플로를 정리해 보았습니다.
⌨️ 가장 자주 쓰는 핵심 단축키 4선
Cursor를 Cursor답게 만드는 대표 기능 4가지의 단축키입니다. Mac과 Windows/Linux 환경에 맞춰 정리했습니다.
| 기능 | Mac | Windows / Linux | 주요 용도 |
|---|---|---|---|
| 인라인 편집 (Generate) | ⌘ + K |
Ctrl + K |
현재 에디터 라인이나 선택한 코드 블록을 그 자리에서 직접 수정·생성 |
| AI 채팅 (Chat) | ⌘ + L |
Ctrl + L |
우측 사이드바 채팅 패널 열기 및 현재 선택 코드를 문맥으로 전달 |
| 컴포저 (Composer) | ⌘ + I |
Ctrl + I |
여러 파일을 넘나들며 프로젝트 단위로 코드를 생성·수정하는 에이전트 창 |
| 터미널 AI 질의 | ⌘ + K (터미널 내) |
Ctrl + K (터미널 내) |
터미널 에러 메시지나 필요한 셸 명령어를 자연어로 질의 및 자동 완성 |
- ⌘K (인라인 편집): 가장 기본적이고 강력한 단축키입니다. 에디터에서 코드를 드래그한 뒤
⌘K를 누르고 "이 함수를 비동기 async/await로 바꿔줘", "타입 에러 수정해줘"라고 입력하면 코드 위에서 바로 수정 Diff가 생성됩니다. - ⌘L (채팅): 코드를 직접 고치기보다 "이 로직이 왜 필요해?", "어떤 패턴을 적용하는 게 좋을까?"처럼 질문하고 대안을 비교할 때 씁니다. 코드를 선택하고
⌘L을 누르면 해당 블록이 자동으로 참조됩니다. - ⌘I (Composer): 단일 파일 수준을 넘어 신규 컴포넌트를 만들고, 라우팅을 등록하고, 스타일 파일까지 동시에 수정해야 할 때 필수적입니다. 전체 화면(
⌘⇧I)으로 넓혀서 작업할 수도 있습니다.
🎯 맥락을 정확하게 짚어주는 '@' 심볼 단축키
채팅(⌘L)이나 인라인 편집(⌘K), 컴포저(⌘I) 입력창에서 @를 입력하면 AI에게 정확한 컨텍스트(참조 대상)를 지정할 수 있습니다.
@Files: 프로젝트 내 특정 파일 전체를 프롬프트 문맥으로 추가합니다. (예:@userApi.ts 이 API 명세에 맞춰 핸들러 작성해줘)@Folders: 폴더 단위의 모든 구조와 코드를 참조시킵니다.@Code: 특정 함수나 클래스 심볼만 정확히 짚어서 넘겨줍니다. 파일 전체를 넘기는 것보다 토큰을 아끼고 답변 정확도를 높입니다.@Docs: Next.js, Tailwind, Flutter 등 공식 프레임워크 문서를 참조해 환각(Hallucination) 없는 최신 문법으로 작성하도록 유도합니다.@Web: 최신 라이브러리 릴리스나 에러 해결책을 웹 검색을 통해 찾아 답변하도록 지시합니다.
마우스로 파일을 찾아 끌어다 놓지 않고, 키보드로 @를 치고 파일명의 앞 글자 몇 개만 타이핑해 Enter를 치면 즉시 컨텍스트에 포함됩니다.
⚡️ 키보드만으로 끝내는 3단계 실전 편집 루프
Cursor에서 작업을 가장 빠르게 마치는 정석 루틴은 다음과 같습니다.
- 선택 및 지시: 수정할 코드 블록을 잡고
⌘K를 누른 뒤 변경 요구사항을 입력하고Enter. - Diff 확인 및 탐색: AI가 제안한 초록색(추가)·빨간색(삭제) 영역을 살핍니다.
- 다음 변경 지점으로 이동:
⌘ + N(Windows:Ctrl + N또는 화살표) - 변경 사항 한 줄 취소:
Escape
- 다음 변경 지점으로 이동:
- 결과 수락/거절:
- 전체 수락:
⌘ + Y(Windows:Ctrl + Y) 또는⌘ + Enter - 전체 거절:
⌘ + N(Windows:Ctrl + N)
- 전체 수락:
이 루프가 손에 익으면 "코드 드래그 → ⌘K → 프롬프트 작성 → Enter → 변경 확인 → ⌘Y"가 마우스 클릭 한 번 없이 5초 만에 완료됩니다.
💡 Jay의 Cursor 단축키 활용 팁
⌘Y를 무의식적으로 연타하지 마세요: AI가 제안한 코드가 그럴듯해 보여도 사소한 타입 누락이나 기존 예외 처리가 빠져 있을 수 있습니다. 반드시 눈으로 diff를 1~2초 훑어본 다음 수락 단축키를 누르는 습관이 디버깅 시간을 수십 분 아껴줍니다.- 터미널 오류는 드래그하지 말고 터미널에서 바로
⌘K: 빌드나 테스트가 깨졌을 때 긴 스택 트레이스를 복사해서 채팅창에 붙여넣지 마세요. 터미널 창을 클릭한 뒤⌘K를 누르면 방금 실패한 터미널 출력 전체가 자동으로 프롬프트 문맥에 들어가 원인과 수정 명령어를 한 번에 제시해 줍니다. - 전체 창 Composer(
⌘ + Shift + I): 듀얼 모니터를 쓰지 않는 작은 화면의 노트북에서는 우측 사이드바가 코드 영역을 좁힙니다. 이때 전체 화면 컴포저 모드를 쓰면 훨씬 쾌적하게 작업할 수 있습니다.
결론
단축키는 단순히 손을 바쁘게 움직이는 기교가 아니라, 생각의 속도와 코딩의 속도를 일치시키는 도구입니다. 처음에는 ⌘K(인라인 편집), ⌘L(채팅), ⌘I(컴포저), 그리고 수락 단축키 ⌘Y 딱 4개만 의식적으로 마우스 대신 써보세요. 며칠만 지나도 마우스로 에디터 메뉴를 누르던 때로 돌아가기 어려워질 것입니다.
다음에도 유익한 포스팅으로 찾아오겠습니다. 감사합니다!