메인 콘텐츠로 건너뛰기

프롬프트 작성

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

MCP

Agent는 확장 기능과 통합을 위해 MCP(Model Context Protocol)을 지원해. CLI가 mcp.json 구성 파일을 자동으로 감지하고 따르니까, IDE에서 설정해 둔 MCP 서버와 도구를 그대로 쓸 수 있어.

규칙

CLI 에이전트는 IDE와 동일한 규칙 시스템을 지원해. .cursor/rules 디렉터리에 규칙을 만들어 에이전트에 컨텍스트와 가이드라인을 제공할 수 있어. 이 규칙들은 설정에 따라 자동으로 로드되고 적용되니까, 프로젝트의 다양한 부분이나 특정 파일 유형에 맞춰 에이전트 동작을 커스터마이즈할 수 있어.
CLI는 프로젝트 루트에 있는(있다면) AGENTS.mdCLAUDE.md도 읽어서 .cursor/rules와 함께 규칙으로 적용해.

Agent 사용하기

이전 메시지는 위쪽 화살표(Arrow-Up)로 불러와서 순환할 수 있어.

검토

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

컨텍스트 선택

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

기록

이전 컨텍스트를 불러오려면 --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는 전체 쓰기 권한을 가지고 있어.
I