Cursor CLI 기본 사용법

3 min read

가장 자주 쓰는 방법: cursor agent

프로젝트 디렉터리에서 실행:

cursor agent "이 프로젝트에 README를 추가해줘"
  • 대화형: AI가 질문과 제안을 하고, 변경 사항을 수락하거나 거부할 수 있습니다
  • 컨텍스트 인식: 현재 디렉터리의 파일을 참조해 응답하고 편집합니다

한 번에 지시 vs 대화하며 진행

작업을 바로 맡기고 싶을 때: 지시사항을 따옴표 안에 넣어 한 번에 전달합니다.

cursor agent "auth 모듈을 JWT 방식으로 리팩터링해줘"

먼저 논의하고 싶을 때: 인수 없이 cursor agent만 실행하면 대화 모드에 진입합니다. 요구사항을 단계적으로 설명하면 AI가 확인 후 코드를 변경합니다.

작업 디렉터리 지정

기본값은 현재 디렉터리입니다. 경로를 지정하려면 --path를 추가:

cursor agent "TypeScript 타입을 확인하고 수정해줘" --path ./src

자주 쓰는 명령어 빠른 참조

명령어 설명
cursor agent "무언가 하기" AI에게 실행 요청 (파일 변경 가능)
cursor agent 작업 없이 대화 모드 진입
cursor ask "질문" 질문만, 파일 변경 없음 (읽기 전용)
cursor --help 모든 옵션 보기

요약

  • 가장 자주 씀: cursor agent "지시사항"
  • 먼저 대화하고 싶다면: cursor agent만 실행
  • 변경 없이 질문: cursor ask "질문" 사용
  • 디렉터리 지정: --path 경로 추가

다음: 03-modes — Agent / Plan / Ask 세 가지 모드를 알아보세요