Cursor CLI 사용법: 터미널에서 Cursor 에이전트 쓰기 (설치·명령어·CI 자동화, 2026)

핵심 요약: Cursor CLI는 에디터 없이 터미널에서 Cursor 에이전트를 쓰는 도구입니다. 설치 후 `agent` 한 단어로 대화형 에이전트가 뜨고, 에디터와 같은 Agent/Plan/Ask 모드, 같은 Rules, 같은 MCP 설정을 공유합니다. 핵심 활용처는 셋: SSH 서버 등 에디터가 없는 환경, `-p` 플래그의 헤드리스 모드로 CI·스크립트 자동화, 그리고 `&` 프리픽스로 클라우드 에이전트에 백그라운드 위임. "Cursor 구독으로 쓰는 터미널 에이전트"라는 점에서 Claude Code의 영역과 겹치지만, 이미 Cursor Pro라면 추가 비용 없이 쓸 수 있다는 것이 포인트입니다.

이 글에서 다루는 내용: 설치와 시작, 핵심 사용법, 헤드리스·백그라운드 활용, Claude Code와의 관계.

※ 2026년 8월 5일 갱신: 제목을 검색 의도에 맞게 다듬고 위치 관계 도식을 추가했습니다. 7월 출시된 Router(모델 자동 라우팅)가 CLI에서도 동작한다는 점(Teams·Enterprise 기준)도 반영.

※ 2026년 9월 6일 갱신: "Cursor CLI 사용법"을 찾는 분이 많아 제목·도입을 그 흐름에 맞췄습니다. 이 글은 "왜·무엇"의 개요이고, 명령어 레퍼런스와 복붙용 CI 스크립트 예제는 명령어·실전 예제 총정리에 따로 모았습니다.

설치와 시작

curl https://cursor.com/install -fsSL | bash
agent login   # Cursor 계정 연결
agent status  # 계정·플랜 확인
agent        # 프로젝트 폴더에서 대화형 시작

프로젝트 폴더에서 `agent`를 실행하면 에디터의 Agent와 같은 에이전트가 터미널에서 뜹니다. 기존 .cursor/rules와 mcp.json을 그대로 읽으므로 별도 설정이 필요 없습니다.

기본 사용법

대화형에서 자연어로 지시하면 되고, Shift+Tab으로 Agent/Plan/Ask 모드 전환(/plan, /ask 슬래시 명령으로도 가능), /로 명령 메뉴(모델 전환, 스킬, MCP 도구)가 열립니다. 단발 실행은 `agent chat "버그 하나 찾아서 고쳐줘"` 형태로도 됩니다. 모델은 `agent models`로 확인하고 `--model` 플래그로 지정할 수 있습니다.

활용 1: 헤드리스 모드 — CI와 스크립트

agent -p "변경된 파일의 린트 오류를 수정하고 결과를 요약해줘"

-p(print) 플래그는 대화 없이 실행하고 결과만 출력하는 헤드리스 모드로, GitHub Actions 등 CI 파이프라인에 넣을 수 있습니다. 예: PR마다 자동 문서 갱신, 릴리스 노트 초안 생성. CI에서 쓸 때는 권한 범위와 사용량(팀 온디맨드에서 차감)을 먼저 설계하세요.

활용 2: & 백그라운드 — 클라우드 위임

메시지 앞에 &를 붙이면 클라우드 에이전트가 별도 브랜치에서 비동기로 작업합니다. 로컬 터미널은 바로 자유로워지고, 결과는 나중에 확인하는 방식 — Cloud Agents의 터미널 진입로인 셈입니다.

Claude Code와의 관계: 겹치지만 셈법이 다릅니다

둘 다 터미널 에이전트라 영역이 겹칩니다. 실용적인 정리: 이미 Cursor Pro만 구독 중이라면 CLI로 터미널 위임까지 커버해보고, 부족할 때 Claude Code를 검토하세요. 둘 다 구독 중(조합 워크플로)이라면 덩어리 위임은 완주율이 검증된 Claude Code, Cursor CLI는 SSH 환경·CI 자동화처럼 "Cursor 설정(Rules·MCP)을 그대로 쓰고 싶은 자동화"에 배치하는 것이 자연스럽습니다.

자주 묻는 질문 (FAQ)

Q. CLI 사용량은 에디터와 별도인가요?

A. 아니요, 같은 구독의 포함 사용량을 공유합니다. CI에서 대량 실행하면 팀 사용량이 빠르게 소모되니 지출 한도 설정을 확인하세요.

Q. 에디터 없이 CLI만으로 개발이 가능한가요?

A. 서버 위 응급 수정 같은 상황엔 충분합니다. 다만 diff 검토·세부 수정은 에디터가 편하므로, CLI는 "에디터가 없는 곳"과 "자동화"용으로 보는 것이 정확합니다.

Q. Windows에서도 되나요?

A. WSL 환경에서 쓰는 것이 매끄럽습니다. 네이티브 지원 상태는 공식 문서에서 확인하세요.

한눈에 보는 요약

설치 한 줄, 시작은 `agent`, 자동화는 `-p`, 위임은 `&`. Rules·MCP를 에디터와 공유하는 것이 최대 장점이고, 이미 Cursor 구독자라면 공짜로 얻는 터미널 에이전트입니다.

함께 보면 좋은 글

Cursor CLI 명령어·실전 예제 총정리
Cursor Cloud Agents 사용법
Cursor vs Claude Code
Cursor + Claude Code 조합 워크플로

참고 자료

Cursor CLI 공식 문서
Cursor CLI 발표 (공식 블로그)