Cursor 사용법 2026: 15분 만에 배우는 Agent 입문 가이드

이 튜토리얼은 Cursor를 처음 여는 분을 위한 커서 사용법을 설명합니다. 현재 릴리스가 Cursor IDE 3.27이었던 2026년 11월 1일 기준 공식 문서를 따릅니다.

작성 방법을 밝혀 둡니다. NxCode 팀은 이 문서들을 바탕으로 이 가이드를 썼으며, 새로 설치한 환경에서 단계를 직접 실행하지 않았습니다. NxCode는 저희 제품인 AI 앱 빌더이며 Cursor와는 별개입니다. 가이드에서 무엇이 보여야 한다고 말하는 내용은 문서에서 나온 것이므로, 실제 화면은 조금 다를 수 있습니다. 공식 페이지끼리 내용이 다르거나 빠진 부분이 있으면 그렇게 밝힙니다.

예전 Cursor 튜토리얼을 읽은 적이 있다면 조금 놀랄 수 있습니다. Composer 모드, Cmd+K Inline Edit, 별도의 Chat 모드는 모두 현재 문서에서 사라졌습니다.

15분 학습 경로

시간(분)	할 일	얻는 것
0–3	설치, 로그인, 연습 폴더 열기	내 컴퓨터에서 실행되는 Cursor
3–5	두 창과 몇 가지 단축키 익히기	Agent가 어디 있는지 파악
5–10	Ask, 이어서 Agent로 첫 작업 실행	Agent가 개선한 작은 페이지
10–12	변경 사항 검토 및 테스트	Agent가 실제로 한 일을 파악
12–14	체크포인트 복원 연습	되돌리는 방법을 습득
14–15	프로젝트 규칙 하나 추가	내 선호를 따르는 Agent

Cursor란 무엇인가?

Cursor는 AI 에이전트가 내장된 코드 에디터입니다. 평범한 말로 작업을 설명하면 Agent가 프로젝트를 읽고, 파일을 편집하고, 명령을 실행할 수 있습니다.

VS Code를 써 봤다면 에디터가 익숙할 것입니다. 일반 편집 단축키는 같고, 확장, 테마, 설정, 키 바인딩도 가져올 수 있습니다.

평소 Cursor 안에서는 세 가지가 일어납니다.

Agent는 프로젝트 전반의 작업을 맡습니다.
Tab은 직접 코드를 쓰는 동안 다음에 입력할 내용을 예측합니다.
Rules는 Agent에게 프로젝트를 어떻게 다뤄야 하는지 알려 줍니다.

Cursor는 코드를 다루고 싶거나 배우고 싶은 사람에게 맞습니다. 완성된 앱만 원하고 diff를 읽을 생각이 없는 사람은 해야 할 일이 다르며, 아래 "다른 도구를 써야 할 때"에서 다룹니다. NxCode는 그 경우의 선택지 중 하나입니다.

Cursor 설치와 첫 실행

1단계: 다운로드

cursor.com/download로 이동해 운영체제를 선택합니다.

시스템	요구 사항	다운로드할 파일
macOS	12 이상	`.dmg`, Apple Silicon 또는 Intel용
Windows	10 이상	`.exe`, x64 또는 ARM64, 각각 System 및 User 설치 프로그램
Linux	Debian/Ubuntu 또는 RHEL/Fedora	apt 또는 yum 저장소 우선, AppImage도 제공

Linux에서 공식 빠른 시작 문서는 apt와 yum 저장소를 권장합니다. 데스크톱 아이콘, 자동 업데이트, 명령줄 도구가 함께 추가되기 때문입니다.

2단계: Cursor를 열고 로그인

공식 순서는 간단합니다. 다운로드, 열기, 로그인, 폴더 선택, 작은 작업으로 시작하기입니다. 계정이 필요합니다.

Cursor 로그인은 Grok 또는 xAI 브랜드가 붙은 공유 xAI 페이지로 이동할 수 있습니다. 신규 고객은 이제 Cursor가 판매되는 구독인 The X Subscription으로 시작하므로 이는 정상입니다. 로그인해도 계정이 병합되거나 플랜이 바뀌지는 않습니다.

오래된 가이드는 첫 실행 단계로 "AI 모델 선택"을 나열합니다. 현재 문서에는 그런 단계가 없습니다. 기본값은 나중에 Cursor Settings > Models에서 정하거나 대화 중에 바꿀 수 있습니다.

