#017 · 48편 중
Cursor 완전 초보 가이드: 설치부터 첫 실행까지 최소 절차
Cursor는 “AI가 같이 앉아 있는 IDE”에 가깝다. 처음에는 기능이 많아 보여도, 성공 확률은 작은 작업으로 루틴을 만드는 것에 달려 있다.
설치 전에 1분만 점검할 것
- 운영체제 버전과 권한(관리자 설치 필요 여부)
- 회사 PC면 보안 프로그램 차단 여부
- 프로젝트에 필요한 런타임(Node/Python 등)이 있는지
설치와 로그인: 여기서 반 이상이 끝난다
- 공식 배포 채널에서 설치 파일을 받는다.
- Cursor 계정으로 로그인한다. 팀 초대가 있으면 워크스페이스 규칙을 확인한다.
- 프로젝트 루트 폴더를 연다. 상위 폴더를 열면 경로가 꼬여서 AI가 엉뚱한 파일을 잡는 경우가 있다.
패키지 설치와 실행: AI 이전에 ‘실행 가능 상태’ 만들기
프로젝트 README에 있는 설치 명령을 그대로 따라가는 편이 좋다. 여기서 자주 나는 문제는 버전이다.
| 증상 | 흔한 원인 | 점검 |
|---|---|---|
| 실행이 안 됨 | 런타임 버전 불일치 | README의 요구 버전 확인 |
| 의존성 오류 | 잘못된 폴더에서 설치 | 루트 폴더 재확인 |
| 포트 충돌 | 다른 프로세스 점유 | 포트/실행 명령 재확인 |
AI 기능을 켤 때의 안전한 첫 요청
첫날은 “프로젝트 전체 리팩터”가 아니라 아래처럼 작게 시작한다.
- 오류 로그를 붙여서 “원인 후보 3개와 확인 순서”를 요청
- 특정 파일만 지정해서 “이 함수가 하는 일”을 요청
- 변경은 한 번에 한 덩어리만 적용하고 실행으로 확인
워크스페이스가 커질 때 꼭 해두면 좋은 정리 4가지
- 루트 폴더 고정: 열린 폴더가 프로젝트 루트인지 상단 경로로 한 번 더 확인한다.
- 무시 범위 정리: 빌드 산출물, 거대한 데이터 폴더, 개인 설정 파일은 검색/인덱싱에서 빼두는 편이 좋다. 그렇지 않으면 AI가 엉뚱한 파일을 근거로 삼는 경우가 생긴다.
- 한 줄 규칙 파일: 팀에서 쓰는 코딩 스타일, 테스트 명령, 브랜치 전략 같은 “항상 지켜야 할 것”을 문서로 남겨둔다. 짧은 규칙이 있으면 제안 품질이 안정된다.
- 재현 커맨드 고정: “로컬에서 이렇게 실행하면 된다”는 최소 커맨드를 README에 박아둔다. 실행 방법이 흔들리면 AI가 준 수정안도 함께 흔들린다.
자주 막히는 문제와 탈출 루트
| 증상 | 의심 포인트 | 대처 |
|---|---|---|
| AI가 다른 파일을 수정하려 한다 | 컨텍스트에 불필요한 폴더가 너무 많다 | 작업 범위를 파일 단위로 좁힌다 |
| “된 것 같은데” 실행이 안 된다 | 의존성/환경 변수/포트가 다르다 | README의 설치/실행을 원문 그대로 따라간다 |
| 변경이 점점 커진다 | 한 번에 요청한 범위가 너무 크다 | 할 일을 3개로 쪼개고 순서를 붙인다 |
보안 체크: 코드가 아니라 ‘정책’이 먼저다
- API 키, 토큰, 비밀번호는 채팅에 그대로 붙이지 않는다. 예시는 더미 값으로만 만든다.
- 회사 저장소라면 외부 전송 허용 여부를 먼저 확인한다. 허용되지 않는데 붙여 넣으면 사고로 이어질 수 있다.
- 결과물에 개인정보가 남지 않게 출력 형식을 정한다.
AI 제안을 “수락”하기 전에 하는 10초 검토
- 변경 파일 수가 생각보다 많지 않은지
- 삭제/이름 변경 같이 되돌리기 어려운 작업이 없는지
- 설정 파일과 인프라 코드가 같이 움직이지 않는지
- 테스트/빌드 커맨드로 바로 확인 가능한지
이 짧은 검토가 실수를 줄이는 가장 저렴한 안전장치다.
관련 글
Related
