Cursor CLI 세 가지 모드: Agent / Plan / Ask

세 모드를 한 문장으로 구분하면: 코드를 만질 수 있는 건 누구고, 말만 할 수 있는 건 누구인지. 이걸 알면 적절한 모드를 고르기 쉽습니다.

한 문장 비교

세 동료로 비유하면: Agent는 “맡겨, 내가 할게”, Plan은 “먼저 제안서 쓸게 검토해줘”, Ask는 “답만 할게, 파일은 안 건드려” — 맞는 사람을 고르면 고생이 반으로 줄어듭니다.

Agent 모드(기본)

용도: AI가 코드를 직접 수정·기능 추가·리팩터링하게 할 때. 논의보다 결과가 필요할 때.

cursor agent "Change login to use JWT"

• 파일을 읽고, 수정하고, 명령을 실행할 수 있음
• 각 단계를 수락/거절할 수 있음 — 주도권은 당신

Plan 모드

용도: 접근 방법이 불확실하거나, AI가 한꺼번에 너무 많이 바꿀까 걱정될 때. 승인 전에 계획을 먼저 봄.

cursor agent --plan "Refactor the entire API layer"

• AI가 질문하고 접근 방식을 제안함
• 동의한 경우에만 실행 — 예상 밖 변경 없음

언제 쓸지: 대규모 변경이나 “커밋 전에 명확히 보고 싶을 때”.

Ask 모드(읽기 전용)

용도: “이 코드가 뭐 하는 거지?” “더 나은 방법 있을까?”만 물어보고, 파일은 절대 바꾸고 싶지 않을 때.

cursor ask "What is the logic in src/auth.ts?"

• 읽기·분석·답변만 — 쓰기는 하지 않음
• CI나 “수정 없이 검사만 하고 싶은” 환경에 적합

대화 중 모드 전환

이미 cursor agent 대화 중이라면 슬래시 명령으로 즉시 전환할 수 있습니다:

• /plan → Plan 모드(계획 먼저, 실행 나중)
• /ask → Ask 모드(읽기 전용, 자유롭게 질문)

종료하고 다시 시작할 필요 없습니다. 달리다가 기어만 바꾸는 것과 같습니다.

요약

• Agent: 실행하고 파일 수정 — 결과가 필요할 때
• Plan: 먼저 계획, 승인 후 실행 — 안전하게 진행하고 싶을 때
• Ask: 질문만, 읽기 전용 — 변경 없이 답만 필요할 때

다음: 04-non-interactive — 스크립트·CI용 비대화형 모드, AI를 무인으로 실행