[Cursor] Cursor 설치와 기본 설정: VS Code에서 갈아타는 법

안녕하세요, muaco입니다.

이 글로 무엇을 하게 되는지

이 글을 따라 하면 Cursor 설치부터 프로젝트 규칙 파일 작성까지 한 번에 끝납니다. 중간에는 VS Code에서 쓰던 설정과 확장 프로그램을 옮기고, 일을 맡길 AI 모델도 고릅니다. Cursor란 무엇일까요? 코드를 쓰는 편집기 안에 AI 조수가 함께 앉아 있는 프로그램입니다.

여기까지 마치면 채팅창에 "이 폴더가 무슨 일을 하는지 설명해 줘"라고 물어볼 준비가 됩니다. 아래 내용은 2026년 9월 기준 Cursor 공식 문서를 읽고 정리했습니다.

버전에 따라 화면 문구는 조금씩 달라질 수 있습니다.

미리 챙길 준비물

이 단계에서 걸리면 아래를 다 읽어도 소용이 없습니다. 먼저 확인하고 넘어가세요.

운영체제. 문서가 적어 둔 기준은 macOS 12(몬터레이) 이상, Windows 10 이상입니다. 맥은 애플 실리콘과 인텔 모두 지원됩니다.
리눅스라면. 먼저 저장소를 등록해야 합니다. 데비안·우분투는 apt, RHEL·페도라는 yum 저장소입니다. 입력할 명령은 1단계에 그대로 적어 두었습니다. AppImage 파일도 있지만 문서는 apt·yum 쪽을 권합니다.
계정. 앱을 열면 로그인부터 합니다. 문서에 따르면 Pro 요금제는 월 20달러입니다.
작업할 폴더 하나. 빈 폴더라도 괜찮습니다. Cursor는 폴더 단위로 일하기 때문입니다.
VS Code. 쓰고 있다면 설정 이전이 훨씬 수월합니다. 없어도 설치에는 문제가 없습니다.

따라 하기: 설치부터 규칙 파일까지

1단계. 내려받아 설치합니다

따라 하기

공식 사이트에서 운영체제에 맞는 설치 파일을 받으세요. 맥은 dmg, 윈도우는 exe 형식입니다.
받은 파일을 실행하고 안내대로 진행하면 됩니다. 리눅스라면 설치 파일 대신 터미널을 씁니다. 데비안·우분투는 아래 네 줄을 차례로 입력하세요. 앞의 두 줄은 열쇠 등록과 저장소 등록입니다. 이를 건너뛰면 마지막 줄에서 패키지를 찾지 못합니다.
```
curl -fsSL https://downloads.cursor.com/keys/anysphere.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/cursor.gpg > /dev/null
echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/cursor.gpg] https://downloads.cursor.com/aptrepo stable main" | sudo tee /etc/apt/sources.list.d/cursor.list > /dev/null
sudo apt update
sudo apt install cursor
```
RHEL·페도라는 어떨까요? 저장소 파일을 만든 뒤 sudo dnf install cursor로 설치합니다.
```
sudo tee /etc/yum.repos.d/cursor.repo << 'EOF'
[cursor]
name=Cursor
baseurl=https://downloads.cursor.com/yumrepo
enabled=1
gpgcheck=1
gpgkey=https://downloads.cursor.com/keys/anysphere.asc
EOF
```
이렇게 설치하면 바탕화면 아이콘, 자동 업데이트, 터미널 명령이 함께 따라옵니다.
앱을 열고 로그인한 다음 작업할 폴더를 고르세요. 왼쪽에 파일 목록이 뜨면 여기까지 성공입니다.

2단계. 쓰던 설정을 옮깁니다

따라 하기

먼저 Cursor 설정을 엽니다. 윈도우와 리눅스는 Ctrl+Shift+J, 맥은 Cmd+Shift+J입니다.
General 안의 Account로 들어가면 VS Code Import 항목이 보입니다. Import 단추를 누르면 확장 프로그램, 테마, 설정, 단축키가 한 번에 넘어옵니다.
결과는 눈으로 확인하세요. 테마 색이 쓰던 대로 바뀌고 확장 목록에 익숙한 이름이 보이면 성공입니다.
컴퓨터를 바꾸는 중이거나 더 세밀하게 옮기고 싶을 때는 프로필 내보내기를 씁니다. VS Code 명령 팔레트(Ctrl+Shift+P)에서 "Preferences: Open Profiles (UI)"를 열어 프로필을 내보내세요. 그다음 Cursor의 같은 화면에서 Import Profile을 고르고, GitHub Gist 주소나 내려받은 파일을 올립니다.
넘어오지 않은 확장이 있다면 Ctrl+Shift+X로 확장 패널을 열어 이름으로 찾아보세요.

3단계. 어느 모델에 맡길지 고릅니다

따라 하기

