Cursor AI가 뭔가
Cursor는 VS Code를 기반으로 만든 AI 코드 에디터다. 화면 구성은 VS Code와 거의 같고, 여기에 AI와 대화하는 에이전트 패널과 다음 코드를 미리 제안하는 Tab 자동완성이 붙어 있다. «할 일 목록 웹페이지를 만들어 줘»라고 적으면 에이전트가 필요한 파일을 만들고, «이 오류 고쳐 줘»라고 오류 문구를 붙이면 원인을 찾아 고친다.
처음 쓰는 사람이 알아 둘 점은, Cursor가 «말하면 다 되는 도구»가 아니라 시키는 사람이 결과를 확인하는 도구라는 것이다. 에이전트는 파일을 읽고, 코드를 고치고, 필요하면 터미널 명령까지 제안하거나 실행한다. 일을 크게 맡길수록 편하지만, 그만큼 무엇이 바뀌었는지 보는 습관이 중요해진다. 이 글의 뒤쪽 절반을 «잘 시키는 법»과 «받은 코드 확인»에 쓴 이유다.
- 에이전트 패널에서 말로 요청 → 여러 파일을 한 번에 만들고 고침
- Plan 모드로 코드를 쓰기 전에 계획부터 받아 볼 수 있음
- Tab 자동완성으로 다음 코드 제안(Tab 키로 받음)
- 저장소에 규칙 파일을 두면 프로젝트 약속을 매번 읽음
설치와 첫 설정
설치는 일반 프로그램과 같다. Windows, macOS, Linux를 모두 지원한다.
cursor.com에서 내려받기
공식 사이트에서 운영체제에 맞는 설치 파일을 받는다. 비슷한 이름의 다른 사이트가 아닌지 주소부터 확인한다.
설치하고 로그인
설치 파일을 실행하고 안내를 따른 뒤 계정으로 로그인한다. 무료(Free) 요금제로도 에디터와 제한된 AI 사용을 시험해 볼 수 있다.
VS Code 설정 가져오기(선택)
이미 VS Code를 쓰고 있었다면 처음 실행할 때 테마·확장·단축키를 가져올 수 있다. VS Code를 따로 설치할 필요는 없다.
작업 폴더를 열기 전에 Git을 설치해 두면 좋다. 에이전트가 고친 내용을 커밋 단위로 되돌릴 수 있어서, 처음 쓰는 사람이 가장 흔히 겪는 «AI가 파일을 엉망으로 바꿔 버렸다»는 상황에서 바로 원래대로 돌아갈 수 있다.
첫 번째 프로젝트 — 할 일 목록 앱
설치가 끝났으면 작은 것 하나를 끝까지 만들어 보는 것이 가장 빠르다. 예시는 브라우저에서 바로 열리는 할 일 목록 웹페이지다.
1. 빈 폴더 열기
Cursor를 실행하고 File > Open Folder로 새 폴더를 하나 만들어 연다. 에이전트는 열린 폴더 안에서만 파일을 만든다.
2. 에이전트 패널 열기
공식 단축키 문서 기준으로 macOS에서는 Cmd+I 또는 Cmd+L이 옆 패널을 열고 닫는다(Windows·Linux는 Cmd 대신 Ctrl). 단축키가 다르게 잡혀 있으면 화면 오른쪽 위 패널 아이콘을 눌러도 된다.
3. 요청 적기
아래처럼 «무엇을, 어떤 조건으로» 적는다.
할 일 목록(To-Do List) 웹페이지를 index.html 한 파일로 만들어 줘. - 할 일을 추가하고 삭제할 수 있어야 해 - 완료 여부를 체크박스로 표시 - 새로고침해도 목록이 남도록 브라우저 localStorage 에 저장 - 모바일 폭(390px)에서도 깨지지 않게 - 외부 라이브러리는 쓰지 말 것
에이전트가 파일을 만들면 바뀐 내용이 표시되고, 받아들일지 고를 수 있다. 생성된 index.html을 브라우저로 열어 할 일을 추가·삭제·체크하고, 새로고침 뒤에도 남는지 확인한다. 요청에 적은 조건 하나하나를 직접 눌러 보는 것이 «완성 확인»이다.
4. 하나씩 덧붙이기
기본이 돌아가면 기능을 하나씩 더한다. «마감일 칸을 추가해 줘», «완료한 일은 아래로 내려 줘»처럼 한 번에 하나씩 요청하면, 무엇 때문에 깨졌는지 찾기 쉽다.
에이전트에게 잘 시키는 법
결과를 가장 크게 바꾸는 것은 요청의 구체성이다. 몇 가지 원칙만 지켜도 첫 결과가 훨씬 쓸 만해진다.
조건을 적는다
| 막연한 요청 | 조건을 적은 요청 |
|---|---|
| «버튼 만들어 줘» | «파란 배경에 흰 글씨 ‘로그인’ 버튼. 마우스를 올리면 색이 진해지고, 키보드 Tab으로도 눌러지게.» |
| «페이지 고쳐 줘» | «헤더 로고가 폭 768px 이하에서 잘려. 그 폭에서 로고 높이를 32px로 줄여 줘. 다른 파일은 건드리지 말고.» |
큰 일은 Plan 모드로 먼저
공식 문서는 Plan 모드를 «코드를 쓰기 전에 자세한 구현 계획을 만드는 모드»라고 설명한다. 질문을 던지고 코드베이스를 살펴본 뒤 계획을 내놓고, 사람이 그 계획을 고친 다음에 만들게 할 수 있다. 여러 파일에 걸친 일이라면 바로 시키기보다 계획부터 받아 보는 편이 안전하다. 반대로 문서도 «빠른 수정이나 여러 번 해 본 일은 바로 Agent 모드로 가도 된다»고 적는다. 모드는 에이전트 패널의 모드 선택 메뉴나 Shift+Tab으로 바꾼다.
오류는 문구째 붙인다
브라우저 콘솔이나 터미널에 오류가 나면 «안 돼»가 아니라 오류 문구 전체를 붙여 넣는다. 어떤 동작을 했을 때 났는지 한 줄 덧붙이면 원인을 훨씬 빨리 찾는다. 같은 요청을 두세 번 되풀이해도 같은 오류가 나면, 방법을 바꿔 달라고 하거나 Plan 모드로 원인부터 정리하게 한다.
자주 쓰는 기능과 단축키
Cursor 공식 단축키 문서(2026년 10월 29일 확인)는 macOS 키만 적고, Windows·Linux는 키보드 단축키 편집기에서 확인하라고 안내한다. 보통 Cmd 자리가 Ctrl이지만, 내 컴퓨터에서 다르면 Ctrl+Shift+P → «Keyboard Shortcuts»에서 찾아본다.
| 하는 일 | macOS 단축키 | 메모 |
|---|---|---|
| 옆 패널(에이전트) 열고 닫기 | Cmd+I · Cmd+L | 요청을 적는 곳 |
| 모드 메뉴 | Cmd+. | 입력 칸에서 Shift+Tab으로 모드 돌리기 |
| 새 대화 | Cmd+N · Cmd+R | 주제가 바뀌면 새로 여는 편이 낫다 |
| 고른 코드를 에이전트로 | Cmd+K | 예전 인라인 편집 자리 · 지금은 에이전트로 보냄 |
| Tab 제안 받기 | Tab | 한 낱말씩은 Cmd+→ |
@로 파일 붙이기
요청 칸에서 @를 치고 파일 이름을 고르면 그 파일을 에이전트가 함께 읽는다. «@index.html 과 같은 스타일로 contact.html 을 만들어 줘»처럼 본보기 파일을 가리키는 데 쓰면 결과가 일관된다.
규칙 파일 — 매번 같은 말 안 하기
«외부 라이브러리 쓰지 마», «한국어 주석으로», «이 폴더 구조를 지켜»처럼 매번 하는 말은 파일로 적어 두면 에이전트가 알아서 읽는다. Cursor 문서 기준으로 규칙은 두 가지 방식으로 둔다.
.cursor/rules/폴더의.mdc파일 — 확장자가 꼭.mdc여야 하고, 같은 폴더의 일반.md는 무시된다. 항상 적용, 특정 파일에만 적용, 에이전트가 필요할 때 적용, @로 부를 때만 적용 네 가지 방식이 있다.AGENTS.md— 머리말 없는 평범한 마크다운. 저장소 맨 위와 하위 폴더에 둘 수 있고, 겹치면 더 구체적인(안쪽) 지시가 앞선다.
AGENTS.md는 GitHub Copilot 같은 다른 도구도 읽기 때문에, 도구를 섞어 쓸 계획이라면 공통 약속은 여기에 두는 편이 편하다. 프론트엔드 작업에서 규칙 파일과 검증 순서를 어떻게 잡는지는 AI 기반 코드 생성 프론트엔드 활용법에 따로 정리했다.
요금제 (2026년 10월)
Cursor 요금제는 2026년 가을 크게 바뀌었다. 요금 페이지 FAQ에 따르면 구독은 X Subscription을 통해 팔리고, 포함 사용량은 매주 다시 찬다. 2026년 10월 29일 요금 페이지 기준 개인 요금제는 다음과 같다(세금 별도).
| 요금제 | 월 요금(USD) | 요금 페이지에 적힌 것 |
|---|---|---|
| Free | $0 | 제한된 AI 사용 · 제한된 에이전트 요청 |
| Plus | $8 | 공유 사용량(Basic) · Grok 모델만 |
| Premium | $30 | Plus의 4배 사용량 · 최신 Grok 모델 · 클라우드 에이전트 · 외부 모델은 API 정가로 따로 청구 |
| Super | $100 | Plus의 15배 사용량 · 붐비는 시간 우선 사용 |
| Ultra | $200 | Plus의 50배 사용량 · 새 기능·모델 가장 먼저 |
팀 요금제(Teams)는 사용자당 월 $30부터이고, 요금 페이지에는 «가격은 바뀔 수 있다»는 문구가 붙어 있다. 처음 쓰는 사람에게 가장 중요한 차이는 Claude나 GPT 같은 외부 모델을 쓰려면 Premium 이상이 필요하고, 그 사용분은 API 정가로 따로 나간다는 점이다. Plus는 싸지만 쓸 수 있는 모델이 정해져 있다. 무료로 에디터와 기본 흐름을 익힌 뒤, 어떤 모델을 얼마나 쓰는지 보고 고르는 편이 낫다. 옛 Pro 요금제와의 차이, 다른 도구와의 요금 비교는 Devin Desktop 요금·한도 — Cursor 새 요금제와 비교와 AI 코딩 도구 비교 2026 — Claude Code · Codex · Cursor에 정리했다.
AI가 쓴 코드를 받기 전에
입문자가 Cursor에서 가장 빨리 늘어나는 것은 코드량이고, 가장 늦게 늘어나는 것은 그 코드를 읽는 눈이다. 돌아가는 화면을 보면 다 된 것 같지만, 남의 코드를 그대로 올린 것과 다르지 않은 상태일 수 있다. 받기 전에 세 가지만 확인해도 이 간격이 크게 줄어든다.
첫째, 내가 설명할 수 있는지 본다. 파일을 열어 한 줄씩 짚으며 «이건 왜 있나»에 답해 본다. 답이 막히는 줄이 있으면 그 줄을 골라 에이전트에게 다시 물으면 된다. 둘째, 안 넣은 것이 들어왔는지 본다. 부탁하지 않은 라이브러리를 새로 설치했거나, 예제용 API 키가 문자열로 박혀 있는 경우가 흔하다. 셋째, 실패하는 경우를 한 번 만들어 본다. 입력 칸이면 빈 값으로 눌러 보고, 목록 화면이면 데이터가 0건일 때를 본다. AI는 대체로 잘 되는 경로만 채워 두기 때문에, 이 두 가지에서 화면이 깨지는 일이 잦다.
그리고 중요한 파일은 바꾸기 전에 커밋해 둔다. 에이전트가 의도하지 않게 여러 파일을 고쳐도, Git이 있으면 커밋 하나로 되돌릴 수 있다. 이 습관이 붙으면 도구를 바꿔도 그대로 쓸 수 있다. 결국 남는 실력은 코드를 빨리 만드는 능력이 아니라 받은 코드를 판단하는 능력이다.
자주 묻는 것
코딩을 전혀 몰라도 Cursor로 앱을 만들 수 있나요?
할 일 목록 같은 작은 웹페이지는 요청만으로도 만들어 볼 수 있습니다. 다만 결과를 확인하고 고칠 곳을 짚는 일은 사람 몫이라, 만든 파일을 열어 읽어 보고 잘 안 되는 경우를 직접 눌러 보는 습관이 필요합니다.
Cursor 무료 요금제로 어디까지 쓸 수 있나요?
2026년 10월 29일 요금 페이지 기준 Free는 제한된 AI 사용과 제한된 에이전트 요청이 들어 있습니다. 에디터 자체와 기본 흐름을 익히는 데는 충분하고, 사용량이 모자라면 유료 요금제를 고르면 됩니다.
Cursor에서 Claude나 GPT를 쓰려면 어떤 요금제가 필요한가요?
요금 페이지 기준으로 외부 모델은 Premium(월 30달러)부터 쓸 수 있고, 그 사용분은 API 정가로 따로 청구됩니다. Plus(월 8달러)는 Grok 모델만 쓸 수 있습니다.
Ctrl+K를 눌렀는데 예전처럼 인라인 편집이 안 열립니다.
공식 문서에 따르면 Cmd/Ctrl+K는 예전에 인라인 편집을 열었지만, 지금은 고른 코드를 에이전트로 보내는 흐름으로 바뀌었습니다. 코드를 고른 뒤 Ctrl+K로 보내고 에이전트 패널에서 요청을 적으면 됩니다.
정리
Cursor AI 코딩의 시작은 설치보다 «작은 것 하나를 끝까지»다. 빈 폴더를 열고, 조건을 적어 요청하고, 결과를 직접 눌러 확인하고, 하나씩 덧붙인다. 큰 일은 Plan 모드로 계획부터 받고, 매번 하는 말은 규칙 파일에 적어 둔다. 요금제는 2026년 10월 크게 바뀌어 외부 모델을 쓰려면 Premium 이상이 필요하니, 무료로 흐름을 익힌 뒤 쓰는 모델과 양을 보고 고르면 된다.
참고 자료
- Cursor. Pricing — Free·Plus $8·Premium $30·Super $100·Ultra $200·Teams $30+, 사용량 매주 다시 참, X Subscription, 외부 모델 API 정가 별도(2026-10-29 확인). cursor.com
- Cursor Docs. Keyboard shortcuts — 옆 패널 Cmd I·Cmd L, 모드 메뉴 Cmd ., Shift Tab 모드 돌리기, 새 대화, Tab 받기(2026-10-29 확인). cursor.com
- Cursor Docs. Inline Edit — Cmd/Ctrl+K가 예전 인라인 편집에서 고른 코드를 에이전트로 보내는 흐름으로 바뀜(2026-10-29 확인). cursor.com
- Cursor Docs. Modes — Plan 모드 설명, 빠른 수정은 Agent 모드, 모드 선택과 Shift+Tab(2026-10-29 확인). cursor.com
- Cursor Docs. Rules — .cursor/rules 의 .mdc, 적용 방식 네 가지, AGENTS.md(2026-10-29 확인). cursor.com