Cursor AI 입문 가이드 — 처음 30분이 전부다

Cursor는 AI가 내장된 코드 에디터입니다. VS Code를 포크해서 만들었기 때문에, VS Code 사용자라면 이질감 없이 바로 적응할 수 있어요. 이 글에서는 “처음 켜는 분”을 위해 5단계로 정리합니다.

1단계: 설치

cursor.com에서 운영체제에 맞는 버전을 받습니다. 설치 후 처음 실행하면 VS Code 설정/확장 가져올지 물어봅니다 — Yes를 누르세요.

2단계: AI 단축키 익히기

단축키	동작
Ctrl + K	선택 영역을 AI로 수정/생성
Ctrl + L	채팅 패널 열기
Ctrl + I	인라인 명령 (Composer)

가장 자주 쓰이는 건 Ctrl + K입니다. 코드 블록을 선택한 뒤 “이걸 async로 바꿔줘” 같은 자연어 지시를 내리면 즉시 반영돼요.

3단계: 코드베이스와 대화하기 — @Codebase

Ctrl + L로 채팅을 열고 @Codebase라고 입력하면, AI가 현재 프로젝트 전체를 맥락으로 이해한 채로 답해줍니다.

“이 프로젝트의 라우팅 구조 설명해줘” “유저 인증 로직 어디 있어?”

별도 설정 없이도 프로젝트 구조를 빠르게 파악할 수 있어서, 새 레포에 합류한 첫 주에 특히 유용합니다.

4단계: 한 줄로 새 기능 만들기

실전 예시. 빈 파일에서 Ctrl + I를 누르고 다음을 입력합니다.

React 컴포넌트로, 0~100까지 카운트업하는 숫자 애니메이션을 만들어줘.

3초 만에 작동하는 컴포넌트가 생성됩니다. 이게 Cursor의 Composer — 여러 파일을 동시에 만들어주는 모드입니다.

5단계: 모델 고르기

Cursor는 여러 모델을 지원합니다. 사이드바에서 마음껏 바꿔보세요.

• Claude Sonnet 4.5 — 코딩/추론 모두 우수, 기본 추천
• GPT-5 — 범용적으로 안정적
• Gemini Pro — 대용량 컨텍스트가 필요할 때

자주 하는 실수

“AI가 짠 코드는 무조건 맞다”는 착각입니다.

• 항상 한 번은 읽어보세요. 특히 보안/결제 관련 로직.
• 작은 단위로 지시하세요. “전체 리팩토링” 보다 “이 함수만 테스트 가능하게 분리해줘”가 결과가 좋습니다.
• AI에게 컨텍스트를 주세요. 파일 상단에 주석으로 “이 모듈은 X를 담당한다”고 적어두면 AI가 훨씬 정확하게 답합니다.

정리

• 설치 → 3분
• Ctrl + K 익히기 → 5분
• @Codebase로 코드베이스 탐색 → 10분
• Composer로 새 기능 만들기 → 5분
• 모델 고르기 → 2분

총 25분이면 Cursor의 80%를 쓸 수 있게 됩니다. 나머지 20%는 직접 부딪히며 익혀가는 거예요.