본문으로 건너뛰기
블로그로 돌아가기
[GUIDE]

커서 시작하기 2026: 설치 6단계, 첫 질문, Tab 자동완성, 막힐 때 대처, 요금제 조건까지

퀀텀점프클럽 정상록퀀텀점프클럽 정상록14분 읽기1 views

커서 시작하기 2026: 설치 6단계, 첫 질문, Tab 자동완성, 막힐 때 대처, 요금제 조건까지

커서: Cursor라는 이름의 코드 편집 프로그램이에요. 코드(컴퓨터에게 일을 시키는 글)를 쓰고 고치는 프로그램인데, 안에 Agent(말로 요청하면 파일을 읽고 고쳐 주는 AI 도우미)와 Tab 자동완성(입력하는 중에 다음 내용을 회색 글씨로 제안하는 기능)이 들어 있어요. 컴퓨터에 설치하는 데스크톱 앱이고, 무료 계정으로 시작할 수 있어요.

커서는 무엇이고, 왜 처음 배우는 분에게 쓸모가 있나요?

Cursor 공식 Agent 문서에 따르면 Agent는 지시, 도구, 모델 3가지 요소로 움직여요. 여기서 도구가 하는 일은 공식 첫 프로젝트 문서에 적혀 있어요. 코드베이스(프로젝트 안의 파일 전체)를 검색하고, 파일을 편집하고, 터미널(명령어를 글자로 입력하는 창)에서 명령을 실행하는 거예요.

작업 하나에 Agent가 도구를 몇 번 쓸 수 있는지도 같은 문서에 한 줄로 나와요.

"There is no limit on the number of tool calls Agent can make during a task."

한 작업을 하는 동안 Agent가 도구를 부르는 횟수에는 제한이 없다는 뜻이에요. 사람이 파일을 하나씩 열어 보며 찾던 일을 Agent가 대신 훑어 준다고 생각하면 돼요.

초보에게 쓸모가 있는 이유는 첫 질문의 문턱이 낮아서예요. 공식 퀵스타트가 권하는 첫 요청은 무언가를 고치라는 말이 아니라 "이 코드베이스를 설명해 달라"는 질문이에요. 읽고 설명을 듣는 일부터 시작하면 되니까 낯선 폴더도 부담이 적어요.

시작 전에 무엇을 준비하면 되나요?

준비물은 계정 1개, 지원하는 운영체제, 연습용 폴더예요.

Cursor 공식 설치 도움말에 따르면 설치 전에 Cursor 계정이 필요하고, cursor.com에서 무료로 가입할 수 있어요. 계정이 있어야 설치가 끝난 뒤 로그인해서 쓸 수 있어서 먼저 만들어 두는 게 순서에 맞아요.

공식 퀵스타트가 적은 지원 환경은 이래요.

  • macOS는 12(Monterey) 이상이고, Apple Silicon 칩과 Intel 칩 모두 지원해요.
  • Windows는 10 이상이고, .exe 설치 파일을 써요.
  • Linux는 패키지 도구(apt, dnf)나 AppImage(설치 없이 바로 실행하는 리눅스용 파일)로 설치해요.

연습용 폴더는 Agent가 파일을 읽고 고치는 대상이에요. 중요한 파일이 든 폴더보다 비어 있거나 가벼운 폴더를 하나 만들어 두면 마음이 편해요.

커서 설치는 어떻게 하나요?

공식 설치 도움말은 설치를 6단계로 안내하고, 5분 안쪽이면 커서를 실행할 수 있다고 적어요. 단계마다 왜 필요한지도 붙였어요.

  1. 다운로드 페이지(cursor.com/download)를 열어요. 내 운영체제에 맞는 설치 파일이 이곳에 모여 있어서예요.
  2. 내 운영체제 버튼을 눌러요. 운영체제마다 파일 종류가 달라서 맞는 것을 받아야 해요.
  3. 받은 파일을 열어요. 파일을 열어야 설치가 시작돼요.
  4. 운영체제에 맞게 설치해요. Mac은 Applications 폴더로 끌어 넣고, Windows는 설치 프로그램을 실행하고, Linux는 apt나 dnf 또는 AppImage를 써요.
  5. 앱을 열어요. 설치만으로는 화면이 뜨지 않아서 직접 한 번 실행해야 해요.
  6. 로그인해요. 앞에서 만든 무료 계정으로 들어가야 Agent와 Tab 자동완성을 쓸 수 있어요.