문서에는 새 사용자가 Agents Window와 에디터 중 어디로 먼저 들어가는지도 나와 있지 않습니다. 다음 섹션에서 둘 사이를 오가는 법을 설명하므로 어느 쪽으로 시작해도 괜찮습니다.

3단계: 플랜 선택

Free($0, 제한적 사용량)로 시작하고, 한도가 작업을 방해하면 Plus(월 $8)로 옮기고, Cloud Agents, 서드파티 모델, 자체 API 키가 필요할 때만 Premium(월 $30)을 고르세요.

가격은 세전입니다. 그 위 플랜은 Super($100)와 Ultra($200)입니다. 자세한 내용은 Cursor 요금제 가이드나 공식 요금 페이지를 참고하세요. 요금 페이지에 Cursor는 "not authorize any resellers or third-party sellers"(리셀러나 제3자 판매자를 승인하지 않는다)고 나와 있으므로, 공식 사이트나 인앱 결제로만 구매하세요.

4단계: 선택 사항, VS Code 설정 가져오기

VS Code 설정 가져오기는 더 이상 첫 실행 단계로 설명되지 않습니다. 원한다면 Cmd+Shift+J(Windows와 Linux는 Ctrl+Shift+J)를 눌러 Cursor Settings를 열고 General > Account > VS Code Import > Import로 이동하세요.

Cursor의 확장은 VS Code Marketplace가 아니라 Open VSX에서 제공되며, 모든 확장이 있는 것은 아닙니다. 가져온 뒤 확장이 빠져 있다면 이것이 유력한 이유입니다.

무엇이든 설치하기 전에 게시자를 확인하세요. 2026년 10월 29일에 Cursor는 마켓플레이스에서 Anthropic.claude-code(버전 2.1.312 및 2.1.313)로 위장한 악성 확장을 경고했습니다.

인터페이스 익히기

두 개의 창: Agents Window와 에디터

Cursor에는 주요 인터페이스가 두 개 있고, 문서는 둘 다 계속 지원된다고 합니다. 동시에 열어 둘 수 있습니다.

	Agents Window	에디터(IDE)
중심	에이전트	내 파일
적합한 작업	여러 저장소, 병렬 에이전트, 로컬·클라우드·SSH 작업	Agent 옆에서 코드 읽고 편집하기
여는 방법	Cmd+Shift+P 후 Open Agents Window	Cmd+Shift+P 후 Open IDE

Windows와 Linux에서 명령 팔레트는 Ctrl+Shift+P입니다.

여러 워크스페이스, 새 diff 보기, 병렬 클라우드 에이전트, 네이티브 Worktrees 인터페이스 등 일부 기능은 Agents Window에만 있습니다.

첫날에는 에디터를 쓰세요. 파일과 대화를 나란히 볼 수 있어 Agent가 하는 일을 따라가기 쉽습니다.

Agent 패널

에디터에서 Cmd+I(Ctrl+I)를 누르면 측면 패널이 열립니다. 문서는 이를 "Agent panel"이라 부르고 단축키 표는 "Sidepanel"이라 부릅니다. 같은 것입니다.

패널 안에서 쓰게 될 것은 다음과 같습니다.

입력창: 요청을 입력합니다. 이미지를 끌어다 놓거나 붙여 넣을 수 있고, 마이크로 음성 입력도 할 수 있습니다.
모드 드롭다운: Agent, Ask, Plan, Debug 사이를 전환합니다.
모델 선택기: 입력창 상단에 있습니다.
@: 특정 대상을 가리키고, /: 스킬과 명령을 호출합니다.

현재 공식 @ 목록은 짧습니다. @index.html이나 @src/components/ 같은 파일 또는 폴더, @Terminals, @Chats, @Commit (Diff of Working State), @Branch (Diff with Main), @Browser입니다. 어떤 파일이 중요한지 모르겠다면 @를 건너뛰세요. 문서에 따르면 Agent는 자체 검색으로 관련 파일을 찾습니다.

예전 튜토리얼은 @codebase, @docs, @web을 가르칩니다. 이들은 현재 목록에 없으며, 아직 작동하는지는 확인할 수 없었습니다.

사이드바에는 플러그인, 스킬, MCP, 서브에이전트, 규칙, 명령, 훅을 한곳에 모은 Customize 페이지도 있습니다. 나중에 쓰게 됩니다.

알아 둘 용어: 이름의 현재 의미

Cursor의 이름 중 많은 것이 바뀌었습니다. 이 표는 각각이 지금 무엇을 뜻하는지 보여 줍니다.

