Cursor AI 에디터 가이드

기준일: 2026-10-29
공식 기준: Cursor Pricing, Cursor Docs, Cursor Help

Cursor란 무엇인가

Cursor는 Anysphere가 만든 AI 코드 편집기입니다. VS Code를 기반으로 만들어져 VS Code와 기본 단축키가 같고, 쓰던 설정·확장 프로그램·테마를 가져와 그대로 쓸 수 있습니다.

Claude Code가 터미널에서 일하는 에이전트라면, Cursor는 편집기 안에서 AI와 주고받는 방식을 택한 도구입니다. 자동완성(Tab)부터 여러 파일을 고치는 Agent까지 편집기 하나에 들어 있습니다.

Cursor 설치 방법

1. cursor.com/download에서 운영체제에 맞는 파일을 받습니다. macOS, Windows, Linux를 지원합니다.
2. macOS는 Applications 폴더로 끌어 옮기고, Windows는 설치 프로그램을 실행합니다. Linux는 패키지 매니저(apt, dnf)나 AppImage로 설치합니다.
3. 실행한 뒤 Cursor 계정으로 로그인합니다. 계정은 cursor.com에서 무료로 만들 수 있습니다.

VS Code 설정 가져오기

1. Cursor Settings를 엽니다(macOS Cmd+Shift+J, Windows/Linux Ctrl+Shift+J).
2. General > Account로 갑니다.
3. VS Code Import의 Import 버튼을 누릅니다.

확장 프로그램, 테마, 설정, 키바인딩이 넘어옵니다. 단, Cursor는 VS Code Marketplace가 아니라 Open VSX 레지스트리를 쓰기 때문에 일부 확장은 없거나 다르게 동작할 수 있습니다.

핵심 기능 살펴보기

Tab 자동완성

입력하는 동안 최근 편집, 주변 코드, 린터 오류를 바탕으로 다음 코드를 회색 글씨로 제안합니다.

• Tab: 제안 전체 수락
• Esc 또는 계속 입력: 거절
• Cmd+→(Windows/Linux Ctrl+→): 단어 단위로 수락

한 줄짜리 완성에 그치지 않고 여러 줄을 고치거나 빠진 import를 추가하기도 합니다. 제안을 수락한 뒤 Tab을 한 번 더 누르면 다음에 고칠 위치로 커서가 이동합니다(jump-in-file). 한 파일의 변경 때문에 다른 파일도 바뀌어야 하면 파일을 넘나드는 수정도 제안합니다.

오른쪽 아래 Tab 상태 표시를 눌러 잠시 끄거나, 특정 확장자(마크다운, JSON 등)에서만 끌 수 있습니다.

Agent (Cmd+I)

Agent는 파일을 읽고 고치고, 터미널 명령을 실행하며 작업을 끝까지 진행하는 어시스턴트입니다. Cmd+I(Windows/Linux Ctrl+I)로 사이드 패널을 엽니다.

"새 API 엔드포인트를 추가하고 테스트도 작성해줘"처럼 여러 파일을 손대야 하는 작업을 맡기면, 코드베이스를 검색해 관련 파일을 찾고 수정안을 적용합니다. 입력창에서 Shift+Tab을 누르면 Agent 모드를 돌아가며 바꿀 수 있습니다.

Agent는 큰 변경 전에 체크포인트를 자동으로 남깁니다. 방향이 틀렸다면 채팅 타임라인의 체크포인트를 눌러 그 시점으로 파일을 되돌릴 수 있습니다. 체크포인트는 로컬에만 저장되고 Git과는 별개이므로, 오래 남길 변경은 Git으로 커밋해 두세요.

Plan 모드

복잡한 기능은 코드를 쓰기 전에 계획부터 받아 보는 편이 안전합니다. Agent 패널에서 Shift+Tab으로 Plan 모드를 고르고 요청을 입력하면, Agent가 코드베이스를 살펴보고 필요하면 질문한 뒤 계획을 만듭니다. 계획은 편집 가능한 파일로 열리고, 확인 후 Build를 누르면 구현을 시작합니다.

@ 멘션으로 컨텍스트 지정

채팅 입력창에 @를 입력하면 대화에 붙일 컨텍스트를 고를 수 있습니다.

