개발용 VS Code 대신 Cursor 설치하고 AI 코딩 에이전트 활성화하기

개발 생산성을 높이려고 코딩용 AI를 찾는 분들이 가장 먼저 마주하는 고민이 있습니다. 지금 쓰는 VS Code에 확장을 붙여서 계속 갈지, 아니면 전용 에디터로 옮길지 결정하는 일인데요. 결론부터 말하면, 지금 시점에서는 에디터 자체를 Cursor로 옮기는 편이 훨씬 직관적입니다. 단순한 자동완성을 넘어서 코드베이스 전체를 이해하고, 필요한 부분을 직접 수정하는 에이전트 모드가 있기 때문입니다.

이 글에서는 기존 VS Code 설정과 단축키를 그대로 가져오면서 Cursor를 설치하고, 가장 핵심인 AI 코딩 에이전트 기능을 켜는 방법까지 순서대로 정리했습니다. 설치 자체는 오래 걸리지 않지만, 초반 설정을 대충 넘기면 기존 개발 환경이 꼬이거나 불필요한 API 비용이 생길 수 있습니다. 아래 단계대로 차근차근 따라가면 됩니다.

Cursor 설치부터 시작하기

Step 1: 기존 VS Code 환경을 가져오며 설치하기

먼저 공식 홈페이지에서 자신의 운영체제에 맞는 설치 파일을 내려받아야 합니다. 설치를 시작하면 가장 먼저 기존 개발 환경을 가져올지 묻는 화면이 뜹니다. 이때는 Import VS Code settings를 선택하는 편이 좋습니다. 그동안 쓰던 테마, 단축키, 확장 기능이 한 번에 이어지기 때문입니다. 이 단계를 건너뛰면 나중에 다시 맞춰야 할 항목이 많아져서 오히려 번거로워집니다.

Cursor 설치를 마치고 처음 실행하면 영어로 된 시작 화면이 나타납니다. 한국어 팩이 필요하다면 마켓플레이스에서 Korean Language Pack을 검색해 설치하면 됩니다. 다만 단축키 충돌이 없도록 VS Code 스타일의 기본 키맵이 잘 적용됐는지 한 번 확인해 두는 편이 좋습니다. 터미널을 열어 프로젝트가 정상적으로 로드되는지만 확인하면 첫 단계는 무난하게 끝난 셈입니다.

모델과 키 설정 맞추기

Step 2: API Keys 등록하고 사용할 모델 정리하기

Cursor는 자체 구독형 Pro 요금제를 쓸 수도 있고, 개인 OpenAI나 Anthropic API 키를 연결해서 쓸 수도 있습니다. 응답 속도와 사용 편의성을 우선하면 Pro가 편하고, 사용량이 많지 않은 개인 빌더라면 API 키를 직접 연결하는 방식이 비용 관리에 더 유리합니다. 설정 화면의 Models 메뉴로 들어가면 각 서비스의 키를 입력하는 칸이 보입니다.

여기서 중요한 건 어떤 모델을 먼저 쓸지 정리하는 일입니다. 코딩 성능 면에서는 Claude 3.5 Sonnet이나 GPT-4o가 무난한 선택입니다. 다만 단순 반복 작업이나 가벼운 리팩토링에는 상대적으로 저렴한 모델을 쓰는 편이 비용 면에서 훨씬 낫습니다. 자주 쓰지 않는 구형 모델은 목록에서 꺼 두면 모델 전환 단축키를 사용할 때 덜 헷갈립니다.

설정을 마쳤다면 에디터에서 아무 파일이나 열고 간단한 테스트를 해보면 됩니다. 코드 한 줄을 드래그한 뒤 명령을 내려 보세요.

잠시 후 변경된 코드가 초록색과 빨간색으로 표시되면 연동이 제대로 된 것입니다. 만약 여기서 API 에러가 난다면 결제 한도가 초과됐거나, API 키를 붙여 넣는 과정에서 공백이 섞였을 가능성이 높습니다. 복사한 문자열을 다시 확인해보면 대부분 해결됩니다.

AI 코딩 에이전트 활용하기

Step 3: 에이전트 모드를 켜고 멀티 파일 편집하기

