Cursor 처음 사용하기: 설치부터 첫 변경 확인까지

Cursor는 무엇을 설치하는 건가요?

Cursor는 AI와 대화하면서 파일을 읽고 수정하는 기능을 갖춘 편집기입니다. 이 글은 Cursor 데스크톱 앱을 설치해 작은 로컬 작업을 시작하는 경로입니다. Cursor CLI나 클라우드 에이전트를 먼저 설정하는 과정이 아닙니다.

내 컴퓨터 정보, 로그인할 계정, 빈 실습 폴더를 준비하세요. 설치 자체와 AI 기능의 이용 권한은 다릅니다. 로그인 화면에서 보이는 현재 요금·사용량 조건을 확인하고, API 키를 넣거나 유료 상품을 바로 결제할 필요가 있는지 따로 판단합니다.

처음 실행하면 로그인과 설정 가져오기 안내가 나올 수 있습니다. 로그인 경로를 선택하고 브라우저 인증을 마친 뒤 앱으로 돌아옵니다. 다른 편집기 설정 가져오기는 기존 설정이 있을 때만 필요한 선택 사항입니다. 처음이라면 기본 설정으로 시작해도 됩니다.

정상 결과: 계정 인증이 끝나고 앱에서 작업할 폴더를 선택할 수 있습니다. 브라우저 로그인 성공과 앱으로 복귀한 상태를 구분해서 확인하세요.

폴더 열기 기능을 선택하고 code6office-practice를 엽니다.
왼쪽 파일 목록이 해당 폴더인지 확인합니다.
공식 안내 기준 Mac은 Command+I, Windows는 Ctrl+I로 Agent를 열 수 있습니다. 키 설정이 다르면 화면의 Agent 메뉴를 사용하세요.
Agent 입력칸에 먼저 다음과 같이 요청합니다.

현재 폴더에서 무엇을 할 수 있는지 초보자에게 설명해줘.
파일을 만들거나 수정하지 말고, 지금 있는 파일부터 확인해줘.

답을 받은 다음 첫 HTML 실습의 요청으로 파일 하나를 만들어보세요. 처음부터 복잡한 앱 전체를 만들게 하지 말고, 한 문장 수정처럼 결과를 확인하기 쉬운 작업부터 진행합니다.

AI가 작업을 끝냈다고 안내하면 변경된 파일과 비교 화면(diff)을 확인합니다. 추가된 내용과 삭제된 내용을 읽고 실제 브라우저 결과도 확인하세요. 설치나 외부 서비스 생성이 끼어 있으면 승인 전에 이유를 물어봅니다.

질문을 코드 파일에 입력했어요: Agent 대화 입력칸과 파일 편집 영역을 구분합니다. 잘못 입력한 파일은 저장 여부를 확인하고 되돌립니다.
Agent가 안 보여요: 현재 편집 창과 메뉴를 확인하고 공식 빠른 시작의 Agent 열기를 참고합니다. 단축키만 반복 누르지 않습니다.
사용량 제한이 나와요: 설치 실패가 아닐 수 있습니다. 현재 계정의 이용 조건을 확인하세요.
수정 결과가 안 보여요: 바꾼 파일이 실제로 저장됐는지, 브라우저에서 같은 파일을 열었는지 확인합니다.
다음 날 어떻게 시작하나요? Cursor를 다시 열고 최근 폴더에서 같은 실습 폴더를 선택합니다. 대화 기억만 믿지 말고 현재 파일 상태를 먼저 확인하도록 요청합니다.

완료 기준: 올바른 폴더에서 질문했고, 변경 파일을 확인했으며, 브라우저에서 작은 수정 결과를 직접 봤습니다.

확인 당시 빠른 시작의 한국어 경로는 영문 문서로 이동했습니다. 실제 제공되는 공식 영문 문서임을 표시했으며, 이 글의 절차는 한국어로 설명했습니다. 모든 PC에서 설치를 재현한 것은 아닙니다.