용어	현재 의미	오래된 튜토리얼의 표현
Composer	빠르고 비용 효율적이라고 설명되는 Cursor 자체 모델, 현재 Composer 2.5	"Composer mode": 문서에서 사라짐, Agent 사용
Agent	기본 모드이자 주된 작업 방식	"Switch to Agent in Composer": 전환 불필요
Chat	별도 모드가 아님. 문서는 "Agent (Chat)"로 표기	"Open Chat to ask questions": 읽기 전용 모드인 Ask 사용
Inline Edit	폐지됨, 아래 참고	"Select code and press Cmd+K to edit in place": 코드를 선택해 Cmd+K 또는 Cmd+L을 누르면 Agent로 이동
Tab	자동 완성, 이름 그대로	"Supermaven": 저희가 읽은 공식 문서에 이 단어는 없음
Free	신규 고객용 $0 플랜	"Hobby": 기존 사용자용으로 유지되는 레거시 플랜
`.mdc` 규칙	프로젝트 규칙에 필수인 파일 형식	"`.cursorrules`": 레거시이며 지원 중단 예정

Cursor 도움말 페이지에는 Cmd+K가 "used to open inline edit, which has been replaced by this workflow"(이전에는 인라인 편집을 열었으나 이 워크플로로 대체되었다)고 나와 있습니다. 공식 포럼의 Cursor 직원 글은 날짜를 2026년 10월 26일로 밝히고, 터미널에서 Cmd+K로 명령을 생성하는 기능도 포함된다고 합니다. 제시된 대안은 Cmd+I를 눌러 Agent에게 요청하는 것입니다. 터미널에 관한 도움말 페이지 하나는 아직 자연어로 명령을 생성한다고 언급하므로, 문서가 이 부분에서 완전히 일관되지는 않습니다. 이 가이드는 직원 글을 따릅니다.

첫날 쓸 단축키

Cursor의 참조 표에는 Mac 키만 있고, 도움말 페이지에 Windows와 Linux 키가 일부 추가되어 있습니다. 나와 있지 않은 경우 추측하지 않고 그렇게 밝혔습니다. 그런 키는 앱의 단축키 설정(Cmd+R 다음 Cmd+S, 또는 Ctrl+R 다음 Ctrl+S)에서 확인하세요.

동작	Mac	Windows / Linux
Agent 패널 열기 또는 닫기	Cmd+I, Cmd+L 또는 Cmd+K	Ctrl+I, Ctrl+L 또는 Ctrl+K
선택한 코드를 새 채팅으로 보내기	Cmd+L 또는 Cmd+K	Ctrl+L 또는 Ctrl+K
선택한 코드를 현재 채팅에 추가	Cmd+Shift+L	나와 있지 않음, 앱에서 확인
모드 순환	Shift+Tab	Shift+Tab
모드 메뉴 열기	Cmd+.	Ctrl+.
모델 순환	Cmd+/	Ctrl+/
Tab 제안 수락	Tab	Tab
Tab을 단어 단위로 수락	Cmd+→	Ctrl+→
Tab 제안 거부	Escape 또는 계속 입력	Escape 또는 계속 입력
모든 변경 수락	Cmd+Return	나와 있지 않음, 앱에서 확인
모든 변경 거부	Cmd+Shift+Backspace	나와 있지 않음, 앱에서 확인
Cursor Settings	Cmd+Shift+J	Ctrl+Shift+J
명령 팔레트	Cmd+Shift+P	Ctrl+Shift+P

위치에 따라 달라지는 키가 두 개 있습니다. Cmd+K는 에디터에서는 패널을 열지만 Agents Window에서는 명령 팔레트를 엽니다. Cmd+Return도 키보드 단축키 참조에 나오듯 상황에 따라 뜻이 여러 가지입니다. Cmd+Shift+Backspace는 진행 중인 응답을 취소하는 키로도 나와 있으니 주의해서 누르세요.

첫 작업 따라 하기: Agent로 작은 프로젝트 개선

이 예시는 웹페이지 하나를 사용하므로 Cursor와 브라우저 외에 다른 도구가 필요 없습니다. 먼저 질문하고, 그다음 Agent가 변경하도록 합니다.

1단계: 연습 프로젝트 만들기

cursor-practice라는 빈 폴더를 만든 뒤 Cursor에서 폴더로 선택합니다. index.html 파일을 만들고 다음을 붙여 넣습니다.

