Cursor 설치, 정말 5분이면 끝날까? 다운로드부터 한글 설정까지

먼저 답부터 드리면, Cursor 설치는 공식 사이트에서 내려받아 실행하고 로그인하는 3단계로 끝나요. 넉넉히 잡아도 10분이면 첫 프로젝트 폴더를 열 수 있어요.

다만 처음 설치하는 사람이 막히는 지점은 따로 있어요. “VSCode에 확장으로 까는 건가?”, “한글은 어떻게 바꾸지?”, “터미널에 cursor라고 쳤는데 왜 명령어가 없다고 하지?” 같은 것들이죠.

그래서 이 글에서는 다운로드 → 설치 → 로그인 → VSCode 설정 가져오기 → 한글 설정 → 첫 폴더 열기까지 화면 순서 그대로 정리했어요. 리눅스 AppImage처럼 조금 까다로운 경우와, 설치가 안 될 때 점검하는 순서도 함께 담았습니다. 코딩을 전혀 몰라도 클릭 순서만 따라오면 됩니다.

• Cursor 설치, 결국 몇 분이면 끝날까?
• Cursor는 VSCode 확장인가요, 별도 프로그램인가요?
• 설치 전에 뭘 준비해야 하나요?
• 윈도우와 맥에서는 어떻게 설치하나요?
• 우분투(리눅스)에는 어떤 방식으로 설치하나요?
• 첫 실행 화면에서 뭘 눌러야 하나요? 한글 설정은?
• 터미널에서 cursor 명령어가 안 먹힐 때는?
• 무료로 어디까지 쓸 수 있나요?
• 설치가 실패하거나 실행이 안 될 때 점검 순서
• Claude Code를 쓰다가 Cursor를 같이 켜게 된 이유
• 자주 묻는 질문
• 참고자료

Cursor 설치, 결국 몇 분이면 끝날까?

Cursor는 AI가 코드를 대신 써주는 코드 에디터예요. 마이크로소프트가 만든 VSCode를 기반으로 갈라져 나온(포크된) 프로그램이라, 겉모습과 조작법이 VSCode와 거의 같아요.

그래서 설치 자체는 카카오톡이나 크롬을 까는 것과 다르지 않아요. 실제로 다운로드 완료까지 1~2분, 설치 마법사 클릭이 1분, 로그인과 초기 세팅이 3~5분 정도 걸려요. 인터넷 속도가 느리면 다운로드 시간만 조금 늘어날 뿐이에요.

시간이 더 드는 쪽은 설치가 아니라 그 뒤예요. 어떤 폴더를 열어서 뭘 만들지 정하는 단계, 그리고 AI에게 어떻게 말을 걸지 감을 잡는 단계요. 설치는 진짜 준비운동에 가깝습니다.

전체 흐름을 미리 그려두면 중간에 헤매지 않아요. 정리하면 이렇게 진행됩니다.

Cursor는 VSCode 확장인가요, 별도 프로그램인가요?

별도 프로그램이에요. 이 부분에서 헷갈려서 VSCode 확장 마켓플레이스를 한참 뒤지는 경우가 정말 많아요. 검색해도 안 나오는 게 당연합니다.

Cursor는 VSCode의 공개 소스를 가져다 AI 기능을 얹어 만든 독립 에디터예요. 그러니까 VSCode를 지울 필요도 없고, 두 프로그램을 동시에 켜둬도 서로 충돌하지 않아요. 바탕화면에 아이콘이 두 개 생기는 구조라고 보면 됩니다.

대신 첫 실행 때 “VSCode에서 설정 가져오기” 화면이 나와요. 여기서 확장 프로그램, 테마, 단축키, 사용자 설정을 그대로 복사해 옵니다. VSCode를 쓰던 사람이라면 이걸 누르는 순간 익숙한 환경이 그대로 재현돼요.

또 하나 자주 나오는 질문이 “그럼 VSCode에서 Cursor 기능만 쓸 수는 없나요?”인데, 핵심 기능은 Cursor 안에서만 동작해요. VSCode를 계속 쓰고 싶다면 별도의 AI 확장을 쓰는 쪽이 맞고, Cursor의 편집 경험을 원한다면 Cursor를 설치하는 게 정답입니다.

설치 전에 뭘 준비해야 하나요?

준비물은 생각보다 단출해요. 인터넷 연결, 로그인용 계정, 그리고 약간의 저장 공간이면 충분합니다.

