Cursor CLI 비대화 모드 (스크립트와 CI)

대화 모드: AI가 질문하고 Y/N을 누르며 단계별로 확인 — 페어 프로그래밍처럼. 비대화 모드: 지시 하나를 주면 실행 완료, 아무도 키를 누를 필요 없음. 스크립트나 CI 파이프라인에 최적 — AI에게 야근을 시키고 다른 일을 할 수 있습니다.

기본 사용법

--no-interactive (또는 축약형 -n) 추가:

cursor agent "프로젝트에 .editorconfig 추가해줘" --no-interactive

• AI가 입력을 기다리지 않고 직접 실행합니다
• 적합한 용도: 예측 가능하고 반복 가능한 작업 (주석 추가, lint 수정, 형식 통일 등)

스크립트에서 사용

#!/bin/bash
cd /path/to/project
cursor agent "CONTRIBUTING.md에 따라 린터를 실행하고 수정해줘" --no-interactive

• 코드 정리 자동화·간단한 리팩터링·주석 추가에 사용 가능
• 주의: CI 환경에서는 Cursor 계정 인증이 필요합니다 (cursor auth login 먼저 실행하거나 토큰 사용) — 그렇지 않으면 AI가 작동할 수 없습니다

모델 지정 (선택사항)

특정 모델을 사용하고 싶을 때:

cursor agent "이 주석을 다시 작성해줘" --model claude-3-5-sonnet --no-interactive

사용 가능한 모델 이름은 공식 문서에서 확인하세요 — 모델 ID를 임의로 만들지 마세요.

클라우드에서 실행 (-c)

무거운 작업으로 터미널을 점유하고 싶지 않을 때? -c로 클라우드에 맡기세요:

cursor agent "전체 레포지토리를 분석하고 아키텍처 문서를 생성해줘" -c

• -c는 대화를 클라우드 Agent에게 넘겨서 계속 실행합니다
• 터미널을 닫아도 됩니다 — 나중에 대화에 다시 연결할 수 있습니다. "백그라운드 실행"처럼 AI가 백그라운드에서 대신 작업합니다.

요약

• 비대화: --no-interactive 또는 -n 추가, 키 입력 불필요
• 스크립트/CI: 같은 명령어 — 환경에서 Cursor에 로그인 가능한지 확인
• 모델 지정: --model 모델명
• 장시간 작업: -c로 클라우드에 맡기기, 종료해도 계속 진행

다음: 05-tips — 일반적인 실수를 피하는 팁과 자주 묻는 질문