3 - Cursor IDE 첫걸음: 설치부터 실전 활용까지

서론

Cursor IDE는 VS Code 오픈소스를 기반으로 개발된 독립형 AI 코드 에디터로, AI 코딩 어시스턴트 기능을 에디터 전반에 통합해 개발 생산성을 높입니다. 이 튜토리얼에서는 Cursor IDE를 처음 사용하는 개발자가 설치부터 기본 사용법까지 빠르게 익히고, 실제 프로젝트에 바로 적용할 수 있도록 단계별로 안내합니다.

학습 목표

• Cursor IDE 설치 및 초기 환경 구성 방법 습득
• 코드 자동완성(Tab) 및 다중라인 추천(Shift+Tab) 활용
• 자연어 명령으로 프로젝트 생성·수정·테스트 실행
• .cursorrules 파일로 AI 행동 규칙 커스터마이징
• 터미널 명령 자연어 실행 및 인라인 편집 단축키 사용법 숙지

---

1. 설치 및 환경 설정

1.1 시스템 요구사항

항목	최소 사양	권장 사양
운영체제	Windows 10 이상, macOS 11 이상, Ubuntu 20.04 이상	Windows 11, macOS 최신 버전, Ubuntu 22.04 이상
메모리	8GB	16GB 이상
저장 공간	500MB	1GB 이상
네트워크	인터넷 연결	고속 인터넷 (프롬프트 지연 최소화)

1.2 설치 가이드

1. 다운로드
   • 공식 웹사이트에서 OS에 맞는 설치 파일(.exe, .dmg, .AppImage) 다운로드
   • 터미널 예시 (Linux):
   • wget https://cdn.cursor.so/install.AppImage && chmod +x install.AppImage
2. 설치 실행
   • Windows: .exe 실행 후 지침에 따라 설치
   • macOS: .dmg 마운트 후 응용 프로그램 폴더로 드래그
   • Linux: ./install.AppImage로 설치 스크립트 실행
3. 첫 실행 및 로그인
   • 설치 완료 후 애플리케이션 실행
   • GitHub/GitLab 로그인 또는 이메일 등록으로 프로필 생성
4. API 키 등록 (선택 사항)
   • Settings → AI Providers에서 OpenAI·Anthropic API 키 입력
   • 기본 제공 키 사용 시 입력 필드 비워두기

1.3 환경 설정 팁

• 업데이트 채널: Stable, Beta, Insiders 중 선택
• 프롬프트 기록 보존: 7일, 30일, 무제한 옵션
• 프록시 설정: 기업망 사용 시 Settings → Network에서 프록시 정보 입력
• 캐시 경로: 로컬 캐시 저장 위치를 사용자 지정 가능

---

2. 기본 자동완성 및 다중라인 추천

2.1 자동완성(Tab)

• Tab 키 한 번으로 커서 위치에 코드 완성 제안
• 함수 시그니처, 매개변수, 간단 로직까지 자동 생성
• 제안 순환: Tab 반복 입력으로 다양한 버전 확인
• 제안 취소: Esc 키로 즉시 제거 후 재요청

예시

def calculate_sum(numbers):
    # 커서 위치에서 Tab 입력 → AI가 자동 생성
    total = sum(numbers)
    return total

2.2 다중라인 추천(Shift+Tab)

• Shift+Tab으로 여러 줄 코드 블록 제안
• 클래스 정의, API 엔드포인트 등 대형 코드 생성에 유용
• 버전 선택: ↑↓ 화살표로 다른 제안 보기

예시

class UserService {
    constructor(userModel) {
        this.userModel = userModel;
    }
// Shift+Tab 입력 → AI가 다음 블록 자동 생성
    async createUser(data) {
        const user = new this.userModel(data);
        await user.save();
        return user;
    }
}

2.3 추천 설정 조정

• Settings → Editor → Completion에서 Tab/Shift+Tab 동작 세부 조정
• Trigger Characters: 자동완성 활성 키워드(., import, async 등) 설정
• Suggestion Delay: 자동완성 대기 시간(ms) 조정

