Cursor AI 사용법, 단축키 모음

Cursor AI는 VS Code를 기반으로 하기 때문에 기본적인 인터페이스는 VS Code와 매우 유사합니다. AI 기능은 주로 단축키나 특정 UI 요소를 통해 활성화됩니다.

 

Cursor AI 기본 사용법

1. 설치 및 실행:
   • Cursor AI 웹사이트에서 다운로드하여 설치합니다.
   • 기존 VS Code 설정을 가져올 수 있어 편리합니다.
2. 가장 중요한 단축키: Ctrl+K (Windows/Linux) 또는 Cmd+K (Mac)
   • 이 단축키를 누르면 AI 채팅/명령 입력창이 나타납니다.
   • 코드를 선택하지 않고 Ctrl+K:
     • 새로운 코드 생성 요청 ("파이썬으로 간단한 웹 서버 코드 만들어줘")
     • 일반적인 질문 ("이 프로젝트 구조 설명해줘", "자바스크립트의 클로저란?")
     • 터미널 명령 요청 ("현재 디렉토리의 모든 .py 파일 찾아서 삭제해줘")
   • 코드를 선택하고 Ctrl+K:
     • 선택한 코드에 대한 작업 요청 ("이 함수 리팩토링 해줘", "이 코드에 주석 달아줘", "이 코드의 버그 찾아줘", "이 코드를 Go 언어로 바꿔줘", "이 코드 설명해줘")
     • AI가 제안하는 변경 사항은 바로 적용하거나, diff 형태로 비교하며 선택적으로 적용할 수 있습니다.
3. AI 채팅창 활용:
   • Ctrl+K로 열린 창에서 AI와 대화하듯 상호작용합니다.
   • AI의 답변이 만족스럽지 않으면 추가 질문을 하거나 수정을 요청할 수 있습니다.
   • "Generate" 버튼: 프롬프트에 따라 새로운 코드를 생성하거나 변경 사항을 제안합니다.
   • "Edit" 버튼: AI가 기존 코드를 직접 수정하도록 지시할 때 사용합니다.
   • "Chat" 버튼: 코드 수정 없이 일반적인 대화나 질문을 할 때 사용합니다.
4. 컨텍스트 참조 (@ 심볼 사용):
   • AI에게 특정 파일이나 심볼(함수, 클래스 등)을 참조하도록 명시적으로 알려줄 수 있습니다.
   • 예: @파일이름.py 또는 @함수명 을 입력창에 포함하여 질문합니다.
     • " @main.py 파일의 calculate_total 함수를 참고해서 새로운 할인 함수 만들어줘"
     • " @utils/helper.js 파일에 이 함수와 유사한 함수가 있는지 찾아줘"
5. 인라인 AI 액션 (Code Lenses 및 빠른 수정):
   • 코드 위에 마우스를 올리거나, 특정 오류/경고 옆에 나타나는 전구 아이콘(Quick Fix)을 클릭하면 AI가 제안하는 수정 사항이나 작업("AI Fix", "Explain with AI" 등)이 나타날 수 있습니다.
6. 자동 디버깅 ("Fix Linter / Errors" 기능):
   • 문제가 있는 코드에 대해 Ctrl+K를 누르고 "이 오류 수정해줘"라고 하거나, 때로는 AI가 자동으로 수정 제안을 하기도 합니다.
7. 문서화 ("Generate Docs"):
   • 함수나 클래스를 선택하고 Ctrl+K 후 "문서 생성해줘" 또는 우클릭 메뉴에서 관련 옵션을 선택하면 AI가 주석이나 설명을 생성해줍니다.

 

 

 

주요 메뉴 및 UI 요소 (VS Code 기반)

Cursor는 VS Code를 기반으로 하므로 대부분의 메뉴는 VS Code와 동일합니다. AI 기능은 이러한 표준 인터페이스에 통합되어 있습니다.

1. Activity Bar (왼쪽 사이드바):
   • 탐색기 (Explorer): 프로젝트 파일 및 폴더 구조. AI는 이 파일들을 컨텍스트로 활용합니다.
   • 검색 (Search): 프로젝트 전체에서 텍스트 검색.
   • 소스 제어 (Source Control): Git 등 버전 관리 시스템 연동.
   • 실행 및 디버그 (Run and Debug): 코드 실행 및 디버깅. AI에게 디버깅 도움을 요청할 수 있습니다.
   • 확장 (Extensions): VS Code 확장 프로그램 관리. Cursor는 VS Code 확장을 그대로 사용할 수 있습니다.
   • Cursor AI 아이콘 (있을 경우): AI 관련 설정이나 특정 기능을 모아둔 아이콘이 있을 수 있습니다. (버전에 따라 다름)
2. Editor Area (중앙 코드 편집 영역):
   • 코드를 작성하고 수정하는 주 공간입니다. AI와 가장 많이 상호작용하는 곳입니다.
   • 코드 선택 후 Ctrl+K를 통해 AI 기능을 호출합니다.
   • AI가 제안하는 변경 사항이 diff 형태로 표시되기도 합니다.
3. AI Chat Panel / Input Box:
   • Ctrl+K를 누르면 화면 중앙이나 특정 위치에 나타나는 입력창입니다.
   • 여기에 자연어로 명령이나 질문을 입력합니다.
   • AI의 답변, 코드 제안 등이 이 패널 또는 관련 팝업에 표시됩니다.
4. Status Bar (하단 상태 표시줄):
   • 현재 파일 정보, Git 브랜치, 오류/경고 수 등이 표시됩니다.
   • Cursor AI 관련 상태 (예: 사용 중인 AI 모델, 토큰 사용량 등)가 표시될 수 있습니다.
5. Command Palette (Ctrl+Shift+P 또는 Cmd+Shift+P):
   • VS Code의 모든 명령에 접근할 수 있는 강력한 도구입니다.
   • "Cursor" 등으로 검색하여 Cursor AI 관련 명령을 찾을 수 있습니다 (예: "Cursor: Ask a question").
6. Context Menu (우클릭 메뉴):
   • 파일 탐색기에서 파일/폴더를 우클릭하거나, 코드 편집기에서 코드를 선택하고 우클릭하면 나타나는 메뉴입니다.
   • "Ask Cursor", "Edit with Cursor", "Generate Docs with Cursor" 등 AI 관련 액션이 포함되어 있습니다.

 

사용팁

• 구체적으로 질문하세요: AI에게 모호하게 요청하면 원하는 결과를 얻기 어렵습니다. 최대한 자세하고 명확하게 지시하세요.
• 작은 단위로 나눠서 작업하세요: 한 번에 너무 복잡한 작업을 시키기보다, 작은 단위로 나눠서 AI의 도움을 받고 결과를 확인하며 진행하는 것이 좋습니다.
• AI의 제안을 검토하세요: AI는 강력하지만 완벽하지 않습니다. AI가 생성하거나 수정한 코드는 반드시 직접 검토하고 테스트해야 합니다.
• 다양한 기능을 실험해보세요: 단순히 코드 생성뿐만 아니라 리팩토링, 문서화, 코드 설명 등 다양한 기능을 활용해보세요.

 

 

Cursor AI는 빠르게 발전하고 있으므로, 최신 기능이나 인터페이스 변경 사항은 공식 문서나 튜토리얼을 참고하는 것이 가장 좋습니다. 하지만 위에 설명된 Ctrl+K를 통한 상호작용은 핵심 사용법이므로 이것만 잘 익혀도 대부분의 기능을 활용할 수 있습니다.