여기서 헷갈리기 쉬운 게 사양이에요. AI가 코드를 쓴다고 해서 고성능 그래픽카드가 필요한 건 아니에요. 모델은 인터넷 너머 서버에서 돌아가고, 내 컴퓨터는 편집기를 띄우는 역할만 해요. 사무용 노트북으로도 충분합니다.

Git과 Node.js는 필수가 아니라 선택이에요. 다만 나중에 웹사이트나 랜딩페이지를 만들 계획이라면 Node.js가 있어야 개발 서버를 띄울 수 있고, 코드 버전을 관리하려면 Git이 필요해요. 지금 당장 없어도 설치는 되니, 일단 Cursor부터 깔고 나중에 필요할 때 채우는 순서가 덜 부담스러워요.

윈도우와 맥에서는 어떻게 설치하나요?

두 운영체제 모두 다운로드 페이지는 같아요. 공식 사이트에 접속하면 접속한 기기를 감지해서 알맞은 버튼을 보여줍니다. 만약 감지가 잘못됐다면 버튼 옆의 다른 플랫폼 선택 메뉴에서 직접 고르면 돼요.

윈도우는 내려받은 설치 파일(확장자 exe)을 더블클릭하면 됩니다. 설치 위치를 물어보는 화면이 나오는데, 특별한 이유가 없다면 기본값 그대로 두세요. 기본적으로 사용자 계정 폴더 아래 AppData\Local\Programs 경로에 설치돼요. 관리자 권한 없이도 설치되도록 만들어진 구조라, 회사 노트북처럼 권한이 제한된 환경에서도 대체로 설치가 됩니다.

설치 옵션 화면에서 “바탕화면 아이콘 만들기”와 “PATH에 추가” 항목을 보게 돼요. PATH 추가는 체크해두는 걸 권합니다. 나중에 터미널에서 cursor 명령어로 폴더를 바로 여는 데 쓰이거든요.

맥은 dmg 파일을 열면 Cursor 아이콘과 Applications 폴더가 나란히 뜨는 화면이 나와요. 아이콘을 폴더 위로 끌어다 놓으면 설치가 끝납니다. 별도의 설치 마법사가 없어서 처음이면 “이게 끝인가?” 싶은데, 정말 이게 전부예요.

맥에서는 칩 종류를 확인하면 좋아요. 왼쪽 위 사과 메뉴 → 이 Mac에 관하여에서 Apple M 시리즈면 Apple Silicon용, Intel이라고 적혀 있으면 Intel용을 받습니다. 공식 사이트는 보통 이걸 자동으로 구분해주지만, 수동으로 받을 때는 직접 골라야 해요.

우분투(리눅스)에는 어떤 방식으로 설치하나요?

리눅스는 선택지가 둘이에요. AppImage 파일을 그대로 실행하는 방식과, deb 패키지를 설치하는 방식입니다. 배포 상황에 따라 제공되는 형식이 달라질 수 있으니 다운로드 페이지에서 어떤 파일이 제공되는지 먼저 확인하세요.

AppImage는 설치라는 개념 없이 파일 하나가 곧 프로그램이에요. 다운로드한 뒤 실행 권한만 주면 됩니다. 터미널에서 파일이 있는 폴더로 이동한 뒤 chmod +x 뒤에 파일명을 붙여 실행 권한을 주고, ./파일명으로 실행해요.

여기서 초보자가 가장 많이 막히는 게 “권한이 거부되었습니다” 메시지예요. 십중팔구 실행 권한을 안 준 경우입니다. 파일 관리자에서 파일 속성 → 권한 탭 → 실행 가능 체크로도 해결돼요.

일부 환경에서는 FUSE 관련 라이브러리가 없어 AppImage가 실행되지 않기도 해요. 이때는 배포판 문서에 따라 FUSE 패키지를 설치하거나, --appimage-extract-and-run 옵션을 붙여 실행하는 우회 방법을 쓸 수 있습니다.

deb 패키지가 제공된다면 이쪽이 훨씬 편해요. 파일을 더블클릭해 소프트웨어 설치 관리자로 설치하거나, 터미널에서 sudo apt install ./파일명.deb 형태로 설치하면 됩니다. 이 방식은 애플리케이션 메뉴에 자동 등록돼서 매번 터미널을 열 필요가 없어요.