Linux에서 AppImage를 쓴다면 아래 두 줄을 터미널에 차례로 입력하면 돼요. 첫 줄은 내려받은 파일에 실행 권한을 주는 명령이고, 둘째 줄은 그 파일을 실행하는 명령이에요.

chmod +x Cursor-*.AppImage
./Cursor-*.AppImage

공식 퀵스타트는 Linux에서 AppImage보다 패키지 방식을 권해요. 바탕화면 아이콘과 자동 업데이트를 받을 수 있기 때문이에요.

폴더를 열고 Agent에게 첫 질문을 하려면 어떻게 하나요?

프로젝트 폴더는 어떻게 여나요?

공식 첫 프로젝트 문서는 폴더 열기를 3단계로 안내해요. 커서를 열고, File > Open Folder를 누르고, 연습용 폴더를 고르면 끝이에요. Agent는 이렇게 연 폴더 안에서 일하기 때문에 이 단계가 먼저예요.

Agent는 어떻게 열고 무엇을 물어보나요?

Agent 패널은 Mac에서는 Cmd+I, Windows와 Linux에서는 Ctrl+I로 열어요. 열린 입력창에 평소 말하듯 요청을 쓰면 돼요.

퀵스타트가 보여 주는 첫 질문 예시는 2개예요. 첫째는 코드베이스를 설명해 달라는 요청이에요.

"Explain this codebase. Point me to the main entry points, key modules, and anything I should read before making changes."

이 코드베이스를 설명하고, 가장 먼저 봐야 할 진입점과 핵심 부분, 고치기 전에 읽어 둘 것을 알려 달라는 뜻이에요. 둘째 예시는 이래요.

"Suggest three small, safe improvements in this codebase. Explain the tradeoffs and wait for me to choose one."

작고 안전한 개선안 3개를 제안하고, 장단점을 설명한 뒤 내가 고를 때까지 기다리라는 뜻이에요. 공식 퀵스타트는 첫 작업으로 "Good first tasks are low risk, like improving some copywriting or fixing small UI issues."라고 적어요. 문구를 다듬거나 화면의 작은 문제를 고치는 것처럼 위험이 낮은 일이 첫 작업으로 좋다는 말이에요.

Agent가 고친 내용은 어떻게 검토하고 거절하나요?

공식 첫 프로젝트 문서에 따르면 Agent의 수정은 작업 중에 바로 적용돼요. 그래서 diff(바뀌기 전과 후를 나란히 비교해서 보여 주는 화면)로 확인하는 습관이 중요해요. 마음에 들지 않는 부분은 거절하면 돼요. 읽기만 시킨 첫 질문에서는 바뀌는 게 없으니 안심하고 연습할 수 있어요.

파일을 콕 집어 말하려면 어떻게 하나요?

채팅 입력창에서 @를 치면 특정 파일이나 폴더를 지정할 수 있어요. 예를 들어 @auth.ts처럼 쓰면 그 파일을 보고 답하라는 뜻이 돼요. 질문이 넓을 때 범위를 좁혀 주는 방법이에요.

입력하는 중에 도와주는 Tab 자동완성은 어떻게 쓰나요?

Cursor 공식 Tab 도움말에 따르면 글자를 입력하는 동안 다음에 올 코드가 회색 글씨로 제안돼요. 이 제안은 Agent와 달리 말을 걸지 않아도 알아서 떠요. Tab 키를 누르면 받아들이고, Escape 키를 누르면 거절해요. 제안의 한 단어만 받고 싶으면 Mac은 Cmd+→, Windows는 Ctrl+→를 눌러요.

Tab 자동완성이 거슬리면 끌 수 있어요. 화면 오른쪽 아래의 Tab 표시를 누르면 끄는 방법이 3가지 나와요. 잠시 끄기, 전체 끄기, 파일 형식별 끄기예요. 공식 요금 문서에 따르면 Free에서도 Tab을 쓸 수 있어요.

큰 작업은 Plan Mode로 어떻게 맡기나요?

Plan Mode(바로 고치지 않고 계획을 먼저 세우고 내 승인을 기다리는 모드)는 Agent 입력창에서 Shift+Tab을 눌러 켜요. 공식 퀵스타트는 여러 파일에 걸쳐 있거나 승인이 필요한 큰 작업에 쓰라고 안내해요.