---

3. 실전 예제: ToDo 앱 백엔드 구축

3.1 프로젝트 초기화

1. 새 디렉터리 생성 및 이동:
2. mkdir todo-app && cd todo-app
3. Cursor 에디터 실행:
4. cursor .
5. 에이전트 호출:
6. Ctrl+I → "FastAPI로 ToDo 앱 백엔드를 생성하고, SQLAlchemy 모델과 Pydantic 스키마를 포함해줘"

3.2 파일 및 코드 자동 생성

AI가 자동 생성한 파일과 기본 코드:

• models.py: SQLAlchemy 모델 정의
• schemas.py: Pydantic 스키마 정의
• routes.py: CRUD 엔드포인트 구현
• main.py: FastAPI 앱 초기화 및 라우터 등록

# models.py
from sqlalchemy import Column, Integer, String, Boolean
class Todo(Base):
    __tablename__ = 'todos'
    id = Column(Integer, primary_key=True)
    title = Column(String, nullable=False)
    completed = Column(Boolean, default=False)

3.3 추가 요청 및 개선

• 입력 검증 및 응답 코드:
• Ctrl+I → "POST /todos 라우터에 입력 유효성 검사와 HTTP 응답 코드 반환 추가"
• 예외 처리:
• Ctrl+I → "데이터 미존재 시 404 에러 반환하도록 수정"
• JWT 인증:
• Ctrl+I → "JWT 기반 인증 미들웨어와 보호된 엔드포인트 추가"

3.4 테스트 자동화

• 테스트 코드 작성:
• Ctrl+I → "ToDo 모델 CRUD 기능에 대한 pytest 테스트 작성"
• Auto-Run 모드 활성화: 테스트 자동 실행 및 결과 인라인 표시

# tests/test_todo.py

def test_create_todo(client):
    response = client.post('/todos/', json={'title': 'Test'})
    assert response.status_code == 201

---

4. .cursorrules 파일로 AI 지침 정의

4.1 역할과 장점

.cursorrules는 프로젝트별 AI 동작 규칙을 설정하는 파일입니다. 이를 활용하면 코드 스타일, 프레임워크 사용법, 보안 정책 등을 일관되게 적용할 수 있습니다.

4.2 예시 설정

# .cursorrules
language: python
framework: fastapi
formatter: black
linting: flake8
docstrings: true
security:
  csrf_protection: true
  input_sanitization: true
structure:
  - models.py
  - schemas.py
  - routes.py
  - main.py

4.3 적용 방법

1. 프로젝트 루트에 .cursorrules 파일 생성 및 저장
2. Ctrl+Shift+P → Reload AI Rules 실행
3. AI가 설정을 자동 반영하는지 확인

---

5. 터미널 명령 자연어 실행 및 인라인 편집

5.1 터미널 명령 자연어 실행

• Ctrl+`(백틱)으로 터미널 열기
• Ctrl+I 입력 후 자연어 명령 실행:→ pip install fastapi sqlalchemy, requirements.txt 자동 업데이트
• "requirements.txt에 FastAPI와 SQLAlchemy 추가하고 설치"
• 복합 명령: "npm install fastapi && alembic revision --autogenerate"도 지원

5.2 인라인 편집 단축키

• Ctrl+K: 선택 영역 또는 해당 함수/클래스에 대한 수정 지시
• 예시:
  1. utils.py에서 함수 블록 선택
  2. Ctrl+K → "예외 로깅 추가" 입력
  3. AI가 로깅 코드 자동 삽입
• Undo/Redo: Ctrl+Z/Ctrl+Y로 즉시 되돌리기 가능

---

맺음말

이 가이드를 통해 Cursor IDE의 설치부터 필수 기능까지 학습했습니다. 이제 에디터와 AI 기능에 익숙해졌다면, 다양한 프로젝트에 적용하여 개발 생산성을 한층 높여 보세요.