Tab, Inline Edit, Agent는 같은 일을 하지 않습니다
| 기능 | 잘 맞는 작업 | 첫날 주의점 |
|---|---|---|
| Tab | 작성 중인 코드의 다음 줄·여러 줄 자동완성 | 습관적으로 수락하기 전에 변수명과 조건 확인 |
| Inline Edit | 선택한 코드 범위를 지시대로 수정 | 선택 범위를 작게 잡아 영향 제한 |
| Agent | 파일 탐색, 여러 파일 수정, 명령·테스트 실행 | 계획과 변경 파일을 먼저 확인 |
자동완성이 필요한데 Agent를 부르면 대화와 탐색 비용이 커지고, 여러 파일의 흐름을 고쳐야 하는데 Inline Edit만 반복하면 맥락이 끊깁니다. 기능을 많이 쓰는 것보다 작업 크기에 맞는 표면을 고르는 게 중요합니다.
공식 Quickstart도 ‘작은 변경’에서 시작합니다
2026년 8월 Cursor 공식 문서는 macOS 12 이상, Windows 10 이상을 안내합니다. 앱을 설치하고 로그인한 뒤 기존 프로젝트나 연습용 저장소의 폴더를 엽니다. Cursor는 폴더를 열면 코드베이스를 인덱싱하므로 프로젝트 크기에 따라 내용을 파악하는 데 시간이 걸릴 수 있습니다.
처음부터 회사 운영 저장소를 열 필요는 없습니다. 비밀키가 없고 실행 방법을 아는 작은 프로젝트 복사본이 좋습니다. Git 변경사항이 남아 있다면 먼저 정리하거나 현재 상태를 기록하세요. Cursor의 체크포인트가 있어도 장기적인 변경 기록은 Git과 별개입니다.
첫 요청은 수정이 아니라 설명으로 시작합니다
Agent 패널을 열고 “이 코드베이스를 설명해줘. 주요 진입점과 실행 방법을 알려주고 파일은 바꾸지 마”라고 요청합니다. 답변을 README와 실제 폴더 구조에 맞춰봅니다. 여기서 틀린 설명이 많다면 인덱싱이 덜 됐거나 프로젝트에 문서가 부족한 것입니다.
회원가입 폼의 이메일 오류 문구만 개선하려고 해.
관련 파일을 찾고 수정 계획을 먼저 설명해줘.
내가 승인하기 전에는 파일을 바꾸지 마.
승인 후에는 필요한 파일만 수정하고 기존 테스트를 실행해줘.원하는 결과, 범위, 대기 지점, 확인 방법이 들어 있습니다. “예쁘게 고쳐줘”보다 결과를 검토하기 쉽습니다.
계획을 읽을 때는 수정 파일 수를 봅니다. 문구 하나를 고치는데 설정 파일과 의존성까지 바꾸겠다고 한다면 이유를 물어야 합니다. 파일 하나로 끝낼 수 있는 작업을 일부러 크게 만들 필요가 없습니다.
Agent의 완료 메시지보다 diff가 더 중요합니다
Cursor가 작업을 마치면 변경 요약을 읽고 diff에서 실제 줄을 확인합니다. 삭제된 예외처리, 새로 추가된 패키지, 환경변수 이름, 테스트가 검증하는 범위를 봅니다. “테스트 통과”라고 적혀 있어도 어떤 명령을 실행했고 몇 개가 통과했는지 확인하세요.
화면 변경브라우저에서 데스크톱·모바일 폭과 오류 상태를 직접 확인
데이터 변경빈 값, 중복 값, 실패 시 되돌림을 테스트
패키지 추가잠금 파일 변화와 라이선스·유지보수 필요성을 확인
명령 실행현재 폴더와 외부 서비스·데이터에 미치는 영향을 확인
결과가 마음에 들지 않으면 즉시 큰 수정 요청을 덧붙이기보다 원하는 상태와 현재 차이를 한 문장으로 적습니다. 변경을 되돌린 뒤 더 작은 범위로 다시 요청하는 편이 대화 맥락에 오류를 누적시키지 않습니다.
컨텍스트는 많이 넣을수록 정확한 것이 아닙니다
Cursor는 파일, 폴더, 터미널, Git diff, 브라우저 등을 컨텍스트로 첨부할 수 있습니다. 관련 파일을 알고 있다면 정확히 지정하고, 모른다면 Agent가 검색하게 둡니다. 저장소 전체와 긴 로그를 한꺼번에 넣으면 중요한 오류 문장이 묻힐 수 있습니다.
오류 해결에서는 재현 단계, 기대한 결과, 실제 오류, 관련 로그 일부를 순서대로 줍니다. 개인정보·토큰·운영 데이터는 붙여넣기 전에 지웁니다. AI가 코드를 이해하려면 비밀값 자체가 아니라 변수의 역할과 형식이 필요한 경우가 대부분입니다.
Rules는 반복되는 기준만 남깁니다
프로젝트 규칙에는 사용 언어, 테스트 명령, 수정하면 안 되는 폴더, 스타일 기준처럼 여러 작업에 계속 적용되는 내용을 적습니다. 이번 요청에만 필요한 상세 요구까지 영구 규칙으로 넣으면 다음 작업에서 예상하지 못한 제약이 됩니다.
첫 주에는 자주 반복한 설명을 메모해두고 세 번 이상 등장한 것만 규칙 후보로 옮겨보세요. “항상 최고 품질로 작성” 같은 추상 문구보다 “새 API는 기존 오류 응답 형식을 유지하고 관련 테스트를 추가”처럼 검증 가능한 문장이 낫습니다.
일주일 뒤에는 속도보다 재수정 횟수를 봅니다
Cursor가 만든 코드의 양보다 사람이 다시 고친 횟수, 테스트 실패, 검토에 걸린 시간을 기록합니다. 단순 문구 수정은 빨라졌는데 큰 기능에서 검토시간이 늘었다면 Agent의 문제가 아니라 작업 범위를 너무 넓게 맡긴 것일 수 있습니다.
Cursor AI 사용법의 핵심은 프롬프트 묘기가 아닙니다. 작은 범위를 주고, 근거가 되는 파일을 확인하고, diff와 실행 결과로 닫는 작업 습관입니다. 이 흐름이 안정되면 Plan과 Agent, Cloud Agent 같은 더 큰 기능으로 확장해도 검토 기준을 잃지 않습니다.
Cursor Quickstart, Agent Overview, Prompting 문서를 2026년 8월 28일 확인했습니다.