AppImage로 설치했다면 메뉴 등록이 안 되는 게 단점이에요. 매번 파일을 찾아 실행해야 하죠. AppImageLauncher 같은 도구를 쓰면 아이콘 등록과 업데이트 관리를 대신해줘요. 업데이트도 방식마다 달라서, AppImage는 새 파일을 받아 교체하는 수동 방식, deb는 새 패키지를 받아 다시 설치하는 방식으로 갱신합니다.

첫 실행 화면에서 뭘 눌러야 하나요? 한글 설정은?

첫 실행을 하면 온보딩 화면이 몇 장 이어서 나와요. 순서를 미리 알면 당황하지 않습니다.

이제 한글 설정이에요. 메뉴가 영어라서 답답하다면 한국어 언어팩을 깔면 됩니다. 왼쪽 사이드바의 확장(네모 블록 아이콘)을 누르고 검색창에 Korean이라고 입력하세요. Korean Language Pack 항목을 설치한 뒤 재시작하면 메뉴가 한국어로 바뀝니다.

혹시 설치했는데도 영어 그대로라면, 명령 팔레트(윈도우·리눅스는 Ctrl+Shift+P, 맥은 Cmd+Shift+P)를 열고 Configure Display Language를 입력한 뒤 한국어를 선택하세요. 그다음 에디터를 껐다 켜면 적용됩니다.

한글 설정에서 하나 더 챙길 게 있어요. 한글 주석을 많이 쓴다면 글꼴에 따라 글자 폭이 어긋나 보일 수 있어요. 설정에서 Font Family 항목에 D2Coding이나 나눔고딕코딩 같은 한글 고정폭 글꼴을 추가해두면 훨씬 정돈돼 보입니다. 글꼴은 미리 컴퓨터에 설치돼 있어야 하고, 라이선스를 확인한 뒤 공식 배포처에서 받으세요.

터미널에서 cursor 명령어가 안 먹힐 때는?

터미널에 cursor .이라고 쳤는데 “명령어를 찾을 수 없음”이 뜬다면, CLI 명령어가 시스템 경로(PATH)에 등록되지 않은 거예요. 해결은 30초면 됩니다.

Cursor를 켜고 명령 팔레트를 여세요. 윈도우와 리눅스는 Ctrl+Shift+P, 맥은 Cmd+Shift+P입니다. 검색창에 Install이라고 입력하면 “Install ‘cursor’ command” 같은 항목이 나와요. 이걸 실행하면 명령어가 등록됩니다.

중요한 건 그다음이에요. 등록 직후에 이미 열려 있던 터미널 창에서는 여전히 인식이 안 돼요. 터미널을 완전히 닫았다가 새로 열어야 반영됩니다. 이걸 몰라서 “등록했는데 왜 안 되지” 하며 같은 작업을 반복하는 일이 흔해요.

그래도 안 된다면 OS별로 이렇게 확인해보세요.

• 윈도우: 시스템 환경 변수 편집 → 환경 변수 → 사용자 변수의 Path에 Cursor 설치 폴더 아래 bin 경로가 들어 있는지 확인
• 맥·리눅스: 터미널에서 which cursor를 실행해 경로가 나오는지 확인. 아무것도 안 나오면 등록이 안 된 상태
• 맥에서 zsh 사용 중: ~/.zshrc에 경로가 추가됐는지 확인하고, source ~/.zshrc로 다시 불러오기

이 명령어가 왜 필요한지도 알아두면 좋아요. 탐색기에서 폴더를 찾아 들어가 우클릭하는 대신, 터미널에서 해당 폴더로 이동한 뒤 cursor . 한 줄이면 그 폴더가 바로 열려요. 점(.)은 “지금 이 폴더”를 뜻합니다. Git이나 다른 명령줄 도구와 함께 쓸 때 작업 흐름이 훨씬 매끄러워져요.

무료로 어디까지 쓸 수 있나요?

Cursor는 무료 요금제와 유료 요금제로 나뉘고, 처음 가입하면 유료 기능을 일정 기간 체험할 수 있는 구조로 운영돼 왔어요. 다만 요금제 이름, 월 요청 한도, 체험 기간, 학생 할인 조건은 정책에 따라 바뀌는 항목이라 특정 숫자를 여기서 못 박기는 어렵습니다.

가장 정확한 건 공식 요금제 페이지예요. 로그인한 뒤 계정 대시보드로 들어가면 현재 내 요금제와 남은 사용량이 표시되니, 결제 전에 이 화면을 먼저 확인하는 걸 권합니다.

대신 요금제를 볼 때 어디를 봐야 하는지는 정리해둘 수 있어요.