<!doctype html>
<html>
  <head><meta charset="utf-8"><title>Tip calculator</title></head>
  <body>
    <h1>Tip calculator</h1>
    <label>Bill <input id="bill" type="number"></label>
    <button onclick="calculate()">Calculate 15% tip</button>
    <p id="result"></p>
    <script>
      function calculate() {
        const bill = Number(document.getElementById("bill").value);
        document.getElementById("result").textContent = "Tip: " + (bill * 0.15);
      }
    </script>
  </body>
</html>

파일을 저장하고 브라우저에서 엽니다. 금액을 비운 채 버튼을 누르면 "Tip: 0"이 나옵니다. 이것이 고칠 작은 문제입니다.

2단계: 바꾸기 전에 먼저 질문하기

Cmd+I(Ctrl+I)를 누릅니다. 모드 드롭다운을 열고 Ask를 선택하거나, 표시될 때까지 Shift+Tab을 누릅니다. 다음을 입력합니다.

index.html이 하는 일을 쉬운 말로 설명해 주세요.
그런 다음 사용자가 겪을 수 있는 문제를 나열해 주세요.

보여야 할 결과: 패널에 글로 된 답변이 나타납니다. Ask는 읽기 전용이므로 파일은 바뀌지 않습니다. 답변에는 아마 빈 금액 문제가 언급될 것입니다. 정확한 표현은 실행할 때마다 달라지니 고정된 답을 기대하지 마세요.

3단계: Agent에게 구체적인 작업 주기

Agent로 다시 전환합니다. 모드를 바꾸면 새 컨텍스트 윈도우가 열리므로, 요청만 읽어도 이해되도록 작성하세요.

@index.html의 팁 계산기를 개선해 주세요.
1. 금액이 비어 있거나 0 또는 음수이면 "Enter a bill above 0"을 표시합니다.
2. 팁을 소수점 둘째 자리까지 표시합니다.
3. 10%, 15%, 20% 드롭다운을 추가하고 기본값은 15%로 합니다.
모든 내용은 이 파일 하나에 유지하고 라이브러리는 추가하지 마세요.

보여야 할 결과: Agent가 파일을 읽고 편집을 시작합니다. 초보자에게 중요한 점은 Agent가 작업하는 동안 편집이 적용된다는 것입니다. 변경을 하나씩 미리 승인하는 방식이 아닙니다. 결과는 나중에 diff 보기에서 검토합니다.

Agent가 명령을 실행하려 할 수도 있습니다. 처리 방식은 Cursor Settings > Agents > Approvals & Execution에서 설정하는 실행 모드에 따라 다릅니다. 옵션은 Auto-review(기본값), Allowlist, Run Everything입니다. 지금은 기본값으로 두세요.

4단계: Diff 검토

Cursor는 편집 내용을 diff 보기로 보여 줍니다. 문서에 정확한 버튼 이름이 없으니 편집된 파일과 Agent 패널 주변에서 찾아보세요. 한 줄씩 읽으세요. diff는 삭제된 줄과 추가된 줄을 보여 주므로 정확히 무엇이 바뀌었는지 알 수 있습니다. 이 작업에서는 다음을 확인하세요.

금액 값에 대한 검사
세 가지 퍼센트가 있는 드롭다운
소수점 둘째 자리로 반올림된 팁
요청하지 않은 새 파일처럼 관련 없는 것이 없는지

원하지 않는 부분은 거부하세요. Mac에서 한 번에 전부 수락하거나 거부하려면 Cmd+Return 또는 Cmd+Shift+Backspace를 씁니다. Windows와 Linux는 앞서 말했듯 앱에서 확인하세요.

5단계: 직접 테스트

브라우저에서 페이지를 새로 고치고 다음 경우를 시험합니다.

입력	예상 결과
빈 금액	"Enter a bill above 0" 메시지
-5	같은 메시지
100, 15%	Tip: 15.00 또는 비슷한 값
100, 20%	Tip: 20.00 또는 비슷한 값

실패한 경우가 있으면 Agent에게 무슨 일이 있었는지 정확히 말하세요. "금액이 -5일 때 페이지에 Tip: -0.75가 표시됩니다. 메시지가 나와야 합니다." 이렇게 말하면 "고장 났어요"보다 훨씬 잘 통합니다.

6단계: 되돌리기 연습

이제 버릴 변경을 하나 만듭니다.

페이지 배경을 밝은 초록색으로 바꾸고 모든 텍스트를 40px로 만들어 주세요.