• 파일·폴더: @auth.ts, @src/components/
• 터미널 출력: @Terminals
• 이전 대화: @Chats
• Git 변경분: @Commit (Diff of Working State), @Branch (Diff with Main)
• 내장 브라우저: @Browser

어떤 파일이 관련 있는지 알 때만 쓰면 됩니다. 모르겠으면 생략해도 Agent가 직접 검색해 찾습니다.

Cursor의 가격 정책

2026-10-29 기준 가격 페이지의 요금제입니다. 가격은 바뀔 수 있고 세금은 별도입니다.

요금제	월 요금	내용
Free	$0	제한된 AI 사용량(Agent·Chat 요청 제한)
Plus	$8	Cursor 자체 모델(Grok 4.7·4.6·4.5, Composer 2.5) 사용량 풀. 서드파티 모델·Cloud Agents 없음
Premium	$30	Plus의 4배 사용량, 서드파티 모델(Claude·GPT·Gemini)을 API 정가로 사용, Cloud Agents·Automations
Super	$100	Premium 기능 + Plus의 15배 사용량, 사용량이 몰리는 시간대 우선 모델 접근
Ultra	$200	Super 기능 + Plus의 50배 사용량, 신제품·신모델 우선 제공
Teams	사용자당 $30부터	좌석마다 Premium·Super·Ultra 중 선택(Plus 좌석 없음), 중앙 결제·관리, 사용량 분석
Enterprise	별도 문의	사용량 풀, 인보이스 결제, SCIM, 감사 로그

사용량 풀은 주 단위로 다시 채워지고 Cursor 자체 모델(Grok, Composer)에만 쓰입니다. Claude·GPT·Gemini 같은 서드파티 모델은 풀에 들어가지 않고, Premium 이상에서 첫 요청부터 API 정가로 선불 크레딧에서 빠집니다. Teams·Enterprise는 여기에 Cursor Token Rate(백만 토큰당 $0.25)가 더 붙습니다. Pro·Pro+ 같은 옛 요금제를 쓰고 있다면 기존 조건 그대로 유지됩니다(Models & Pricing).

Privacy Mode를 켜면 코드가 Cursor나 모델 제공사의 학습에 쓰이지 않습니다. Cursor Settings에서 켤 수 있고, Teams·Enterprise에서는 관리자가 조직 전체에 강제할 수 있습니다.

실제 사용 예시

버그 수정: 에러 메시지를 Agent에 붙여 넣고 고쳐 달라고 하면, 관련 파일을 찾아 원인을 분석하고 수정안을 적용합니다.

리팩토링: 대상 파일이나 폴더를 @로 지정하고 "이 컴포넌트를 React Query를 쓰도록 바꿔줘"라고 요청합니다. 영향 범위가 크면 Plan 모드로 계획부터 확인하세요.

코드 이해: 처음 보는 프로젝트에서 "이 프로젝트의 인증 흐름을 설명해줘"라고 물으면 관련 파일을 찾아 흐름을 정리해 줍니다. 오래 손대지 않은 내 코드로 돌아올 때도 쓸모 있습니다.

테스트 작성: 함수나 컴포넌트 파일을 @로 붙이고 "이 파일의 단위 테스트를 작성해줘"라고 요청합니다.

Claude Code와의 비교

Cursor는 편집기 UI 안에서 AI를 쓰고, Claude Code는 터미널에서 에이전트 방식으로 일합니다. 둘은 경쟁 관계라기보다 함께 쓰는 경우가 많습니다.

편집 중 빠른 자동완성과 수정은 Cursor로, 긴 자율 작업이나 CI/CD 연동은 Claude Code로 나누는 조합이 흔합니다. Claude Code 사용법은 Claude Code 가이드에서 볼 수 있습니다.

마치며

Cursor는 VS Code를 쓰던 개발자에게 진입 장벽이 낮은 AI 코딩 도구입니다. 설정을 가져오면 기존 환경을 거의 그대로 쓸 수 있습니다. Free 요금제로 Tab과 Agent를 먼저 써 보고, 사용량이 모자라면 상위 요금제를 고르세요.

AI에게 구현을 맡기는 작업 방식 자체가 궁금하다면 바이브 코딩 가이드를 이어서 읽어 보세요. JSON 데이터를 다룰 때는 JSON 포맷터를, 코드 변경을 비교할 때는 Diff Viewer를 함께 쓰면 편합니다.