입문자라면 결제부터 하지 말고 무료 범위에서 며칠 써보길 권해요. 간단한 HTML 페이지 하나를 만들어보면 이 도구가 내 작업 방식과 맞는지 금세 감이 옵니다.

설치가 실패하거나 실행이 안 될 때 점검 순서

설치가 매끄럽지 않을 때는 원인을 하나씩 좁혀가는 게 빨라요. 자주 나오는 유형별로 정리했습니다.

• 다운로드가 중간에 끊긴다 → 브라우저를 바꿔 다시 받아보세요. 사내망이나 공용 와이파이에서 특정 도메인이 차단된 경우도 있어요.
• 설치 파일 실행이 막힌다 → 백신이나 윈도우 보안 기능이 차단한 경우가 많아요. 차단 기록을 확인하고 신뢰할 수 있는 파일로 허용한 뒤 다시 실행합니다.
• 실행하면 흰 화면만 뜬다 → 그래픽 가속 문제일 수 있어요. 완전히 종료 후 재실행, 그래도 같다면 그래픽 드라이버를 최신으로 올려보세요.
• 로그인 후 화면이 안 넘어간다 → 브라우저에서 인증은 됐는데 에디터가 대기 상태라면, 에디터 종료 후 재실행하고 다시 로그인해보세요.
• 업데이트가 계속 실패한다 → 권한 문제일 가능성이 커요. 리눅스 AppImage는 새 파일로 교체, 윈도우는 프로그램을 완전히 종료한 뒤 다시 시도합니다.
• AI 응답이 오지 않는다 → 로그인 상태와 요금제 사용량을 먼저 확인하세요. 방화벽이 외부 통신을 막고 있는 경우도 있어요.

여러 방법을 시도해도 안 되면 완전 삭제 후 재설치가 가장 확실해요. 이때 프로그램만 지우면 예전 설정이 그대로 남아 같은 문제가 반복될 수 있어요. 사용자 설정 폴더까지 정리해야 진짜 초기 상태로 돌아갑니다.

사용자 데이터가 저장되는 위치는 운영체제마다 달라요. 윈도우는 사용자 폴더 아래 AppData\Roaming, 맥은 라이브러리 폴더 아래 Application Support, 리눅스는 홈 디렉터리의 .config 아래에 프로그램 이름으로 된 폴더가 생깁니다. 확장 프로그램은 홈 디렉터리 아래 별도의 확장 폴더에 저장돼요.

재설치를 마쳤다면 정상 동작을 확인하는 순서는 이렇습니다. 프로그램 실행 → 로그인 상태 확인 → 아무 폴더나 열기 → 텍스트 파일 하나 만들어 저장 → AI 패널에서 짧은 질문 하나 던져 응답 확인. 여기까지 되면 설치는 문제없어요.

Claude Code를 쓰다가 Cursor를 같이 켜게 된 이유

이미 Claude Code 같은 터미널 기반 AI 도구를 쓰고 있는데 왜 Cursor를 또 설치하냐는 질문이 나올 만해요. 답은 두 도구가 잘하는 영역이 다르기 때문입니다.

터미널 기반 도구는 “이 프로젝트 전체를 이렇게 바꿔줘” 같은 큰 단위 작업에 강해요. 여러 파일을 한꺼번에 훑고 수정하는 흐름이 자연스럽죠. 대신 결과를 눈으로 확인하려면 파일을 따로 열어봐야 해요.

Cursor는 반대예요. 코드가 화면에 보이는 상태에서 특정 줄을 드래그하고 “이 부분만 이렇게 고쳐줘”라고 말하는 흐름이 편합니다. 어디가 바뀌었는지 색으로 표시돼서, 코드를 잘 모르는 입장에서는 이 시각적 확인이 심리적으로 큰 차이를 만들어요. 수락과 되돌리기를 버튼으로 처리할 수 있다는 점도 부담을 줄여줍니다.

정리하면 이런 식으로 나눠 쓰는 조합이 실용적이에요.

설치 직후 첫인상은 “VSCode인데 옆에 대화창이 하나 더 있는 프로그램”에 가까워요. 처음 켜면 화면이 복잡해 보이지만, 실제로 쓰는 건 파일 목록, 코드 창, 오른쪽 AI 패널 세 곳이 전부예요. 나머지 아이콘은 필요할 때 하나씩 알아가도 늦지 않습니다.

