프롬프트 작성

최상의 결과를 얻으려면 의도를 명확히 밝혀줘. 예를 들어, 에이전트가 어떤 파일도 수정하지 않게 하려면 “코드 작성 금지” 같은 프롬프트를 사용할 수 있어. 보통 구현 전에 작업을 계획할 때 유용해. 에이전트는 현재 파일 작업, 검색, 셸 명령 실행을 위한 도구를 갖추고 있어. IDE 에이전트처럼 더 많은 도구가 계속 추가되고 있어.

MCP

Agent는 확장 기능과 통합을 위해 MCP (Model Context Protocol)를 지원해. CLI는 네 mcp.json 구성 파일을 자동으로 감지하고 이를 반영해서, IDE에 설정해 둔 것과 동일한 MCP 서버와 도구를 사용할 수 있게 해줘.

Rules

CLI 에이전트는 IDE와 동일한 rules system을 지원해. .cursor/rules 디렉터리에 규칙을 만들어 에이전트에 컨텍스트와 가이던스를 제공할 수 있어. 이 규칙들은 설정에 따라 자동으로 로드되고 적용되며, 프로젝트의 다양한 영역이나 특정 파일 유형에 맞춰 에이전트 동작을 커스터마이즈할 수 있게 해줘.
CLI는 프로젝트 루트에 AGENTS.mdCLAUDE.md가 있으면 이를 읽어 .cursor/rules와 함께 규칙으로 적용해.

Agent과 함께 작업하기

이전 메시지는 위쪽 화살표(Arrow-Up)로 확인할 수 있고, 위아래로 순환해서 살펴볼 수 있어.

검토

Ctrl+R로 변경 사항을 검토해. 후속 지시를 추가하려면 I를 눌러. 스크롤은 Arrow-Up/Arrow-Down, 파일 전환은 Arrow-Left/Arrow-Right를 써.

컨텍스트 선택

@로 컨텍스트에 포함할 파일과 폴더를 선택해. /compress를 실행해 컨텍스트 창의 공간을 확보할 수 있어. 자세한 내용은 Summarization을 참고해.

History

기존 스레드의 컨텍스트를 불러오려면 --resume [thread id]로 이어서 시작해. 가장 최근 대화를 재개하려면 cursor-agent resume을 써. 이전 대화 목록을 보려면 cursor-agent ls를 실행해.

명령 승인

터미널 명령을 실행하기 전에 CLI가 실행을 승인(Y)할지 거부(N)할지 물어봐.

비대화형 모드

-p 또는 --print를 사용해 Agent를 비대화형 모드로 실행해. 그러면 콘솔에 응답이 출력돼. 비대화형 모드에서는 상호작용 없이 Agent를 호출할 수 있어. 스크립트나 CI 파이프라인 등에 통합하기 좋아. --output-format을 함께 써서 출력 형식을 제어할 수 있어. 예를 들어 스크립트에서 파싱하기 쉬운 구조화된 출력이 필요하면 --output-format json을, 일반 텍스트 출력이 필요하면 --output-format text를 써.
비대화형 모드에서 Cursor는 전체 쓰기 권한이 있어.