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

안녕하세요, muaco입니다.

이 글로 무엇을 하게 되나요

Cursor는 코드를 쓰는 편집기 안에 AI 조수가 같이 앉아 있는 프로그램이에요. 이 글을 따라 하면 내 컴퓨터에 Cursor를 설치하고 VS Code에서 쓰던 설정과 확장 프로그램을 그대로 옮기고 어떤 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에서 갈아타는 법