커서 설치 2026: 맥·윈도우·리눅스별 6단계 순서와 막힐 때 해결법까지 한 번에 따라 하기
퀀텀점프클럽 정상록14분 읽기1 views커서 설치 2026: 맥·윈도우·리눅스별 6단계 순서와 막힐 때 해결법까지 한 번에 따라 하기
커서: Cursor(커서, AI가 코드를 짜주는 편집기)는 컴퓨터에 설치해서 쓰는 앱이에요. VS Code(비주얼 스튜디오 코드, 마이크로소프트의 무료 코드 편집기)를 바탕으로 만들어져서 화면이 비슷하고, 옆 패널의 에이전트(스스로 판단해 작업을 처리하는 AI)에게 말로 일을 시킬 수 있어요.
커서는 무엇이고 설치 전에 무엇이 필요한가요?
커서 공식 도움말은 설치 안내를 이렇게 시작해요.
"Get Cursor running on your machine in under five minutes."
내 컴퓨터에서 커서를 5분이 안 걸려 실행할 수 있다는 안내예요.
준비물은 둘이에요. 하나는 컴퓨터가 요구 사양을 넘는지 확인하는 것이고, 다른 하나는 커서 계정이에요. 계정은 cursor.com에서 무료로 만들 수 있어요.
커서 공식 Quickstart에 따르면 운영체제별 요구 사양은 아래와 같아요.
| 운영체제 | 요구 사양 | 설치 파일 |
|---|---|---|
| 맥 | macOS 12(Monterey) 이상, Apple Silicon과 Intel 모두 지원 | .dmg |
| 윈도우 | Windows 10 이상 | .exe |
| 리눅스 | apt·dnf 패키지 또는 AppImage | 아래 리눅스 절 참고 |
공식 도움말이 정리한 전체 설치 순서는 6단계예요. 운영체제가 달라도 앞뒤 단계는 같고, 4번만 달라져요.
- 브라우저로 cursor.com/download에 들어가요. 공식 주소에서 받아야 엉뚱한 설치 파일을 피할 수 있어요.
- 내 운영체제에 맞는 다운로드 버튼을 눌러요. 맥용과 윈도우용 파일이 서로 달라서 필요한 단계예요.
- 내려받은 파일을 열어요. 설치가 여기서 시작되기 때문이에요.
- 운영체제별 설치를 해요. 아래 세 절에서 따로 설명해요.
- 설치된 커서 앱을 열어요.
- 로그인해요. 로그인해야 에이전트 같은 AI 기능을 쓸 수 있어요.
맥에는 어떻게 설치하나요?
macOS 12 이상이면 어떤 맥이든 됩니다. 칩이 Apple Silicon(애플이 만든 맥용 칩)이어도 Intel이어도 같은 방법으로 설치해요.
- 위 공통 순서의 1~3번을 해서 .dmg 파일을 열어요. 이 파일이 설치 꾸러미 역할을 해요.
- 열린 창에서 Cursor 아이콘을 Applications(응용 프로그램) 폴더로 끌어다 놓아요. 앱이 Applications 폴더에 들어가 있어야 나중에 찾기 쉬워요.
- Applications 폴더의 Cursor를 열어요. 이게 공통 순서의 5번, 앱 열기예요.
만약 "Cursor is damaged"라는 경고가 뜨면 아래 「처음 하면 여기서 막힙니다」 절의 첫 항목을 보세요. 파일이 깨진 게 아니라서 해결이 쉬워요.
윈도우에는 어떻게 설치하나요?
Windows 10 이상이면 설치할 수 있어요. 윈도우는 맥보다 단순해서 공통 6단계 중 4번이 이 한 줄이에요. 내려받은 .exe 설치 프로그램을 실행하고, 화면 안내를 따라가는 거예요.
- 공통 순서의 1~3번으로 .exe 파일을 받아 더블클릭해요. 설치 프로그램이 이때 시작돼요.
- 화면에 나오는 안내를 따라 진행해요. 공식 도움말도 설치 프로그램의 안내를 따르라고 적었어요.
- 설치가 끝나면 Cursor 앱을 열어요. 공통 순서의 5번이에요.
앱이 시작할 때 빈 화면만 나오면 윈도우는 관리자 권한으로 실행하는 방법이 있어요. 자세한 순서는 아래 막히는 지점 절에 있어요.
리눅스에는 어떻게 설치하나요?
리눅스는 설치 방법이 두 가지예요. 패키지 관리자(프로그램 설치와 업데이트를 대신 해 주는 도구)로 설치하는 방법과, AppImage(설치 없이 바로 실행하는 리눅스용 프로그램 파일)를 쓰는 방법이에요. 패키지로 깔면 CLI(명령어를 타이핑해서 쓰는 까만 화면 프로그램) 도구까지 함께 들어와요. 공식 Quickstart는 이렇게 권해요.
"The apt and yum packages are preferred over AppImage. They provide desktop icons, automatic updates, and CLI tools."
apt와 yum 패키지가 AppImage보다 낫다는 말이에요. 바탕화면 아이콘, 자동 업데이트, 그리고 CLI 도구를 같이 주기 때문이래요. 그래서 데비안이나 우분투 계열이면 apt를 먼저 고르세요.
apt 설치는 4단계로 이어져요.
- 커서 저장소(프로그램을 내려받는 서버 주소)의 서명 확인용 GPG 키를 추가해요. 내려받는 프로그램이 진짜 커서 것인지 검증하는 데 필요해요.
- 커서 저장소를 시스템에 등록해요. 이걸 해야 apt가 커서를 찾을 수 있어요.
- 아래 첫 줄 명령으로 설치 목록을 새로 고쳐요.
- 아래 둘째 줄 명령으로 커서를 설치해요.
1, 2번에 쓰는 명령은 길어서 여기 옮기지 않았어요. 공식 Quickstart 문서에서 복사해 쓰세요. 3, 4번은 이 두 줄이에요. 앞은 목록 새로 고침이고 뒤는 설치예요.
sudo apt update
sudo apt install cursor
AppImage를 쓴다면 아래 두 줄을 차례로 실행해요. 첫 줄은 받은 파일에 실행 권한을 주고, 둘째 줄은 그 파일을 실행해요. 권한을 주지 않으면 파일이 열리지 않아요.
chmod +x Cursor-*.AppImage
./Cursor-*.AppImage
설치한 뒤 처음 무엇을 하나요?
설치가 끝났다면 3단계만 하면 첫 화면이 열려요.
- 커서를 열면 로그인 안내가 떠요. 안내에 따라 로그인하세요. 로그인해야 AI 기능이 켜져요.
- 상단 메뉴에서 File > Open Folder를 골라 작업할 폴더를 열어요. 에이전트가 일할 대상 폴더를 알려 주는 단계예요.
- 맥은 Cmd+I, 윈도우와 리눅스는 Ctrl+I를 눌러 에이전트 패널을 열어요. 에이전트가 이 패널에서 대화하며 일하기 때문이에요.
커서 공식 도움말은 에이전트를 이렇게 소개해요.
"Agent is Cursor's AI assistant. It can search your codebase, edit files, and run terminal commands."
에이전트는 커서의 AI 조수라는 뜻이에요. 작업 폴더의 코드를 검색하고, 파일을 고치고, 터미널(글자로 컴퓨터에 명령을 내리는 창) 명령도 대신 실행해요. 에이전트가 고친 내용은 diff(바뀐 부분을 나란히 보여 주는 비교 화면)에 나오고, 마음에 들지 않으면 거절할 수 있어요.
설치 이후의 사용법은 이 글에서 더 다루지 않아요. 에이전트와 Tab 자동완성, 규칙 설정은 커서 사용법 2026 글에 따로 정리해 두었어요.
VS Code를 쓰던 사람은 설정을 옮길 수 있나요?
네, 한 번에 옮길 수 있어요. 커서 공식 문서에는 이런 문장이 있어요.
"Cursor is based upon the VS Code codebase, allowing us to focus on making the best AI-powered coding experience while maintaining a familiar editing environment."
커서가 VS Code를 바탕으로 만들어졌고, 그래서 익숙한 편집 환경을 그대로 유지한다는 뜻이에요. 단축키도 VS Code와 같은 기본값을 써요.
가져오는 방법은 아래 순서예요.
- Cmd+Shift+J(윈도우와 리눅스는 Ctrl+Shift+J)로 Cursor Settings를 열어요. 설정 화면의 위치를 먼저 찾아야 해요.
- General > Account로 들어가요. 가져오기 버튼이 이 안에 있어요.
- VS Code Import 항목의 Import 버튼을 눌러요. 이 버튼 하나로 옮기기가 끝나요.
커서 공식 도움말에 따르면 이때 4가지가 넘어와요. 확장(extensions, 편집기에 기능을 더하는 추가 프로그램), 테마, 설정, 키 설정이에요.
한 가지 주의할 점이 있어요. 커서는 확장을 VS Code Marketplace가 아니라 Open VSX라는 다른 확장 저장소에서 가져와요. 공식 도움말은 인기 확장은 많지만 VS Code의 모든 확장이 있거나 똑같이 동작하지는 않는다고 적었어요. 그래서 안 보이는 확장이 있어도 설치가 잘못된 게 아니에요.
커서와 VS Code는 별개의 앱이라서, 둘 다 설치해 같은 프로젝트를 열어도 돼요.
커서는 어떻게 업데이트하나요?
대부분은 자동으로 업데이트돼요. 수동으로 하고 싶다면 방법은 2단계예요.
- Cmd+Shift+P(윈도우와 리눅스는 Ctrl+Shift+P)로 명령 팔레트(기능 이름을 검색해서 실행하는 창)를 열어요.
- "Cursor: Attempt Update"를 검색해 실행하고, 안내에 따라 재시작해요. 재시작해야 새 버전이 적용돼요.
업데이트 채널은 Stable(안정판)과 Early Access(최신 기능을 먼저 쓰는 대신 덜 안정적일 수 있는 판)가 있어요. 공식 도움말은 대부분 Stable을 권해요.
주의할 점은 버전이 너무 오래되면 커서가 멈춘다는 거예요. 공식 도움말에 따르면 새 버전이 나온 지 보통 약 2개월이 지나면 업데이트하라는 경고가 뜨기 시작해요. 약 3개월이 지나면 최소 허용 버전 아래로 내려가서 에이전트 요청이 "Update Required" 오류로 실패해요. 날짜는 바뀔 수 있다고 공식 도움말이 밝혔어요.
이 오류가 나도 걱정은 없어요. cursor.com/download에서 최신 버전을 받아 기존 앱 위에 설치하면 설정과 채팅 기록이 그대로 남는대요.
자동 업데이트가 꺼진 경우도 있어요. 설정의 update.mode가 none이나 manual이면 자동으로 안 되니, 위의 수동 방법을 쓰세요.
요금은 Free 요금제가 월 0달러이고, 에이전트와 채팅 요청에 제한이 있어요. 유료 요금제의 가격은 바뀔 수 있으니 커서 공식 요금제 페이지에서 확인하세요.
처음 하면 여기서 막힙니다
모두 커서 공식 문제 해결 문서에 적힌 증상과 해결법이에요.
macOS에서 "Cursor is damaged" 경고가 떠요
공식 도움말은 이렇게 못 박아요.
"This is a macOS issue, not a corrupted download."
다운로드가 깨진 게 아니라 macOS 쪽 문제라는 뜻이에요. 그러니 파일을 의심하지 말고 아래 순서로 해 보세요.
- 커서를 완전히 종료하고, 활동 모니터에서 남아 있는 Cursor 프로세스를 강제 종료해요. 1분쯤 기다렸다가 다시 열어요.
- 계속되면 앱을 휴지통으로 옮기고 휴지통을 비운 뒤, cursor.com/download에서 새로 받아요.
- 그래도 뜨면 맥을 재시동하고 다시 열어요.
시작할 때 빈 화면만 나와요
- 커서를 껐다가 다시 켜요.
- 그대로면 맥은 앱을 휴지통으로 옮기고 cursor.com/download에서 다시 설치해요. 윈도우는 관리자 권한으로 실행해요.
- 그다음 완전 종료한 뒤 다시 열어요. 맥은 Cmd+Q, 윈도우와 리눅스는 작업 표시줄 트레이(화면 구석의 작은 아이콘 영역)에서 종료해요.
회사나 학교 네트워크에서 AI가 안 돼요
회사 프록시(인터넷 연결을 중간에서 걸러 주는 서버, 예를 들어 Zscaler)가 HTTP/2 연결을 막으면 AI 기능이 멈출 수 있어요. 공식 도움말의 해결법은 이래요.
- Cursor Settings > Network로 들어가요.
- HTTP Compatibility Mode를 HTTP/1.1로 바꿔요. 프록시가 막는 HTTP/2 대신 HTTP/1.1로 연결하는 설정이에요.
- 커서를 재시작해요.
원인이 헷갈리면 같은 화면의 Run Diagnostics로 네트워크를 먼저 진단해 보세요.
VPN을 켜면 "suspicious activity" 메시지가 떠요
이 메시지는 보안 차단이고, VPN(내 인터넷 연결을 다른 곳으로 우회시키는 서비스)이 원인일 수 있다고 공식 도움말이 안내해요.
- VPN을 끄세요.
- 새 채팅을 열어요.
- 몇 분 뒤에 다시 시도해요.
- 그래도 안 되면 다른 로그인 방식으로 바꿔 보세요. 구글이나 GitHub(깃허브, 개발자들이 코드를 올려두는 공간) 계정 같은 방식이에요.
"Update Required" 오류가 떠요
버전이 너무 오래된 것이 원인이에요. 위 「커서는 어떻게 업데이트하나요?」 절의 순서대로 cursor.com/download에서 최신 버전을 기존 앱 위에 설치하세요. 설정과 채팅 기록은 남아요.
VS Code 확장이 안 보여요
커서는 Open VSX 저장소를 쓰기 때문에 VS Code에 있던 확장이 없을 수 있어요. 검색해서 없으면 같은 기능의 다른 확장을 찾아보세요.
로그인 화면 주소가 바뀌었어요
로그인 페이지가 accounts.spacexsi.com으로 옮겨 가는 중이에요. 개인 사용자는 기존 로그인이 유지되어 로그아웃되지 않아요. 회사 방화벽이나 허용 목록이 이 주소를 막으면 IT 담당자에게 도메인 추가를 요청하세요. 회사 네트워크가 새 주소를 막고 있을 때 옛 로그인 페이지로 돌아가던 임시 대체 경로(폴백)는 11월 30일에 끝나요.
마무리
커서 설치는 공식 6단계를 따라가면 되고, 막히는 곳도 대부분 공식 문서에 해결법이 있어요. 설치와 로그인, 폴더 열기까지 끝냈다면 이제 에이전트에게 일을 시킬 차례예요. 다음 단계는 커서 사용법 2026 글에서 이어서 보세요.
자주 묻는 질문
커서 설치에 얼마나 걸리나요?
커서 공식 도움말은 설치를 5분 이내로 안내해요. 로그인과 폴더 열기까지 포함하면 20분 정도 잡으면 넉넉해요.
커서는 무료로 설치할 수 있나요?
네, 설치 자체는 무료이고 Free 요금제는 월 0달러예요. 에이전트와 채팅 요청에는 제한이 있어요. 유료 요금제 가격은 공식 요금제 페이지에서 확인하세요.
맥에서 "Cursor is damaged" 경고가 뜨면 어떻게 하나요?
공식 도움말은 다운로드가 깨진 게 아니라 macOS 문제라고 말해요. 커서와 남은 프로세스를 종료하고 1분 뒤 다시 열어 보세요. 계속되면 휴지통으로 옮겨 새로 받고, 그래도 안 되면 맥을 재시동해요.
회사 컴퓨터에서 AI가 응답하지 않으면 어떻게 하나요?
회사 프록시가 HTTP/2를 막는 경우가 있어요. Cursor Settings > Network에서 HTTP Compatibility Mode를 HTTP/1.1로 바꾸고 재시작해 보세요.
오래된 버전에서 "Update Required"가 뜨면 설정이 지워지나요?
지워지지 않아요. cursor.com/download에서 최신 버전을 기존 앱 위에 설치하면 설정과 채팅 기록이 그대로 남는다고 공식 도움말이 안내해요.
VS Code 설정을 커서로 가져올 수 있나요?
가져올 수 있어요. Cursor Settings의 General > Account에서 VS Code Import의 Import 버튼을 누르면 확장, 테마, 설정, 키 설정 4가지가 넘어와요. 다만 확장은 Open VSX 저장소 기준이라 일부는 없을 수 있어요.