브라우저를 새로 고쳐 확인합니다. 그런 다음 대화를 위로 스크롤해 해당 요청에서 Restore Checkpoint를 클릭합니다. 도움말 페이지 하나는 이 버튼을 Revert라고 부릅니다. 다시 새로 고치면 초록색이 사라져야 합니다. 사라지지 않으면 그 이전 요청에서 복원하세요. Agent는 중요한 변경 전에 체크포인트를 만들므로, 이렇게 작은 변경에 버튼이 보이지 않으면 diff에서 거부하세요. 복원은 파일만 되돌리므로 메시지는 대화에 그대로 남습니다.

이것이 일상적인 반복의 전부입니다. 질문, 지시, 검토, 테스트, 필요하면 되돌리기입니다. diff 읽기가 절대 하고 싶지 않은 부분이라면 일찍 알게 되는 것이 도움이 됩니다. 저희 앱 빌더인 NxCode가 에디터보다 잘 맞는다는 신호일 수 있습니다.

Agent, Ask, Plan, Debug는 언제 쓸까

모드는 네 가지입니다. Agent 패널에서 Shift+Tab이나 드롭다운으로 전환합니다.

모드	이럴 때 사용	파일 변경 가능?	프롬프트 예시
Agent	무언가를 만들거나 리팩터링하거나 고치고 싶을 때. 기본값	예	"리셋 버튼을 추가하고 누르면 결과를 지워 주세요."
Ask	코드를 이해하고 싶을 때	아니요, 읽기 전용	"여기서 팁은 어떻게 계산되나요?"
Plan	작업이 크거나 불분명해서 접근 방식을 먼저 확인하고 싶을 때	승인 후 가능	"이 페이지를 HTML, CSS, JS 파일로 나누는 계획을 세워 주세요."
Debug	실행 중인 프로그램의 증거가 필요한 버그일 때	예	"퍼센트를 바꾸면 팁이 틀립니다. 원인을 찾아 주세요."

간단한 선택 기준은 다음과 같습니다.

아직 이해하지 못했다면 Ask.
원하는 것이 분명하고 변경이 작다면 Agent.
많은 파일을 건드리거나 접근 방식이 불확실하다면 Plan.
코드를 읽어도 설명되지 않는 버그라면 Debug.

Plan 모드에서 Agent는 명확히 하기 위한 질문을 하고, 코드를 조사하고, 계획을 작성합니다. Build를 클릭하기 전에는 아무것도 만들어지지 않습니다. 계획은 기본적으로 홈 디렉터리에 저장되고, Save to workspace를 쓰면 프로젝트로 옮겨집니다. 요청이 복잡해 보이면 Cursor가 Plan을 제안할 수도 있습니다.

Debug 모드에서 Agent는 가설을 세우고, 로그를 추가하고, 런타임 정보를 이용해 원인을 찾습니다.

변경 사항 검토와 되돌리기

검토 체크리스트

Agent의 변경을 유지하기 전에 다음을 확인하세요.

요약만 보지 말고 diff 전체를 읽습니다.
변경된 모든 파일이 작업과 관련이 있습니다.
각 변경을 설명할 수 있습니다. 설명할 수 없다면 Ask 모드로 질문합니다.
남아 있어야 할 것이 삭제되지 않았습니다.
코드에 비밀번호, 키 등 비밀 정보가 없습니다.
잘못된 입력 하나를 포함해 직접 테스트했습니다.

직접 검토하는 것 외에도 Cursor에는 /agent-review나 Source Control 탭에서 시작하는 Agent Review가 있습니다.

체크포인트 작동 방식

Agent는 중요한 변경 전에 체크포인트를 자동으로 만듭니다. 체크포인트는 로컬에 저장되며 Git과는 별개입니다.

복원 방법은 세 가지입니다.

채팅 타임라인에서 체크포인트를 클릭해 미리 본 뒤 복원합니다.
이전 요청에서 Restore Checkpoint를 클릭합니다.
메시지에 마우스를 올리고 + 버튼을 클릭합니다.

복원은 파일을 되돌리지만 메시지를 삭제하지는 않습니다. 대화도 줄이려면 이전 메시지에서 포크하세요.

여기서 공식 페이지의 이름 하나가 서로 다릅니다. Agent 문서는 버튼을 Restore Checkpoint라고 부르고, Plan 도움말 페이지는 Revert 다음 Confirm이라고 부릅니다. 둘 중 하나를 찾으세요.

남겨 둘 것은 Git으로

