AI

Cursor IDE AI 핵심 기능, 입문자를 위한 필수 활용 가이드

ilboard 2026. 6. 8. 21:28

Cursor IDE AI 핵심 기능 정리 — 입문자가 처음 써야 할 것들

30대 개발자가 집 작업실에서 모니터 화면을 가까이 들여다보며 처음 설치한 Cursor IDE를 탐색하는 장면. 어두운 다크 테마 에디터 화면이 모니터에 꽉 차 있고, 인물은 약간 긴장하면서도 흥미로운 표정을 짓고 있다. 조용하고 집중된 분위기, 야간 작업 환경. Cursor IDE를 처음 접하는 입문자의 탐색 과정을 보조하는 이미지.

처음 써봤을 때 "그냥 VS Code에 채팅창 붙인 거 아니야?"라고 생각했다. 그런데 하루 쓰다 보니 생각이 조금 달라졌다. 자동완성 품질이 GitHub Copilot보다 나은 케이스가 분명히 있었고, 특히 여러 파일에 걸친 수정 작업에서 차이가 느껴졌다. 물론 단순히 코드 몇 줄 완성하는 용도로만 쓴다면 굳이 환경을 바꿀 이유는 없다. 하지만 "이 기능 추가해줘" 한 줄로 관련 파일 여러 개를 한꺼번에 수정해주는 걸 보면, 이건 그냥 자동완성 도구가 아니라는 걸 알게 된다.

이 글은 Cursor를 처음 쓰기 시작한 사람을 위해 실제로 자주 쓰는 기능 위주로 정리했다. 설치부터 Agent Mode까지, 처음에 뭘 써야 할지 막막한 분들에게 실용적인 흐름이 됐으면 한다.


Cursor가 뭔지 한 줄로 설명하면

Cursor는 VS Code(Visual Studio Code, 마이크로소프트가 만든 무료 코드 편집기)를 기반으로 만든 AI 통합 개발 환경이다. VS Code를 뼈대로 쓰기 때문에 기존에 쓰던 테마, 확장 프로그램, 단축키 설정을 그대로 가져올 수 있다. 설치하고 "VS Code 설정 가져오기"를 누르면 거의 동일한 환경에서 바로 시작된다.

차이는 AI가 에디터 안에 직접 박혀 있다는 점이다. GitHub Copilot은 VS Code에 설치하는 확장 프로그램 형태인데 비해, Cursor는 에디터 자체가 AI를 중심으로 설계됐다. 자동완성, 인라인 편집, 채팅, 에이전트 모드가 모두 에디터와 하나로 연결돼 있다.

2026년 5월 기준으로 Cursor 3.5 버전이 출시된 상태다. 이번 버전에서는 Cloud Agents(클라우드 에이전트, 내 컴퓨터가 아닌 Cursor 서버에서 AI가 직접 코드를 실행하는 기능)가 추가됐다. 입문자 단계에서 당장 쓸 기능은 아니지만, 이 방향성을 보면 Cursor가 단순 자동완성 도구를 넘어서고 있다는 걸 알 수 있다.


요금제 구조 — 무료로 얼마나 쓸 수 있나

Cursor를 처음 설치하면 Hobby 플랜(무료)으로 시작된다. 무료 플랜에서 쓸 수 있는 것들은 다음과 같다.

  • Tab 자동완성: 월 2,000회
  • 프리미엄 모델(Claude, GPT-4o 등) slow 요청: 월 50회
  • 무료 모델 채팅: 제한 없음

솔직히 말하면 무료 플랜으로는 제대로 쓰기 어렵다. Tab 자동완성 2,000회는 코드를 조금만 써도 금세 소진된다. 느린(slow) 프리미엄 모델 50회 제한도 며칠이면 닿는다. 본격적으로 써볼 생각이라면 Pro 플랜($20/월, 연간 결제 시 $16/월)으로 시작하는 게 현실적이다.

Pro 플랜에서는 Tab 자동완성이 무제한이고, Claude 3.5 Sonnet, GPT-4o 같은 프리미엄 모델 fast 요청이 월 500회 주어진다. 그 이상을 쓰면 느린 대기열로 전환된다. 더 많이 쓰는 사람을 위한 Pro+($60/월), Ultra($200/월) 플랜도 있는데, 일반 개인 사용자 기준으로는 Pro 플랜이 사실상 표준이다.

팀이나 회사에서 쓴다면 Business 플랜($40/인당/월)이 있고, SSO(단일 로그인), 제로 데이터 보유 모드, 관리자 설정이 포함된다.