Cursor의 진짜 강점은 파일 하나를 조금 고치는 데 있지 않습니다. 프로젝트 전체를 살펴보면서 여러 파일을 동시에 바꾸는 기능에 있습니다. 단축키 Ctrl + I 또는 Cmd + I를 누르면 별도의 채팅 창이 열립니다. 여기서 우측 상단 모드를 Chat에서 Agent로 바꿔야 멀티 파일 수정 권한이 활성화됩니다.

이 AI 코딩 에이전트를 켜면 작업 흐름이 확실히 달라집니다. 코드를 고쳐 달라고 요청하면 에이전트가 관련 파일을 찾아보고, 수정 계획을 세우고, 실제 코드까지 반영합니다. 예를 들어 새 API 엔드포인트를 추가해야 하는 상황이라면 아래처럼 요청할 수 있습니다.

그러면 에이전트가 여러 파일을 오가며 코드를 작성합니다. 수정이 끝날 때마다 개발자가 변경 사항을 승인할지 반려할지 고르게 됩니다. 한 화면에서 바뀐 부분을 확인하고 승인 버튼만 누르면 되니, 작업 흐름이 덜 끊깁니다. 다만 에이전트가 예상 밖의 파일까지 건드리지 않게 하려면 프로젝트 루트에 규칙 파일을 두는 편이 좋습니다. 지침을 미리 적어두면 불필요한 수정을 줄이고, 토큰 낭비도 줄일 수 있습니다.

규칙 파일로 행동 범위 정리하기

.cursorrules로 자동 동작을 조절하기

에이전트를 무턱대고 쓰면 의도치 않게 패키지를 설치하거나, 필요 없는 테스트를 계속 돌리면서 API 크레딧을 낭비할 수 있습니다. 이런 동작을 줄이려면 프로젝트 최상위 경로에 .cursorrules 파일을 만들어 규칙을 적어 두는 과정이 중요합니다. 텍스트 에디터로 파일을 만들고 아래와 같은 지침을 저장해 두면 됩니다.

이렇게만 해도 에이전트가 쓸데없이 파일을 뒤지며 시간을 보내는 일이 꽤 줄어듭니다. 특히 대규모 레포지토리에서는 특정 디렉토리만 다루게 제한해 두는 편이 속도와 비용 면에서 모두 유리합니다. 처음에는 규칙 파일을 만드는 과정이 조금 번거롭더라도, 한 번 세팅해 두면 이후 작업이 훨씬 안정적입니다.

비용과 보안 챙기기

Step 4: 과금 제한과 프라이버시 옵션 확인하기

개인 API 키를 연결해서 쓴다면 비용 관리도 꼭 챙겨야 합니다. Usage 페이지에서 일일 또는 월별 지출 한도를 설정해 두지 않으면, 예상보다 많은 요청이 쌓였을 때 요금이 커질 수 있습니다. Anthropic이나 OpenAI 콘솔에 로그인한 뒤 예산 제한을 먼저 설정해 두는 습관이 필요합니다.

회사 코드나 민감한 개인 프로젝트를 다루는 경우라면 데이터 공유 옵션도 확인해야 합니다. 사용자의 코드가 외부 학습에 활용되지 않도록 프라이버시 관련 설정을 꺼 두는 편이 안전합니다. Cursor 설정 창의 Features 메뉴에서 Privacy Mode를 찾아 Enabled로 바꿔 두면 됩니다. 이 부분은 설정이 한 번 맞춰져 있다고 끝나는 항목이 아니라, 새 계정을 연결할 때마다 다시 확인하는 편이 좋습니다.

정리

Cursor는 VS Code에 익숙한 사람도 큰 부담 없이 옮겨 갈 수 있으면서, AI 코딩 에이전트의 장점을 바로 체감하기 좋은 에디터입니다. 기존 설정을 가져오고, 사용할 모델을 정리하고, .cursorrules로 행동 범위를 묶어 두면 다중 파일 수정 작업이 꽤 편해집니다. 결국 핵심은 Cursor를 그냥 설치하는 데서 끝내지 않고, 내 작업 방식에 맞게 정리해 두는 데 있습니다.

도구를 손에 맞게 길들이는 과정에는 약간의 시행착오가 따릅니다. 그래도 한 번 자리를 잡아 두면 마우스를 덜 쓰고 키보드만으로 더 많은 작업을 처리할 수 있습니다. 다음에는 이 개발 환경 위에서 실제로 풀스택 웹 애플리케이션을 짧은 시간 안에 만드는 흐름을 이어서 다뤄볼 수 있습니다.