​
프롬프팅

최상의 결과를 얻으려면 의도를 명확하게 표현하는 것이 좋다. 예를 들어, “코드를 작성하지 마”라는 프롬프트를 사용해서 에이전트가 파일을 편집하지 않도록 할 수 있다. 이는 보통 작업을 구현하기 전에 계획을 세울 때 도움이 된다. 에이전트는 현재 파일 작업, 검색, 셸 명령 실행을 위한 도구들을 갖고 있다. IDE 에이전트와 마찬가지로 더 많은 도구들이 추가되고 있다.

​
MCP

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

​
규칙

CLI 에이전트는 IDE와 동일한 규칙 시스템을 지원해. .cursor/rules 디렉토리에 규칙을 만들어서 에이전트에게 컨텍스트와 가이드를 제공할 수 있어. 이 규칙들은 설정에 따라 자동으로 로드되고 적용되어서, 프로젝트의 다른 부분이나 특정 파일 타입에 맞게 에이전트의 동작을 커스터마이징할 수 있게 해줘.
CLI는 프로젝트 루트에 있는 AGENT.md와 CLAUDE.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)할지 물어봐.

​
비대화형 모드

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