Windows, Mac 및 Linux에 Cursor 설치하는 방법 (2026)
모든 플랫폼을 위한 단계별 설치 가이드
Hypereal로 구축 시작하기
단일 API를 통해 Kling, Flux, Sora, Veo 등에 액세스하세요. 무료 크레딧으로 시작하고 수백만으로 확장하세요.
신용카드 불필요 • 10만 명 이상의 개발자 • 엔터프라이즈 지원
Windows, Mac 및 Linux에서 Cursor 설치하는 방법 (2026)
Cursor는 Claude, GPT-4o 및 기타 최첨단 모델을 코딩 워크플로우에 직접 통합한 VS Code 기반의 AI 지원 코드 에디터입니다. 네이티브 설치 프로그램을 통해 세 가지 주요 운영 체제를 모두 지원합니다.
이 가이드에서는 Windows, macOS, Linux에 Cursor를 설치하고, VS Code 설정을 가져오며, 첫 번째 AI 보조 코딩 세션을 시작하는 방법을 안내합니다.
시스템 요구 사양
| 요구 사항 | Windows | macOS | Linux |
|---|---|---|---|
| OS 버전 | Windows 10+ (64-bit) | macOS 12 (Monterey)+ | Ubuntu 20.04+, Fedora 36+ 또는 유사 버전 |
| RAM | 최소 4 GB, 8 GB 권장 | 최소 4 GB, 8 GB 권장 | 최소 4 GB, 8 GB 권장 |
| 디스크 공간 | 약 500 MB | 약 500 MB | 약 500 MB |
| 아키텍처 | x64 또는 ARM64 | Intel 또는 Apple Silicon | x64 또는 ARM64 |
| 인터넷 | AI 기능 사용 시 필수 | AI 기능 사용 시 필수 | AI 기능 사용 시 필수 |
macOS에 Cursor 설치하기
방법 1: 직접 다운로드 (권장)
- cursor.com에 접속합니다.
- Download for Mac을 클릭합니다.
- 사이트에서 아키텍처(Intel 또는 Apple Silicon)를 자동으로 감지합니다.
- 감지가 되지 않을 경우, 칩 유형을 수동으로 선택하세요.
- 다운로드한
.dmg파일을 엽니다. - Cursor 아이콘을 Applications 폴더로 드래그합니다.
- Applications에서 Cursor를 엽니다 (또는 Spotlight: Cmd + Space 후 "Cursor" 입력).
- 처음 실행 시, macOS에서 인터넷에서 다운로드한 앱을 열 것인지 확인을 요청할 수 있습니다. **열기(Open)**를 클릭합니다.
방법 2: Homebrew
brew install --cask cursor
추후 업데이트 시:
brew upgrade --cask cursor
방법 3: 특정 아키텍처용 수동 다운로드
자동 감지가 잘못된 아키텍처를 선택하는 경우:
# Mac의 아키텍처 확인
uname -m
# arm64 = Apple Silicon (M1/M2/M3/M4)
# x86_64 = Intel
Cursor 웹사이트에서 아키텍처를 수동으로 선택하여 올바른 버전을 다운로드하세요.
macOS 설치 후 설정
PATH에 Cursor 추가 (터미널 명령):
- Cursor를 엽니다.
- Cmd + Shift + P를 눌러 Command Palette를 엽니다.
- "Shell Command: Install 'cursor' command in PATH"를 입력합니다.
- 해당 항목을 선택합니다.
이제 터미널에서 프로젝트를 열 수 있습니다:
cursor /path/to/your/project
cursor . # 현재 디렉토리 열기
Windows에 Cursor 설치하기
방법 1: 직접 다운로드 (권장)
- cursor.com에 접속합니다.
- Download for Windows를 클릭합니다.
- 다운로드한
.exe설치 프로그램을 실행합니다. - 설치 마법사를 따릅니다:
- 설치 디렉토리 선택 (기본값 권장)
- PATH에 Cursor를 추가할지 선택 (권장: 예)
- 우클릭 컨텍스트 메뉴에 "Open with Cursor"를 추가할지 선택 (권장: 예)
- Install을 클릭하고 완료될 때까지 기다립니다.
- 시작 메뉴나 바탕 화면 바로가기에서 Cursor를 실행합니다.
방법 2: Winget
winget install Anysphere.Cursor
업데이트 시:
winget upgrade Anysphere.Cursor
방법 3: Scoop
scoop bucket add extras
scoop install cursor
Windows 설치 후 설정
PATH 통합 확인:
# PowerShell을 열고 다음을 입력합니다:
cursor --version
작동하지 않는 경우, 수동으로 PATH에 Cursor를 추가하세요:
- 시스템 속성 > 환경 변수를 엽니다.
- 사용자 변수에서
Path를 찾아 편집을 클릭합니다. - Cursor 설치 디렉토리를 추가합니다 (일반적으로
C:\Users\{사용자이름}\AppData\Local\Programs\cursor).
Windows 터미널에 추가 (선택 사항):
// Windows 터미널 settings.json 프로필에 추가
{
"name": "Cursor Terminal",
"commandline": "cursor --new-window",
"icon": "C:\\path\\to\\cursor\\icon.png"
}
Linux에 Cursor 설치하기
방법 1: AppImage (범용, 권장)
AppImage는 모든 Linux 배포판에서 작동합니다:
- cursor.com에서 Download for Linux를 클릭합니다.
.AppImage파일을 다운로드합니다.- 실행 권한을 부여하고 실행합니다:
# 실행 권한 부여
chmod +x Cursor-*.AppImage
# 직접 실행
./Cursor-*.AppImage
# 또는 표준 위치로 이동
sudo mv Cursor-*.AppImage /usr/local/bin/cursor
cursor # 어디서나 실행 가능
방법 2: .deb 패키지 (Ubuntu/Debian)
# cursor.com에서 .deb 패키지를 다운로드한 후 설치:
sudo dpkg -i cursor_*.deb
# 의존성 문제 해결
sudo apt-get install -f
방법 3: .rpm 패키지 (Fedora/RHEL)
# cursor.com에서 .rpm 패키지를 다운로드한 후 설치:
sudo rpm -i cursor_*.rpm
# 또는 dnf 사용:
sudo dnf install cursor_*.rpm
방법 4: Snap (Ubuntu)
sudo snap install cursor --classic
방법 5: Flatpak
# Flathub에서 Cursor 검색
flatpak search cursor
flatpak install flathub com.cursor.Cursor
Linux 설치 후 설정
데스크톱 엔트리 생성 (AppImage 사용 시):
mkdir -p ~/.local/share/applications
# ~/.local/share/applications/cursor.desktop
[Desktop Entry]
Name=Cursor
Comment=AI-powered code editor
Exec=/usr/local/bin/cursor %F
Icon=cursor
Type=Application
Categories=Development;IDE;
MimeType=text/plain;inode/directory;
StartupWMClass=Cursor
셸 명령 추가:
- Cursor를 엽니다.
- Ctrl + Shift + P를 누릅니다.
- "Shell Command: Install 'cursor' command in PATH"를 입력합니다.
- 해당 항목을 선택합니다.
VS Code 설정 가져오기
Cursor는 VS Code를 기반으로 제작되었으므로 마이그레이션이 매우 간편합니다.
자동 가져오기 (첫 실행 시)
Cursor를 처음 열면 VS Code 구성을 가져올지 묻는 창이 뜹니다:
- 온보딩 과정에서 Import from VS Code를 선택합니다.
- Cursor가 다음 항목들을 복사합니다:
- 확장 프로그램 (Extensions)
- 설정 (settings.json)
- 키 바인딩 (Keybindings)
- 스니펫 (Snippets)
- 테마 (Themes)
수동 가져오기
온보딩 단계를 건너뛴 경우, 수동으로 가져올 수 있습니다:
설정:
# macOS
cp ~/Library/Application\ Support/Code/User/settings.json \
~/Library/Application\ Support/Cursor/User/settings.json
# Linux
cp ~/.config/Code/User/settings.json \
~/.config/Cursor/User/settings.json
# Windows (PowerShell)
Copy-Item "$env:APPDATA\Code\User\settings.json" `
"$env:APPDATA\Cursor\User\settings.json"
확장 프로그램:
# VS Code 확장 프로그램 목록 내보내기
code --list-extensions > vscode-extensions.txt
# 각 확장 프로그램을 Cursor에 설치
while read ext; do cursor --install-extension "$ext"; done < vscode-extensions.txt
키 바인딩:
# macOS
cp ~/Library/Application\ Support/Code/User/keybindings.json \
~/Library/Application\ Support/Cursor/User/keybindings.json
# Linux
cp ~/.config/Code/User/keybindings.json \
~/.config/Cursor/User/keybindings.json
첫 실행 설정
1단계: 계정 생성
- Cursor를 엽니다.
- 우측 상단의 Sign In을 클릭합니다.
- 다음 중 하나로 계정을 생성합니다:
- 이메일
- GitHub
- 자동으로 무료 Hobby 플랜이 적용됩니다.
2단계: AI 설정 구성
- Cmd/Ctrl + , 를 눌러 설정을 엽니다.
- "Cursor"를 검색하여 AI 관련 설정을 확인합니다.
- 주요 권장 설정:
| 설정 | 권장 값 | 설명 |
|---|---|---|
| Default model | Claude Sonnet | 속도와 품질의 가장 좋은 균형 |
| Auto-suggestions | 사용(Enabled) | 타이핑 중 AI 완성 기능 표시 |
| Privacy mode | 해제(Off) (민감한 경우 On) | 설정 시 코드가 서버에 저장되지 않음 |
| Agent mode | 사용(Enabled) | 다중 파일 자율 편집 허용 |
3단계: 첫 번째 AI 명령 시도하기
- 프로젝트 폴더를 엽니다.
- Cmd/Ctrl + L을 눌러 AI 채팅 패널을 엽니다.
- "이 프로젝트가 무엇을 하는지 설명해줘"라고 입력합니다.
- Cursor가 프로젝트 파일을 읽고 답변합니다.
기타 상호작용 방법:
Cmd/Ctrl + K → 인라인 편집 (먼저 코드 선택)
Cmd/Ctrl + L → 채팅 패널
Cmd/Ctrl + I → Composer (다중 파일 편집)
Tab → Cursor Tab 제안 수락
Cursor 업데이트하기
Cursor는 기본적으로 자동 업데이트됩니다. 수동으로 확인하려면:
모든 플랫폼:
- Cursor를 엽니다.
- Help > Check for Updates로 이동합니다 (macOS의 경우 Cursor > Check for Updates).
- 업데이트가 있으면 Download Update를 클릭합니다.
- Cursor를 재시작하여 적용합니다.
패키지 관리자 사용 시:
# macOS (Homebrew)
brew upgrade --cask cursor
# Windows (Winget)
winget upgrade Anysphere.Cursor
# Linux (Snap)
sudo snap refresh cursor
Cursor 삭제하기
macOS
# 애플리케이션 삭제
rm -rf /Applications/Cursor.app
# 사용자 데이터 삭제 (선택 사항)
rm -rf ~/Library/Application\ Support/Cursor
rm -rf ~/Library/Caches/Cursor
Windows
- 설정 > 앱 > 설치된 앱으로 이동합니다.
- Cursor를 찾아 제거를 클릭합니다.
- 제거 마법사를 따릅니다.
또는 PowerShell 사용:
winget uninstall Anysphere.Cursor
Linux
# AppImage
rm /usr/local/bin/cursor
# .deb
sudo dpkg --remove cursor
# Snap
sudo snap remove cursor
# 사용자 데이터 삭제 (선택 사항)
rm -rf ~/.config/Cursor
rm -rf ~/.cache/Cursor
문제 해결
| 문제 | 플랫폼 | 해결 방법 |
|---|---|---|
| "Cursor가 손상되었습니다" | macOS | 실행: xattr -cr /Applications/Cursor.app |
| 검은 화면/빈 창 | Linux | 시도: cursor --disable-gpu |
| 높은 CPU 사용량 | 공통 | 사용하지 않는 확장 프로그램 비활성화, 실행 중인 프로세스 확인 |
| 확장 프로그램 로드 안 됨 | 공통 | 캐시 삭제: ~/.config/Cursor/Cache 삭제 |
| 확장 프로그램 설치 불가 | 공통 | 인터넷 연결 확인; 수동 .vsix 설치 시도 |
| PATH에 Cursor 없음 | 공통 | Command Palette에서 "Shell Command: Install 'cursor' command" 실행 |
| 폰트 렌더링 오류 | Linux | 폰트 패키지 설치: sudo apt install fonts-firacode |
| AppImage 실행 안 됨 | Linux | FUSE 설치: sudo apt install libfuse2 |
| 자동 업데이트 실패 | 공통 | cursor.com에서 최신 버전을 수동으로 다운로드 |
자주 묻는 질문 (FAQ)
Cursor와 VS Code를 동시에 실행할 수 있나요? 네. 서로 별개의 애플리케이션이며 충돌하지 않습니다. 초기 가져오기 이후에는 설정 경로의 일부를 공유하더라도 한쪽의 변경이 다른 쪽에 영향을 주지 않습니다.
Cursor는 무료인가요? 네, Cursor는 월 50회의 빠른(fast) AI 요청과 2,000회의 느린(slow) 완성을 제공하는 무료 Hobby 플랜이 있습니다. Pro 플랜은 월 $20입니다.
오프라인에서도 작동하나요? 에디터 자체는 오프라인에서 작동하지만(기반이 VS Code이므로), AI 기능은 인터넷 연결이 필요합니다.
VS Code 확장 프로그램이 Cursor에서 작동하나요? 대부분의 VS Code 확장 프로그램은 같은 기반으로 제작되었기 때문에 Cursor에서 작동합니다. 다만 GitHub Copilot과 같은 일부 Microsoft 전용 확장 프로그램은 라이선스 제한이 있을 수 있습니다.
원격 개발(Remote Development)을 지원하나요? 네. Cursor는 VS Code와 마찬가지로 SSH 원격 개발, WSL 및 Dev Containers를 지원합니다.
마치며
Cursor 설치는 세 가지 플랫폼 모두에서 간단합니다. 가장 어려운 부분은 다양한 설치 방법 중 하나를 선택하는 것입니다. 대부분의 사용자에게는 cursor.com에서 직접 다운로드하는 것이 가장 빠른 방법입니다. 온보딩 시 VS Code 설정을 가져오면 몇 분 안에 AI 기반 코딩 환경을 구축할 수 있습니다.
이미지, 비디오 또는 아바타와 같은 AI 생성 미디어가 필요한 앱을 구축하고 있다면, Hypereal AI를 무료로 체험해 보세요. 카드 등록 없이 35 크레딧이 제공됩니다. API는 Cursor에서 개발 중인 프로젝트와 쉽게 통합됩니다.