Cursor 자체 조언은 "use Git for permanent version control"(영구적인 버전 관리는 Git을 사용하라)입니다. 체크포인트는 빠른 되돌리기이고 Git은 장기 기록입니다. 큰 Agent 작업 전에 작동하는 상태를 저장하세요.

git init
git add .
git commit -m "Working version before Agent task"

git init은 프로젝트당 한 번만 하면 됩니다.

프로젝트에 규칙 추가

규칙은 상시 지침이므로 같은 말을 반복하지 않아도 됩니다. 연습 프로젝트에 하나 추가해 보세요. 프로젝트 규칙을 만드는 방법은 세 가지입니다.

채팅에 /create-rule을 입력합니다.
Customize > Rules > Add Rule로 이동합니다.
명령 팔레트에서 New Cursor Rule을 실행합니다.

또는 .cursor/rules/practice.mdc에 파일을 직접 만듭니다.

---
description: Conventions for this practice project
globs:
alwaysApply: true
---
- Keep everything in index.html unless asked otherwise.
- Do not add libraries.
- Use clear variable names and short comments.

이제 Agent에게 작은 변경을 하나 더 요청하세요. 말하지 않아도 이 규칙을 따라야 합니다.

알아 둘 네 가지는 다음과 같습니다.

확장자는 .mdc여야 합니다. 해당 폴더에서 .md로 끝나는 파일은 규칙 시스템이 무시합니다.
AGENTS.md가 더 간단한 선택지입니다. 일반 Markdown 파일이며 프로젝트 루트나 하위 폴더에 둡니다. Cursor는 CLAUDE.md도 같은 방식으로 읽습니다.
규칙은 Agent에만 적용됩니다. Tab이나 Bugbot에는 영향을 주지 않습니다.
짧게 유지하세요. Cursor는 규칙당 500줄 미만을 권합니다.

규칙에는 Always Apply, Apply Intelligently, Apply to Specific Files, Apply Manually(@ 멘션 사용)의 네 가지 유형이 있습니다. 우선순위는 Team, Project, User 순입니다. .cursorrules는 레거시이고 지원 중단 예정이므로 새 프로젝트에서는 쓰지 마세요.

MCP, Skills, Subagents, Cloud Agents 간단히 보기

첫날에는 이 중 어느 것도 필요 없습니다. 이름을 알아볼 수 있도록 소개합니다.

**MCP**는 Agent를 외부 도구와 서비스에 연결합니다. Customize > MCPs > Add to Cursor에서 설치하거나, 프로젝트의 .cursor/mcp.json 또는 전역 ~/.cursor/mcp.json을 설정합니다. 둘 다 같은 이름을 정의하면 프로젝트 쪽이 우선합니다. Cursor MCP 가이드에서 더 자세히 다룹니다.
**Skills**는 SKILL.md 파일이 들어 있는 폴더로, Agent에게 절차를 가르칩니다. Agent가 관련 있을 때 사용하거나, /로 직접 호출합니다. 내장 예시로는 /create-rule, /review, /shell이 있습니다.
**Subagents**는 자체 컨텍스트를 가지며 병렬로 실행할 수 있습니다. 내장된 것은 Explore와 Browser입니다. 맞춤 서브에이전트는 .cursor/agents/에 둡니다.
**Cloud Agents**는 격리된 클라우드 머신에서 실행되므로 내 컴퓨터가 온라인 상태일 필요가 없습니다. 에이전트 입력창의 드롭다운에서 Cloud를 선택합니다. 관리자가 먼저 GitHub, GitLab, Bitbucket, Azure DevOps를 연결해야 하고, 저장소 읽기 및 쓰기 권한이 필요합니다. Free와 Plus에서는 쓸 수 없습니다.

명령줄: `agent`

Cursor에는 CLI도 있으며 명령은 agent입니다. 다음으로 설치합니다.

# macOS, Linux, WSL
curl https://cursor.com/install -fsS | bash

# Windows PowerShell
irm 'https://cursor.com/install?win32=true' | iex

agent --version으로 확인하고 agent login으로 로그인합니다. 그런 다음 프로젝트 폴더에서 agent를 실행하면 대화형 세션이, agent -p "your request"를 실행하면 비대화형 단일 실행이 시작됩니다. 에디터와 같은 .cursor/rules, AGENTS.md, CLAUDE.md 파일을 읽습니다. 초보자는 나중으로 미뤄도 됩니다.

흔한 실수

오래된 튜토리얼 따라 하기. 가이드가 Composer 모드를 열라고 하거나, Cmd+K로 제자리 편집을 하라고 하거나, 첫 실행 때 모델을 고르라고 하면 예전 Cursor를 설명하는 것입니다.