설치를 마쳤다면 다음 할 일은 명확해요. 빈 폴더를 하나 열고 index.html 파일을 만든 뒤, AI 패널에 “간단한 자기소개 페이지를 만들어줘”라고 한국어로 요청해보세요. 결과가 나오면 브라우저로 열어 확인하고, 마음에 안 드는 부분을 다시 말로 고치는 흐름이 곧 바이브코딩의 기본 루프입니다.

자주 묻는 질문

VSCode를 지우고 Cursor를 설치해야 하나요?

지울 필요 없어요. 두 프로그램은 서로 독립적이라 같은 컴퓨터에 함께 두고 번갈아 써도 문제가 없습니다. 오히려 처음에는 둘 다 두고 비교해보는 편이 좋아요. 설정과 확장은 Cursor 첫 실행 때 가져오기로 복사되므로 VSCode 환경은 그대로 유지됩니다.

Cursor는 어느 폴더에 설치되나요?

운영체제마다 달라요. 윈도우는 사용자 계정 폴더 아래 AppData\Local\Programs 경로, 맥은 응용 프로그램 폴더, 리눅스 deb 설치는 시스템의 공유 프로그램 경로에 들어갑니다. 사용자 설정과 확장은 프로그램 폴더가 아니라 별도의 사용자 데이터 폴더에 저장되니, 완전 삭제할 때는 두 곳을 모두 확인해야 해요.

한국어로 질문해도 잘 알아듣나요?

네, 한국어로 요청해도 코드를 잘 생성합니다. 다만 “예쁘게 만들어줘” 같은 모호한 표현보다 “제목은 가운데 정렬, 배경은 흰색, 버튼은 둥근 모서리로”처럼 구체적으로 적을수록 결과가 정확해져요. 파일 이름이나 함수 이름 같은 코드 관련 단어는 영문 그대로 쓰는 게 오해가 적습니다.

인터넷이 끊기면 사용할 수 없나요?

AI 기능은 인터넷 연결이 있어야 동작해요. 모델이 외부 서버에서 실행되기 때문입니다. 다만 코드 편집기 자체는 오프라인에서도 열리고 파일 저장도 되니, 작성해둔 코드를 읽거나 고치는 작업은 문제없이 할 수 있어요.

설치 후 업데이트는 자동으로 되나요?

윈도우와 맥은 새 버전이 나오면 알림이 뜨고 재시작으로 적용되는 방식이 일반적이에요. 리눅스는 설치 방식에 따라 달라서, AppImage는 새 파일을 직접 받아 교체해야 하고 deb 패키지는 새 패키지를 받아 다시 설치합니다. 업데이트 후 확장이 어긋나 보이면 프로그램을 한 번 완전히 종료했다 켜보세요.

참고자료

• Cursor 공식 홈페이지 — 운영체제별 최신 설치 파일 다운로드와 요금제 안내
• Cursor 공식 문서 — 설치, 초기 설정, 기능별 사용법과 문제 해결 안내
• Visual Studio Code 공식 문서 — 에디터 기본 조작과 확장·언어팩 설정 참고
• Ubuntu 공식 튜토리얼 — 리눅스에서 패키지 설치와 권한 설정 기초 확인

Cursor 설치에서 발목을 잡는 건 설치 파일 자체가 아니라, VSCode 확장으로 착각하거나 한글 설정과 터미널 명령어에서 멈추는 지점이에요. 이 글의 순서대로 다운로드 → 실행 → 로그인 → 설정 가져오기 → 한국어 언어팩 → 폴더 열기까지 따라오면 그 지점들은 대부분 지나갑니다.

설치를 마쳤다면 다음 순서를 권해요. 첫날은 빈 폴더에 HTML 파일 하나 만들어 AI에게 말 걸어보기, 둘째 날은 만든 페이지를 조금씩 고쳐보기, 셋째 날부터 실제로 만들고 싶은 걸 시작하기. 도구를 완벽히 익히고 시작하려 하면 오히려 첫 발이 늦어져요.

중간에 막히면 오류 메시지를 그대로 복사해 AI 패널에 붙여넣고 물어보는 것도 좋은 방법이에요. 설치와 세팅 단계의 문제는 대부분 이미 답이 나와 있는 것들이니까요.

함께 보면 좋은 글

• 워드프레스 플러그인 설정 방법 7단계, 설치 후 꼭 눌러야 할 것만
• 네이버 블로그 수익화, 정말 될까? 애드포스트 현실과 내 도메인으로 넘어가는 순서