동작은 4단계예요. 코드베이스를 조사하고, 궁금한 점을 질문하고, 계획을 쓰고, 내 승인을 기다려요. 계획을 먼저 읽고 마음에 들 때만 진행시킬 수 있어서, 처음에 범위가 큰 일을 맡길 때 안전장치가 돼요.

커서 요금제는 어떻게 되고, 무료로 어디까지 쓸 수 있나요?

가격은 2026년 11월 20일에 Cursor 공식 요금 문서와 가격 페이지에서 서로 대조한 값이에요. 신규 가입 기준 개인 요금제는 5개이고, 금액은 모두 달러 표기이며 세금은 별도예요.

요금제월 요금공식 문서의 설명
Free$0Agent, Chat, Tab을 Cursor 모델(Grok, Composer)로 제한된 사용량만큼 사용
Plus$8연간 결제는 $80. 타사 모델, Auto, Cloud Agents 등이 없음
Premium$30Plus의 4배 사용량
Super$100Plus의 15배 사용량
Ultra$200Plus의 50배 사용량

Plus가 가장 싸 보여서 먼저 고르기 쉬운데, 조건을 꼭 같이 보세요. 공식 요금 문서에 따르면 Plus에는 타사 모델, Auto, Cloud Agents, Automations, Bugbot, Origin이 없어요. 이 기능들은 Premium 이상에서 추가돼요. 처음 써 보는 분이라면 Free로 시작해 설치부터 첫 질문까지 해 본 뒤에 정하는 순서가 부담이 적어요.

예전 Hobby·Pro 같은 요금제는 기존 가입자만 유지하는 구 요금제라서 신규 가입 기준으로는 보지 않아요. 요금과 포함 범위는 바뀔 수 있으니 결제 전에 공식 가격 페이지를 한 번 더 확인하세요.

VS Code를 쓰던 분은 설정을 그대로 가져올 수 있나요?

가져올 수 있어요. Cursor 공식 VS Code 이전 안내에 따르면 Cmd+Shift+J(Windows와 Linux는 Ctrl+Shift+J)를 누르고 General > Account로 가서 VS Code Import의 Import 버튼을 누르면 돼요. 확장(기능을 덧붙이는 부가 프로그램), 테마, 설정, 단축키가 넘어와요. VS Code와 Cursor는 2개의 따로 실행되는 앱이라 둘 다 써도 돼요.

주의할 점이 하나 있어요. 커서는 VS Code 마켓플레이스가 아니라 Open VSX(오픈소스 확장 저장소)를 써서, 쓰던 확장이 전부 있지는 않아요. 없는 확장은 대체할 것을 찾아야 해요.

처음 하면 여기서 막힙니다

공식 도움말이 직접 적은 문제 6가지와 대처법이에요.

1. 시작하면 빈 화면만 나와요. 공식 설치 문제 안내는 대처를 4가지로 적어요. 먼저 앱을 다시 시작해 보세요. Mac은 앱을 휴지통에 넣고 다시 설치하고, Windows는 관리자 권한으로 실행하고, 그래도 안 되면 완전히 종료(Mac은 Cmd+Q)한 뒤 다시 실행해요. 업데이트가 필요하면 Cmd/Ctrl+Shift+P로 명령 검색창을 열어 "Cursor: Attempt Update"를 실행하고 재시작해요.

2. macOS에서 "Cursor is damaged" 경고가 떠요. 공식 안내에 따르면 다운로드가 손상된 게 아니라 macOS 쪽 문제예요. 앱을 종료하고, 활동 모니터에서 강제 종료하고, 1분 뒤 다시 실행해 보세요. 계속되면 휴지통을 비우고 다시 내려받고, 그래도 안 되면 Mac을 재시동해요.

3. 회사 네트워크에서 로그인이 안 돼요. 로그인 페이지가 accounts.spacexsi.com으로 옮겨 가는 중이에요. 회사 방화벽이나 프록시(회사 네트워크의 출입을 통제하는 장치)가 이 주소를 막으면 로그인이 안 되니, IT 담당자에게 허용 목록에 추가해 달라고 요청하세요. 예전 로그인 페이지로 넘어가던 폴백은 11월 30일에 끝나요.