Tab 자동완성 — 가장 자주 쓰게 되는 기능

Cursor를 쓰면서 하루에 가장 많이 쓰게 되는 건 Tab 자동완성이다. 코드를 입력하기 시작하면 AI가 다음에 올 코드를 회색 글씨로 제안한다. Tab 키를 누르면 수락, 그냥 계속 타이핑하면 무시된다.

단순히 함수 이름이나 괄호를 채워주는 수준이 아니라, 여러 줄짜리 코드 블록을 통째로 제안하는 경우가 많다. 예를 들어 def get_user_by_email( 까지 입력했을 때 파라미터, 쿼리 로직, 리턴 구문까지 이어서 제안해준다. 같은 파일 안에서 비슷한 패턴이 반복되는 코드라면 정확도가 높다.

# 예시: 이 정도까지 입력하면
def get_user_by_email(

# Cursor가 이렇게 제안한다
def get_user_by_email(email: str) -> Optional[User]:
    return db.query(User).filter(User.email == email).first()

GitHub Copilot과 비교하면 체감 수락률이 Cursor 쪽이 높은 편이었다. 특히 현재 작업 중인 파일의 코드 패턴을 더 잘 파악하는 느낌이 있다. 다만 이건 개인 차이가 있고, Copilot을 오래 쓴 사람은 Copilot이 더 자연스럽게 느껴질 수도 있다.

처음에 헷갈리는 게 하나 있다. Tab으로 제안 수락, Ctrl+→로 단어 단위 부분 수락, Escape로 제안 닫기인데, 이 세 가지만 손에 익히면 자동완성 흐름이 확실히 빨라진다.


Cmd+K (Ctrl+K) — 선택한 코드를 바로 수정하는 기능

Tab 자동완성 다음으로 자주 쓰게 되는 게 Cmd+K (윈도우는 Ctrl+K)다. 코드 일부를 드래그로 선택하고 이 단축키를 누르면 작은 입력창이 뜬다. 거기에 자연어로 수정 내용을 적으면 된다.

# 이렇게 쓰면
이 함수에서 None 체크 추가하고, 타입 힌트 붙여줘

# Cursor가 diff 형태로 제안해준다
# 초록색 = 추가, 빨간색 = 삭제
# Cmd+Enter로 수락, Cmd+Backspace로 거절

실제로 쓰다 보면 "이 반복문 list comprehension으로 바꿔줘", "에러 메시지 더 명확하게 수정해줘", "주석 영어로 번역해줘" 같은 짧은 요청에 유용하다. 파일 전체를 건드리는 게 아니라 선택한 부분만 수정하기 때문에 통제 범위가 명확하다.

코드를 선택하지 않고 Cmd+K를 누르면 새 코드를 생성하는 용도로도 쓸 수 있다. "Fastapi로 간단한 health check 엔드포인트 작성해줘" 같은 식으로 입력하면 커서 위치에 코드를 추가해준다.

이 기능의 좋은 점은 제안을 수락하기 전에 diff를 먼저 보여준다는 것이다. 마음에 들지 않으면 거절하면 그만이고, 수락 후에도 Cmd+Z로 되돌릴 수 있다. 처음에는 이게 얼마나 중요한지 모르는데, AI 제안이 예상과 다른 방향으로 올 때 diff 확인 없이 바로 적용하면 생각보다 많이 당황하게 된다.


Chat 기능 — 코드를 컨텍스트로 삼은 AI 대화

Cmd+L (윈도우 Ctrl+L)을 누르면 오른쪽에 채팅 패널이 열린다. ChatGPT나 Claude에 질문하는 것과 비슷한데, 차이는 현재 열려 있는 파일이나 선택한 코드가 자동으로 컨텍스트로 들어간다는 점이다.

예를 들어 에러 메시지가 터미널에 떴을 때, 해당 파일을 열고 채팅창에 에러 메시지를 붙여넣으면 파일 전체 구조를 참고해서 원인을 설명해준다. 별도의 브라우저 탭을 열고 ChatGPT에 복붙하는 방식보다 확실히 빠르다.

채팅에서 @ 기호를 입력하면 참고할 컨텍스트를 직접 지정할 수 있다.

  • @파일명 — 특정 파일 내용을 참고
  • @폴더명 — 폴더 전체 구조를 참고
  • @web — 웹 검색 결과를 포함해서 답변
  • @Docs — 등록한 외부 문서 참고 (예: 라이브러리 공식 문서)

@ 컨텍스트 지정이 실제로 답변 품질을 많이 올려준다. @ 없이 그냥 물어보면 Cursor가 알아서 컨텍스트를 추론하는데, 직접 지정해줬을 때보다 답변이 엉뚱한 방향으로 가는 경우가 있다. 처음에는 그냥 쓰다가 나중에 @를 쓰기 시작하면 체감 차이가 난다.

채팅 패널에서 응답이 오면 코드 블록 우측 상단에 "Apply" 버튼이 있다. 이걸 누르면 해당 코드가 파일에 직접 반영된다. 반영 후에는 diff가 표시되고 Accept/Reject 선택이 가능하다.


Agent Mode — 여러 파일을 알아서 수정하는 방식

30대 개발자가 와이드 모니터 앞에 앉아 Cursor AI의 Agent 모드가 여러 파일을 자동으로 수정하는 화면을 바라보는 장면. 화면에는 여러 개의 파일 탭이 열려 있고 AI가 순서대로 코드를 수정하는 과정이 보인다. 개발자는 팔짱을 끼고 화면을 지켜보는 편안한 자세. AI가 자율적으로 작업하는 과정을 설명하는 본문 중간에 배치할 이미지.

Agent Mode는 "이 기능 만들어줘"처럼 큰 단위의 작업을 AI에게 맡길 때 쓴다. 기존 Chat이나 Cmd+K는 특정 파일, 특정 코드 선택 기준으로 동작하는 반면, Agent Mode는 관련 파일을 알아서 찾아가며 수정하고, 필요하면 새 파일도 만들고, 터미널 명령도 실행한다.

실제로 쓰이는 방식을 예시로 들면 이렇다.

"현재 FastAPI 프로젝트에 사용자 인증 기능 추가해줘. JWT 토큰 기반으로, 로그인/회원가입 엔드포인트 포함해서."

이 요청 하나를 Agent Mode에 넣으면 관련 파일들을 확인하고, 라우터 파일 수정, 유틸 함수 추가, 패키지 설치 명령 실행까지 순서대로 진행한다. 중간중간 어떤 작업을 하는지 채팅창에 설명이 나온다.

처음 쓸 때 한 가지 주의할 게 있다. Agent Mode가 작업한 결과를 무작정 수락하지 말고 반드시 diff를 확인해야 한다. 예상한 것과 다른 방식으로 구현한 경우가 있고, 특히 기존 코드 패턴을 무시하고 새로운 방식으로 짜는 경우도 있다. "작성해줘" 한 줄에 모든 걸 맡기기보다, 요청을 작게 나눠서 단계별로 확인하는 게 실무에서 더 편했다.

Cursor 3.0부터는 Background Agents(백그라운드 에이전트, 내가 다른 작업을 하는 동안 AI가 별도로 작업하는 기능)와 병렬 에이전트(최대 8개 동시 실행)가 추가됐다. 입문자보다는 중급 이상 사용자가 체감할 기능인데, 큰 리팩토링이나 복수의 독립적인 기능 추가 작업에서 시간을 많이 절약해준다.


Cursor vs GitHub Copilot — 뭘 써야 할까

가장 자주 받는 질문이 "Copilot 쓰는데 Cursor로 넘어가야 하나요?"다. 상황에 따라 다르다고 생각한다.

Cursor가 더 나은 상황:

코드베이스가 어느 정도 커진 프로젝트. Cursor는 프로젝트 전체를 인덱싱해서 파일 간 관계를 파악한다. 여러 파일에 걸친 수정이나 기능 추가 작업에서 Copilot보다 더 맥락에 맞는 제안을 한다.

여러 AI 모델을 상황에 따라 바꿔 쓰고 싶을 때. Cursor는 Claude, GPT-4o, Gemini 등 모델을 선택해서 쓸 수 있다. Copilot은 기본적으로 GitHub 측에서 제공하는 모델 중에서만 선택 가능하다.

Copilot이 더 나은 상황:

비용이 중요하다면. Copilot은 월 $10, Cursor Pro는 월 $20이다. 자동완성 중심으로만 쓴다면 Copilot이 가성비가 낫다.

팀이 다양한 IDE를 쓴다면. Copilot은 VS Code 외에 JetBrains, Neovim, Xcode 등 다양한 환경에서 지원된다. Cursor는 기본적으로 Cursor IDE 자체에서만 동작한다.

기존에 VS Code + Copilot으로 불편함 없이 잘 쓰고 있었다면, 당장 갈아탈 필요는 없다. 복잡한 멀티 파일 수정이 잦거나 Agent Mode 같은 자율 작업 기능이 필요하다면 그때 넘어오는 게 맞다.


실전 팁 — 처음 쓸 때 알면 좋은 것들

1. VS Code 설정 먼저 가져와라
설치 직후 "VS Code에서 설정 가져오기" 옵션이 뜬다. 이걸 누르면 기존 VS Code의 확장 프로그램, 테마, 단축키가 그대로 복사된다. 환경 낯섦 없이 바로 시작할 수 있다.

2. 단축키 세 개만 먼저 익혀라
Tab(자동완성 수락), Cmd+K(인라인 편집), Cmd+L(채팅 열기). 이 세 개가 손에 익으면 나머지는 자연스럽게 따라온다.

3. Chat에서 @ 적극적으로 써라
관련 파일이 있을 때는 @파일명을 명시하는 습관을 들이면 답변 품질이 눈에 띄게 올라간다. 특히 여러 파일이 연관된 에러를 분석할 때 효과적이다.

4. Agent Mode는 작은 단위로 요청해라
"전체 기능 다 만들어줘" 대신 "로그인 엔드포인트 먼저 만들어줘"처럼 나눠서 요청하는 게 결과물을 관리하기 편하다. 범위가 클수록 AI가 예상 밖의 방향으로 가는 경우가 많아진다.

5. .cursorrules 파일 만들어두면 훨씬 편하다
프로젝트 루트에 .cursorrules 파일을 만들고 "이 프로젝트의 코딩 컨벤션, 사용 기술 스택, 주의사항"을 적어두면 AI가 이 규칙을 참고해서 더 일관된 코드를 제안한다. 초반에 몇 분 투자할 만한 설정이다.

# .cursorrules 예시
- Python 3.11 사용
- 타입 힌트 필수
- SQLAlchemy ORM 사용, raw SQL 금지
- 함수 단위로 docstring 작성

6. 무료 플랜은 '체험용'으로만 생각해라
Tab 자동완성 2,000회는 하루 이틀이면 소진된다. 무료 플랜으로 오래 쓰려고 하면 기능 제한에 자꾸 걸려서 오히려 경험이 나빠진다. 14일 Pro 무료 체험을 먼저 충분히 써보고 계속 쓸지 판단하는 게 낫다.


이런 사람한테 맞고, 이런 사람한테는 안 맞는다

Cursor는 이런 상황에서 확실히 편하다. 여러 파일이 연결된 프로젝트를 혼자 관리하는 1인 개발자, 코딩 입문 단계에서 코드 작성 흐름 자체를 빠르게 익히고 싶은 사람, 반복적인 보일러플레이트 코드(비슷한 구조가 반복되는 기본 코드)를 자주 작성하는 환경에 있는 개발자.

반면 이런 경우라면 굳이 지금 바꿀 필요는 없다. 기존 VS Code + Copilot 환경에 이미 만족하고 있고 월 $20 추가 지출이 부담스러울 때. 팀 전체가 JetBrains 계열 IDE를 쓰는 환경이라면 Cursor는 현실적인 선택지가 아니다.

Cursor 3.5 기준으로 자동완성 품질과 멀티 파일 컨텍스트 이해는 현재 AI 코딩 도구 중에서 상위권이다. 하지만 그 가치를 체감하려면 어느 정도 코드베이스가 있는 프로젝트에서 써봐야 한다. 파일 하나짜리 스크립트 작성에서는 솔직히 차이가 크지 않다. 먼저 무료 플랜이나 Pro 14일 체험으로 직접 써보고, 본인 작업 방식에 맞는지 판단하는 것이 가장 좋은 방법이다.


Sources:
- Cursor - 나무위키
- Cursor 새 소식 — 최신 업데이트 및 릴리스 노트
- Cursor AI 2026: The Complete Guide to the AI-Native IDE - DEV Community
- Cursor 3.5 IDE Guide: Cloud Agents, Composer 2.5, Pricing (2026)
- Cursor AI Pricing Plans (2026): Free, Pro & Business Explained
- Cursor Pricing 2026: $0 Hobby, $20 Pro, $60 Pro+, $200 Ultra
- GitHub Copilot vs Cursor: AI Code Editor Review for 2026 | DigitalOcean
- Cursor vs Claude Code vs GitHub Copilot 2026: The Ultimate Comparison
- Cursor 2026: Composer, Agent Mode, MCP & Background Agent | DeployHQ
- 커서 에이전트 모드 사용 방법
- 21 커서(Cursor) AI 코드 편집기 사용방법 - 바이브 코딩