Cursor CLI 사용설명서

Cursor CLI | Cursor – The AI Code Editor

Cursor CLI 개요

  • **Cursor CLI(Beta)**는 터미널에서 AI 기반 코딩 워크플로우를 실행하고 자동화하도록 설계된 도구로, 개발 환경 안팎 어디서든 사용할 수 있습니다. Cursor+1
  • JetBrains, VSCode, Android Studio 등 다양한 IDE와 통합되어 동일한 커맨드로 작업할 수 있습니다. CursorMedium
  • OpenAI GPT-5, Claude-4(sonnet, opus), Gemini-2.5-pro, grok-4 등 최신 AI 모델을 지원합니다. CursorMedium
  • 터미널에서 코드 변경 리뷰, 실시간 조정, 그리고 규칙 기반 커스터마이징이 가능합니다. CursorCursor

설치

curl https://cursor.com/install -fsS | bash
  • macOS, Linux 및 Windows(WSL) 모두 지원합니다. CursorCursor
  • 설치 후, 다음 명령으로 버전 확인 및 정상 동작 여부를 확인할 수 있습니다: 
cursor-agent --version

Cursor

  • 자동 업데이트를 기본 제공하며, 수동 업데이트는 다음 명령으로 가능합니다: 
cursor-agent update
# 또는
cursor-agent upgrade

Cursor

사용 방식

인터랙티브 모드

  • 다음 명령어로 대화형 세션을 시작할 수 있습니다: 
cursor-agent
  • 혹은 초기 프롬프트를 지정하여 실행할 수도 있습니다: 
cursor-agent "refactor the auth module to use JWT tokens"

Cursor

비인터랙티브 모드 (스크립트 or CI용)

cursor-agent -p "find and fix performance issues" --model "gpt-5"
  • -p 또는 --print 옵션으로 출력만 생성하며, --output-format 옵션을 사용해 결과를 텍스트, JSON 등으로 형식 지정할 수 있습니다: 
cursor-agent -p "review these changes for security issues" --output-format json
  • 자동화된 워크플로우, 스크립트나 CI 파이프라인에 활용 가능하며, 변경 권한도 제공됩니다. Cursor+1

세션 관리 (Context 유지)

  • 이전 대화를 이어가거나 세션 관리 기능 활용 가능: 
cursor-agent ls       # 대화 목록 보기
cursor-agent resume   # 최신 대화 이어서 실행
cursor-agent --resume="chat-id-here"   # 특정 대화 이어서 실행

Cursor+1

규칙 및 맥락 사용자 설정

  • CLI는 IDE와 동일한 방식으로 .cursor/rules 디렉터리에 규칙 파일을 두어 Agent 작업 방식을 커스터마이징할 수 있습니다. Cursor
  • 프로젝트 루트에 AGENT.md 또는 CLAUDE.md 파일이 있으면 자동으로 규칙으로 사용됩니다. Cursor
  • **MCP(Model Context Protocol)**를 지원하며, mcp.json 설정 파일 또한 자동으로 반영됩니다. Cursor

인터페이스 & 사용성

  • 탐색(Navigation): 이전 메시지로 돌아가려면 ↑ 키를 사용하고, 파일 간 전환은 ←, → 키로 가능합니다. Cursor
  • 변경 내용 검토(Review): Ctrl+R 로 변경 내용을 확인하고, 필요 시 I로 후속 지시를 입력할 수 있습니다. Cursor
  • 컨텍스트 조정: @로 포함할 파일/폴더 선택, /compress 명령으로 컨텍스트 정리를 할 수 있습니다. Cursor
  • 명령 승인: 터미널 명령 실행 전 Y 또는 N으로 승인 여부를 확인받습니다. Cursor

Shell 명령과 에디터 통합

  • cursor, code 명령어로 터미널에서 파일 또는 폴더를 열 수 있습니다. code는 VSCode와 호환됩니다. Cursor
  • 사용 방법: 
cursor path/to/file.js
cursor ./my-project/
cursor -n  # 새 창 열기
cursor -w  # 창이 닫힐 때까지 대기

Cursor

  • IDE 내에서 “Install ‘cursor’ to shell” 또는 “Install ‘code’ to shell” 명령을 통해 해당 명령어들을 PATH에 추가할 수 있습니다. Cursor – Community Forum

요약 테이블

항목설명
설치 명령curl https://cursor.com/install -fsS | bash
인터랙티브 모드cursor-agent 또는 cursor-agent "프롬프트"
비인터랙티브 모드cursor-agent -p ... --model ... --output-format ...
세션 관리ls, resume, --resume 옵션 사용 가능
규칙 설정.cursor/rules, AGENT.md, mcp.json 지원
내비게이션 & 리뷰↑/↓/←/→, Ctrl+R, I 사용 가능
컨텍스트 조정@ 선택, /compress 실행
Shell 통합 명령cursor, code 사용 가능
안전 승인각 명령 실행 전 Y/N 확인 가능
자동 업데이트기본 활성화, cursor-agent update로 수동 업데이트 가능

사용자 시선의 평가

Reddit 사용자 의견(간단 인용):

“CLI is basically Cursor without the editor… you can use it ‘headless’ in your CI environment.”
Reddit