4. VS Code에서 쓰던 확장이 안 보여요. 고장이 아니라 Open VSX를 쓰기 때문이에요. 모든 확장이 있지는 않다는 점을 알고 시작하면 덜 당황해요.

5. Agent가 고친 내용이 이미 적용돼 있어요. Agent의 수정은 작업 중에 바로 적용돼요. diff 화면에서 바뀐 곳을 확인하고 원치 않는 부분은 거절하세요. 중요한 폴더에서 일을 시킬 때는 특히 더 확인하는 게 좋아요.

6. Free에서 사용량이 부족해요. Free는 Agent, Chat, Tab을 제한된 사용량만큼만 쓸 수 있어요. 공식 표기는 "Limited"예요. 한도에 닿았을 때의 구체적인 동작은 공식 요금 문서에서 확인하세요.

마무리

오늘 할 일은 하나면 충분해요. 연습용 폴더를 하나 만들어 커서로 열고, Agent에게 "Explain this codebase."로 시작하는 첫 질문을 보내 보세요. 읽기만 시키는 질문이라 파일이 바뀔 걱정이 없고, Agent가 폴더를 어떻게 읽는지 한 번 보면 그다음 요청이 훨씬 쉬워져요.

그다음 걸음은 이렇게 이어가 보세요.

자주 묻는 질문

커서는 무료로 쓸 수 있나요?

공식 요금 문서에 Free는 월 $0로 적혀 있어요. Agent, Chat, Tab을 Cursor 모델(Grok, Composer)로 제한된 사용량만큼 쓸 수 있어요. 가격과 포함 범위는 바뀔 수 있으니 공식 가격 페이지에서 확인하세요.

코딩을 잘 몰라도 시작할 수 있나요?

공식 설치 안내에 준비물로 적힌 것은 무료 계정과 지원 운영체제예요. 퀵스타트가 권하는 첫 질문도 코드베이스를 설명해 달라는 읽기 요청이라, 파일을 바꾸지 않고 연습할 수 있어요. 무언가를 고치게 할 때는 diff 화면에서 바뀐 내용을 확인하세요.

Agent가 파일을 마음대로 고치면 어떻게 하나요?

공식 첫 프로젝트 문서에 따르면 Agent의 수정은 작업 중에 바로 적용돼요. 그래서 diff 화면에서 검토하고, 원치 않는 변경은 거절해요. 큰 작업은 Plan Mode(Shift+Tab)로 계획을 먼저 보고 승인한 뒤에 진행시킬 수 있어요.

macOS에서 "Cursor is damaged"가 뜨면 어떻게 하나요?

다운로드가 손상된 게 아니라 macOS 문제라고 공식 안내가 적어요. 앱을 종료하고 활동 모니터에서 강제 종료한 뒤 1분 후 다시 실행해 보세요. 계속되면 휴지통을 비우고 다시 내려받고, 그래도 안 되면 Mac을 재시동하세요.

회사 네트워크에서 로그인이 안 되면 어떻게 하나요?

로그인 페이지가 accounts.spacexsi.com으로 옮겨 가는 중이라, 회사 방화벽이나 프록시가 막으면 IT 담당자에게 허용 목록 추가를 요청해야 해요. 예전 로그인 페이지로 넘어가던 폴백은 11월 30일에 끝나요.

VS Code 확장이 커서에 안 보이는 건 왜인가요?

커서는 VS Code 마켓플레이스가 아니라 Open VSX를 써서 모든 확장이 있지는 않아요. 설정, 테마, 단축키는 Cmd/Ctrl+Shift+J로 열어 VS Code Import에서 가져올 수 있어요.

시작하면 빈 화면만 나오면 어떻게 하나요?

공식 안내의 대처 4가지는 재시작, Mac에서는 휴지통에 넣고 재설치, Windows에서는 관리자 권한 실행, 완전 종료(Mac은 Cmd+Q) 후 재실행이에요. 순서대로 하나씩 해 보세요.

Plus 요금제로 시작해도 되나요?

Plus는 월 $8이지만 타사 모델, Auto, Cloud Agents가 없다는 조건이 붙어요. 이 기능이 필요 없다면 선택할 수 있고, 필요하면 Premium 이상을 봐야 해요. 처음이라면 Free로 먼저 써 본 뒤에 정해도 늦지 않아요.

관련 글

참고 자료