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

3 min read

대화형 모드: AI가 질문하고, Y/N으로 단계별 확인 — 페어 프로그래밍처럼. 비대화형 모드: 지시 한 번 주면 끝까지 실행하고, 누구도 키를 누를 필요 없음. 스크립트나 CI 파이프라인에 적합 — AI에게 맡겨 두고 다른 일을 하면 됨.

기본 사용

--no-interactive(줄여서 -n)를 붙입니다:

cursor agent "Add a .editorconfig to the project" --no-interactive
  • AI가 입력을 기다리지 않고 바로 실행함
  • 적합한 경우: 예측 가능하고 반복적인 작업(주석 추가, lint 수정, 규칙에 맞게 포맷 등)

스크립트에서 사용

#!/bin/bash
cd /path/to/project
cursor agent "Run the linter and fix issues per CONTRIBUTING.md" --no-interactive
  • 자동 코드 정리, 단순 리팩터, 주석 추가 등에 사용 가능
  • 참고: CI 환경에서는 Cursor 계정 인증이 필요함(먼저 cursor auth login 실행 또는 토큰 사용) — 없으면 AI가 동작하지 않음

모델 지정(선택)

특정 모델로 실행하고 싶을 때:

cursor agent "Rewrite this comment" --model claude-3-5-sonnet --no-interactive

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

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

부담 큰 작업으로 터미널을 묶어 두고 싶지 않다면 -c로 클라우드에 넘길 수 있습니다:

cursor agent "Analyze the entire repo and generate an architecture document" -c
  • -c는 대화를 클라우드 Agent에게 넘겨 계속 진행하게 함
  • 터미널을 닫아도 됨 — 나중에 같은 대화에 다시 연결할 수 있음. “백그라운드 실행”과 비슷하지만, AI가 당신 대신 백그라운드에서 일하는 것

요약

  • 비대화형: --no-interactive 또는 -n을 붙이면 아무도 키를 누를 필요 없음
  • 스크립트/CI: 같은 명령 — 환경에서 Cursor 로그인이 가능한지만 확인
  • 모델 지정: --model model-name
  • 긴 작업: -c로 클라우드에 맡기면, 종료해도 실행은 계속됨

다음: 05-tips — 자주 걸리는 함정을 피하는 팁과 FAQ