수락하기 전에는 아무것도 바뀌지 않았다고 가정하기. Agent의 편집은 작업 중에 이미 적용됩니다. 다음으로 넘어가기 전에 diff를 확인하고, 믿고 그냥 코드를 실행하지 마세요.

모호하게 요청하기. "이거 고쳐 줘"는 Agent에게 정보가 거의 없습니다. 무슨 일이 일어나는지, 어떻게 되어야 하는지, 어디인지 말하세요. "금액이 비어 있으면 페이지에 Tip: 0이 표시됩니다. 대신 메시지가 나와야 합니다."

처음부터 너무 크게 시작하기. 완성된 앱으로 시작하지 마세요. 먼저 작은 작업을 하고, 그보다 큰 것은 Plan 모드를 쓰세요.

체크포인트를 백업으로 여기기. 체크포인트는 로컬에 있고 Git과 별개입니다. 중요한 것은 커밋하세요.

규칙을 .md로 저장하기. 맞아 보이지만 아무 일도 하지 않습니다. .mdc를 쓰거나 프로젝트 루트의 AGENTS.md를 쓰세요.

첫날 실행 모드 바꾸기. Agent가 내 컴퓨터에서 무엇을 실행하는지, 각 옵션이 어떤 권한을 주는지 이해할 때까지 기본값으로 두세요.

비용을 확인하지 않고 서드파티 모델 고르기. Premium 이상에서 서드파티 모델은 첫 요청부터 선불 크레딧에서 API 정가로 차감됩니다. 주간 풀을 쓰지 않습니다.

설명할 수 없는 코드 수락하기. Ask 모드가 바로 이럴 때 필요합니다. 유지하기 전에 "이 변경은 단계별로 무엇을 하나요?"라고 물어보세요.

문제 해결

인터페이스와 설정

보이는 현상	가능한 이유	할 일
Composer 모드가 어디에도 없음	더 이상 모드로 존재하지 않음	Cmd+I(Ctrl+I)로 Agent 사용
Cmd+K로 제자리 편집이 안 됨	Inline Edit가 폐지됨	코드를 선택해 Cmd+K를 누른 뒤 Agent에서 변경 내용 설명
Cmd+K가 명령 팔레트를 엶	Agents Window에 있음	Cmd+Shift+P 후 Open IDE로 에디터 복귀
Grok 또는 xAI 로그인 페이지가 나타남	공유 로그인	정상. 로그인해도 계정이 병합되지 않음
확장이 없음	Open VSX에 없을 수 있음	Open VSX에서 대안 찾기
규칙이 무시됨	확장자 또는 위치가 잘못됨	`.cursor/rules/name.mdc`를 쓰고 유형 확인
Agent가 앞선 컨텍스트를 잊음	모드를 전환함	전환할 때마다 새 컨텍스트 윈도우가 열리므로 요점을 다시 설명
Windows에서 단축키가 작동하지 않음	Mac 키와 다를 수 있음	Ctrl+R 다음 Ctrl+S로 단축키 설정 확인

모델, 플랜, CLI

보이는 현상	가능한 이유	할 일
Claude나 GPT가 없음	플랜 또는 지역	Free와 Plus에는 서드파티 모델이 없음. 일부 모델은 특정 지역에서 숨겨짐
Cloud Agents를 쓸 수 없음	플랜 또는 저장소 설정	Premium 이상, 연결된 Git 제공자, 저장소 접근 권한 필요
사용 한도에 도달	플랜 한도 도달	grok.com/dashboard의 Usage 확인. 유료 플랜은 주간 초기화를 기다리거나 선불 크레딧을 쓰거나 업그레이드
결제 메뉴를 찾을 수 없음	결제 위치 이동	The X Subscription은 grok.com/dashboard/billing, 레거시 플랜은 cursor.com/dashboard/spending
`agent: command not found`	`~/.local/bin`이 PATH에 없음	PATH에 추가한 뒤 새 터미널 열기

다른 도구를 써야 할 때

Cursor는 코드를 다루는 도구입니다. 다음 상황이라면 다른 곳을 살펴볼 수 있습니다.