채팅이나 에이전트 패널에서 모델 선택기를 엽니다.
고민된다면 Auto를 고르세요. 요청마다 알맞은 모델을 Cursor Router가 대신 정해 줍니다. 팀·엔터프라이즈 요금제라면 Cost, Balance, Intelligence 중 하나로 성향을 정할 수도 있습니다.
모델은 두 묶음으로 나뉩니다. Cursor Models에는 Grok 4.6, Grok 4.5, Composer 2.5가 있습니다. Other Models에는 Claude 계열, Gemini 계열을 비롯한 여러 외부 모델이 들어 있습니다. Pro라면 두 묶음 모두 쓸 수 있습니다.
모델 선택기 안의 Max Mode는 예전 요청 기반 요금제에서만 켤 수 있습니다. 한 번에 읽는 분량이 늘어나는 대신 모델 API 요율에 20%가 붙습니다.
이제 Cmd I로 에이전트를 열고 "이 코드가 하는 일을 설명해 줘"라고 말을 걸어 보세요. 손이 큰 작업이라면 Shift+Tab으로 Plan Mode를 켜고 계획부터 받아 보는 편이 좋습니다.

4단계. 프로젝트 규칙 파일을 만듭니다

따라 하기

채팅창에 /create-rule을 입력하고 어떤 규칙인지 설명하세요. 사이드바에서 Customize를 눌러 Rules로 들어간 뒤 Add Rule을 눌러도 결과는 같습니다.
파일은 .cursor/rules 폴더 안에 .mdc 확장자로 생깁니다. 확장자를 .md로 저장하면 읽히지 않습니다. 많은 분이 한 번 멈칫하는 지점입니다.

파일 맨 위에는 줄표 세 개(---) 두 줄로 감싼 자리가 있습니다. 이 안에 description, globs, alwaysApply를 적습니다. 실제 생김새는 다음과 같습니다.

--- description: "우리 팀 리액트 컴포넌트 작성 규칙" globs: src/components/**/*.tsx alwaysApply: false ---

컴포넌트는 함수형으로 쓰고, 파일 하나에 하나만 둬요.

특정 파일에만 적용하려면 위 예시처럼 globs에 패턴을 적으세요. 쉼표로 여러 패턴을 나열해도 됩니다.
규칙 하나는 500줄 아래로 유지합니다. 길어지면 주제별로 나누세요. 다른 파일 내용을 통째로 붙여 넣는 대신 @파일명으로 가리키면 됩니다.
다 됐으면 Git에 함께 올립니다. 팀원이 내려받으면 같은 규칙을 그대로 쓰게 됩니다.

규칙이 붙는 순간은 맨 위 세 줄을 어떻게 채우느냐에 달려 있습니다. 문서가 정리해 둔 네 가지 유형은 다음과 같습니다.

유형	언제 붙습니까	설정
Always Apply	모든 대화에 늘 붙습니다	alwaysApply를 true로
Apply Intelligently	AI가 설명을 읽고 관련 있다고 판단할 때	description만 적습니다
Apply to Specific Files	정한 파일 패턴을 건드릴 때	globs만 적습니다
Apply Manually	`@규칙이름`으로 부를 때만	둘 다 비웁니다

여기서 자주 막힙니다

설정을 바꿨는데 적용되지 않습니다. Cursor 설정 화면(Ctrl+Shift+J)과 VS Code 설정 화면은 서로 다른 곳입니다. 어느 쪽을 고쳤는지부터 확인하세요.
왼쪽 아이콘 줄이 가로로 누워 있습니다. AI 채팅 공간을 넓히려고 기본값을 수평으로 둔 결과입니다. 설정에서 workbench.activityBar.orientation을 vertical로 바꾸고 다시 켜 보세요. 예전 모습으로 돌아옵니다.
쓰던 확장이 검색해도 나오지 않습니다. Cursor는 마이크로소프트 마켓플레이스가 아니라 Open VSX 레지스트리를 씁니다. 그곳에 없는 확장은 보이지 않습니다. 자주 쓰이는 몇 가지는 Anysphere가 만든 대체판이 올라와 있습니다. 이름이 같아도 다른 확장일 수 있으니 게시자를 꼭 확인하세요.
규칙 파일이 무시됩니다. 확장자가 .mdc인지, 맨 위 칸이 비어 있지 않은지 살펴보세요. 셋 다 비어 있으면 @이름으로 직접 부를 때만 붙습니다.
최신 VS Code 기능이 보이지 않습니다. 문서에 따르면 Cursor는 안정성을 위해 조금 이전 버전의 VS Code를 기반으로 삼습니다.

여기서 더 나아가려면

규칙을 .mdc로 쓰기 부담스럽다면 프로젝트 루트에 AGENTS.md를 두는 방법도 있습니다. 별도 설정 없이 평범한 마크다운으로 적으면 됩니다.

하위 폴더에 따로 두면 어떻게 될까요? 그 영역을 만질 때만 위쪽 내용과 합쳐져 쓰입니다.

규칙은 처음부터 크게 쓰지 마세요. AI가 같은 실수를 두 번 반복할 때 한 줄씩 늘려 가는 편이 좋습니다. 다음 목표는 Plan Mode로 큰 작업을 맡기는 연습입니다.

이상으로 글 마치겠습니다.

Cursor 설치와 기본 설정VS Code에서 갈아타는 법

이 글로 무엇을 하게 되는지

미리 챙길 준비물

따라 하기: 설치부터 규칙 파일까지

1단계. 내려받아 설치합니다

2단계. 쓰던 설정을 옮깁니다

3단계. 어느 모델에 맡길지 고릅니다

4단계. 프로젝트 규칙 파일을 만듭니다

여기서 자주 막힙니다

여기서 더 나아가려면

참고한 공식 문서