ToolJipsa Guide

Cursor 사용 가이드: 기존 프로젝트에 AI 코딩을 붙이는 법

Cursor는 코드를 대신 책임지는 도구가 아니라 프로젝트 문맥을 빠르게 읽고 수정안을 만드는 개발 보조 환경으로 접근해야 합니다.

마지막 확인일: 2026년 8월 23일

이런 분께 필요한 글이에요

기존 Git 저장소에 AI 코딩을 도입하려는 개발자와 작은 팀, 생성 코드의 검수 방법이 궁금한 입문자를 위한 글입니다.

먼저 보는 핵심 요약

  • 작은 변경부터 맡기고 항상 Git diff로 수정 범위를 확인하세요.
  • 프로젝트의 버전별 공식 문서와 테스트 명령을 함께 제공하면 오류를 줄일 수 있습니다.
  • 비밀값, 운영 데이터와 광범위한 실행 권한을 프롬프트에 노출하지 마세요.

목적별 선택

기존 저장소 수정

Cursor

Git diff와 테스트가 있는 프로젝트에서 장점이 큽니다.

브라우저 시작

Replit

로컬 환경 설정이 부담이라면 비교해보세요.

화면 중심 MVP

Lovable

기능보다 UI 흐름 검증이 먼저라면 후보가 됩니다.

첫 작업은 작고 검증 가능하게

문구 수정, 한 컴포넌트 개선, 테스트 추가처럼 성공 여부가 분명한 작업부터 시작하세요. 요구사항과 변경 금지 영역을 함께 적으면 불필요한 수정이 줄어듭니다.

작업 전 Git 상태를 확인하고 사용자 변경사항이 섞여 있으면 보존해야 합니다.

좋은 요청에 포함할 정보

목표, 현재 오류, 실행해야 할 테스트와 완료 기준을 순서대로 제공하세요. 프레임워크 버전이 중요한 프로젝트라면 로컬 공식 문서를 읽도록 명시하는 것이 좋습니다.

  • 수정할 기능과 수정하면 안 되는 영역
  • 재현 명령과 기대 결과
  • lint·type check·build·test 명령
  • 배포나 외부 시스템 변경 허용 범위

완료 후 검수 순서

코드 diff를 먼저 읽고 자동 테스트를 실행한 뒤 실제 화면이나 API를 확인하세요. 테스트 통과만으로 접근성과 예외 상황까지 보장되지는 않습니다.

AI가 설명한 결과와 실제 Git 상태가 일치하는지도 직접 확인해야 합니다.

장점

  • 여러 파일 사이의 관계를 바탕으로 수정안을 만들 수 있습니다.
  • 코드 설명과 오류 원인 탐색을 편집 흐름 안에서 이어가기 쉽습니다.
  • 반복적인 리팩터링과 테스트 초안을 빠르게 제안받을 수 있습니다.

단점·확인할 점

  • 큰 변경을 한 번에 허용하면 검토가 어려워집니다.
  • 존재하지 않는 API나 오래된 사용법을 제안할 수 있습니다.
  • 자동 실행 명령은 파일 삭제와 외부 서비스 변경 여부를 확인해야 합니다.

이 글에 나온 AI 툴