코드를 쓰거나 검토하고 싶지 않은 경우. 설명만으로 작동하는 앱을 원한다면, 저희 제품 NxCode가 그런 용도입니다. 저희가 만든 제품이니 이 점을 감안해 읽어 주시고, Cursor, Copilot과의 비교도 참고하세요.
터미널에서 주로 일하는 경우. 먼저 Cursor의 agent 명령을 써 보거나, Claude Code 튜토리얼의 워크플로와 비교해 보세요.
JetBrains를 쓰는 경우. Cursor의 agent가 ACP를 통해 JetBrains에 연결되므로 에디터를 바꾸지 않아도 될 수 있습니다.
아직 도구를 비교하는 중인 경우. AI 코딩 도구 순위에서 선택지를 정리했습니다.

Free로 Cursor를 써 보는 데는 비용이 들지 않으므로, 작은 실제 작업으로 판단해 보는 것이 합리적입니다. 위 워크플로가 자연스럽게 느껴졌다면 계속 쓰세요. 코드 자체가 걸림돌이었다면 첫 번째 상황이 맞을 가능성이 높습니다.

자주 묻는 질문 (FAQ)

Cursor를 처음 쓸 때 어떻게 시작하나요?

cursor.com/download에서 내려받아 열고, 로그인한 뒤 폴더를 선택하세요. 그런 다음 Cmd+I(윈도우·리눅스는 Ctrl+I)를 눌러 Agent를 열고 코드를 설명해 달라고 요청하세요. 공식 빠른 시작 문서도 이렇게 작은 작업부터 시작하기를 권합니다.

Cursor의 Composer 모드는 어떻게 되었나요?

Composer 모드는 현재 공식 문서에 없습니다. 이제 이 이름은 자체 모델을 가리키며, 현재 버전은 Composer 2.5입니다. 네 가지 모드는 Agent, Ask, Plan, Debug입니다. 이전 튜토리얼에서 그 모드로 하던 여러 파일 작업은 Agent로 하면 됩니다.

Cursor의 Cmd+K 인라인 편집은 어떻게 되었나요?

인라인 편집은 폐지되었습니다. 공식 포럼의 Cursor 직원 글은 그 시점을 2026년 10월 26일로 밝힙니다. 에디터에서 코드를 선택하고 Cmd+K 또는 Cmd+L(윈도우·리눅스는 Ctrl+K 또는 Ctrl+L)을 눌러 선택 영역을 Agent로 가져온 뒤, 거기서 변경 내용을 설명하세요.

Cursor는 무료인가요?

네, $0인 Free 플랜이 있으며 Agent, Chat, Tab을 제한적으로 쓸 수 있습니다. Cursor는 이 한도의 수치를 공개하지 않습니다. 현재 요금 페이지에는 신용카드가 필요한지 나와 있지 않으므로 가입할 때 확인하세요. 유료 플랜은 세전 월 $8인 Plus부터 시작합니다.

Cursor에서 어떤 AI 모델을 쓸 수 있나요?

자체 모델은 플래그십 모델이라고 부르는 Grok 4.7과 Grok 4.6, 4.5, Composer 2.5입니다. Claude, GPT, Gemini 같은 서드파티 모델은 Premium 이상이 필요하며 선불 크레딧에서 API 정가로 차감됩니다. Free와 Plus에는 포함되지 않습니다.

Cursor Agent는 내가 승인하기 전에 파일을 바꾸나요?

네. Agent는 작업하면서 편집을 적용하고, 나중에 diff 보기에서 검토하며 원하지 않는 부분을 거부할 수 있습니다. Agent는 중요한 변경 전에 체크포인트도 만들므로 이전 파일 상태로 복원할 수 있습니다.

Cursor를 쓰려면 코딩을 알아야 하나요?

Ask 모드가 코드를 쉬운 말로 설명해 주므로 경험이 많지 않아도 써 볼 수 있지만, diff를 읽고 결과를 판단하는 일은 여전히 직접 해야 합니다. 앱을 설명만 하고 코드는 전혀 다루고 싶지 않다면, 저희 제품인 NxCode가 그런 용도로 만들어졌습니다.

Cursor는 어디서 살 수 있고, 중국 본토에서도 구독할 수 있나요?

Cursor는 구독을 공식 웹사이트나 인앱 결제로만 판매하며 리셀러를 승인하지 않는다고 밝힙니다. iOS 인앱 결제는 중국 본토를 제외한 App Store 지역에서 가능합니다. 중국 본토에서 웹 구독이 제한되는지는 공식 페이지로 확인할 수 없었습니다.

참고 자료

모든 페이지는 2026년 11월 1일에 확인했습니다. 단축키, 플랜, 이름은 바뀔 수 있으므로 앱과 공식 페이지를 최종 기준으로 삼으세요.