Cursor IDE 처음 설치, Windows에서 첫 AI 코드 수정까지 10분 순서

Cursor IDE 설치가 처음부터 헷갈리는 지점

Cursor IDE 설치 자체는 길지 않습니다. 막히는 순간은 따로 있습니다. 검색하면 데스크톱 에디터 설명, 터미널 명령, Agent 문서가 한꺼번에 섞여 나오기 때문입니다. Windows에서 바로 필요한 건 앱을 열고 폴더를 붙이고 한 줄 수정까지 가는 흐름인데, 중간에 다른 문서를 따라가면 시작선이 자꾸 옆으로 샙니다. 이 글은 처음 쓰는 사람 기준으로 그 우회를 덜어낸 순서만 남겼습니다.

처음 10분에 챙길 건 네 가지입니다. 로그인 상태, 인덱싱 진행 화면, Ctrl+K 편집, 터미널에서 cursor . 호출입니다. 이 네 군데가 연결되면 그다음부터는 메뉴를 다 외우지 않아도 됩니다. 반대로 여기서 하나라도 비면 에디터는 열리는데 AI 수정이 안 붙거나, 반응이 느린데 이유를 못 찾는 상황이 자주 나옵니다.

Step 1: Windows용 설치 파일부터 바로 받기

시작은 단순하게 가는 편이 좋습니다. cursor.com에서 Download를 누르고 Windows installer를 실행하면 됩니다. 특정 버전이 꼭 필요할 때만 downloads 페이지를 보면 됩니다. 여기서는 터미널 명령이나 별도 설치 문서를 같이 보지 않는 편이 오히려 덜 헷갈립니다. 지금 목표는 앱을 정상적으로 띄우는 것 하나입니다.

설치 파일이 열리지 않으면 원인을 넓게 잡지 말고 세 가지부터 보면 됩니다. 회사 PC 권한 제한, 보안 프로그램 차단, 다운로드 파일 격리입니다. 파일 속성에 차단 해제 항목이 보이면 먼저 확인하고, 회사 장비라면 관리자 정책 때문에 실행이 막히는지 먼저 보는 편이 빠릅니다. 여기서 시간을 많이 쓰는 이유는 설치 자체보다 PC 정책 문제인 경우가 많아서입니다.

Step 2: 첫 실행에서는 shortcut, theme, terminal만 고르기

처음 열면 onboarding 화면이 나옵니다. 여기서 keyboard shortcut, theme, terminal 설정을 고르게 되는데 이 선택은 나중에 다시 바꿀 수 있습니다. VS Code를 쓰던 사람이라면 shortcut만 비슷하게 맞춰도 적응 속도가 꽤 올라갑니다. 처음부터 전부 완벽하게 맞추려고 붙잡고 있을 필요는 없습니다.

이 단계에서 바로 봐야 하는 건 계정 상태입니다. 에디터 창은 로그인 없이도 열리지만, AI 기능은 계정 연결 여부에 따라 반응 차이가 큽니다. 버튼이 조용하거나 제안이 안 뜨면 기능 문제로 보기 전에 로그인부터 확인하는 편이 낫습니다. onboarding 화면을 다시 열고 싶으면 Ctrl+Shift+P를 눌러 Cursor: Start Onboarding을 찾으면 됩니다.

Step 3: 폴더를 열고 인덱싱이 도는지 먼저 보기

여기서부터 초반 인상이 갈립니다. 새 파일 하나 띄우는 것보다 프로젝트 폴더를 여는 쪽이 먼저입니다. 폴더를 열면 codebase indexing이 시작되고, 이 과정이 끝나야 질문 응답이나 수정 제안이 맥락을 제대로 잡습니다. 프로젝트 크기에 따라 1분에서 15분 정도 걸릴 수 있으니, 첫 반응이 둔하다고 바로 모델 품질 문제로 넘길 필요는 없습니다.

이 구간에서 많이 놓치는 건 포함 파일 범위입니다. 답이 엇나가는 경우를 보면 아직 인덱싱이 덜 끝났거나 필요한 폴더가 제외된 일이 꽤 많습니다. Settings의 Indexing & Docs에서 진행 상태를 보고, View included files로 어떤 파일이 들어갔는지 확인해두면 초반 시행착오를 많이 줄일 수 있습니다. 산출물 폴더가 너무 크면 .gitignore나 .cursorignore를 같이 정리하는 편이 낫습니다.

Step 4: 첫 AI 코드 수정은 Ctrl+K와 Ctrl+I만 잡기

이제 손을 움직이면 됩니다. 처음부터 큰 리팩터링을 맡길 필요는 없습니다. 가장 덜 꼬이는 흐름은 선택 편집과 채팅 두 가지입니다. 코드 한 덩어리를 선택하고 Ctrl+K로 수정 지시를 넣고, 파일 범위를 조금 넓혀 설명이나 다음 작업까지 보고 싶을 때 Ctrl+I를 여는 방식입니다. 이 두 개만 익혀도 첫날 필요한 동선은 거의 만들어집니다.

Tab 자동완성도 같이 보면 좋습니다. 함수 이름 몇 글자를 넣었을 때 이어 쓰기 제안이 자연스럽게 붙으면 기본 연결이 무난한 상태로 보면 됩니다. 반대로 반응이 거의 없으면 로그인 상태, 인덱싱 진행 상태, 현재 연 폴더 권한을 먼저 보는 순서가 맞습니다. 읽기 전용 폴더만 열어둔 경우나 프로젝트 맥락 없이 빈 파일만 띄운 경우에도 응답 품질은 쉽게 흔들립니다.

Step 5: 터미널에서 cursor . 까지 이어두기

마지막으로 붙일 건 매일 쓰는 실행 흐름입니다. Command Palette에서 shell command를 설치해두면 터미널에서 현재 폴더를 바로 열 수 있습니다. Windows에서 프로젝트를 자주 오가는 사람은 이 한 줄 덕분에 동선이 확 줄어듭니다. 데스크톱 앱 설치와 터미널 연결은 같은 작업처럼 보이지만, 실제로는 순서를 나눠 생각하는 편이 덜 꼬입니다.

기존 VS Code 습관이 남아 있으면 code .도 같이 열어둘 수 있어서 전환이 덜 거슬립니다. 반대로 문서에서 보이는 curl 설치 명령은 macOS, Linux, WSL 흐름과 섞여 나올 때가 많습니다. Windows 데스크톱 기준으로 찾고 있다면 먼저 앱을 열고, 그다음 shell command를 붙이는 순서로 생각하면 훨씬 단순합니다.

설치 직후에 여기까지만 되면 됩니다

오늘 기준으로 체크할 건 많지 않습니다. 로그인 상태가 보이고, Indexing & Docs에서 진행 상황이 보이고, Ctrl+K가 반응하고, 터미널에서 cursor .가 열리면 시작선은 넘은 겁니다. 여기서 MCP나 Background Agent까지 한 번에 붙잡으면 오히려 어디서 꼬였는지 분간이 어려워집니다.

처음 쓰는 사람에게 중요한 건 화려한 기능보다 첫 수정 한 번이 자연스럽게 이어지는지입니다. Windows에서 Cursor를 찾는 이유도 대개 거기서 시작합니다. 익숙한 프로젝트 하나를 열고 작은 함수 수정부터 붙여보면 금방 손에 들어옵니다. 그다음에 필요한 기능은 작업하다가 하나씩 넓히는 쪽이 훨씬 편합니다.