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

세 가지 모드, 한 문장으로 구별: 누가 코드를 건드릴 수 있고, 누가 말만 할 수 있는가. 이걸 이해하면 모드 선택이 쉬워집니다.

한 문장 비교

세 동료를 상상해 보세요: Agent는 "맡겨주면 바로 해드립니다"라고 하는 사람, Plan은 "먼저 제안서를 써드릴게요, 검토해 주세요"라고 하는 사람, Ask는 "답변만 드리고 파일은 건드리지 않겠습니다"라고 하는 사람 — 올바른 사람을 선택하면 수고가 절반으로 줄어듭니다.

Agent 모드 (기본값)

사용 사례: AI가 직접 코드 편집·기능 추가·리팩터링을 하도록 합니다. 결과물이 필요하고 토론은 불필요할 때.

cursor agent "로그인을 JWT 방식으로 변경해줘"

• 파일을 읽고 편집하며 명령을 실행할 수도 있음
• 각 단계를 수락하거나 거부할 수 있음 — 제어권은 여러분에게 있음

Plan 모드

사용 사례: 어떻게 접근할지 모르거나, AI가 한 번에 너무 많이 바꿀까 걱정될 때? 진행하기 전에 계획을 확인하세요.

cursor agent --plan "전체 API 레이어를 리팩터링해줘"

• AI가 몇 가지 질문을 하고 접근 방법을 제안합니다
• 동의 후에만 실행됩니다 — 놀라운 일은 없습니다

언제 사용: 큰 변경 사항이나 "커밋 전에 전체를 파악하고 싶다"는 상황.

Ask 모드 (읽기 전용)

사용 사례: "이 코드가 뭐 하는 거야"나 "더 좋은 작성법이 있어?"를 물어보고 싶을 때 — 절대로 파일을 변경하지 않았으면 할 때.

cursor ask "src/auth.ts 의 로직은 무엇인가요?"

• 읽기·분석·답변만 — 쓰기는 절대 없음
• CI나 "확인만 하고 수정은 하지 않을" 환경에 최적

대화 중 모드 전환

이미 cursor agent 대화 안에 있나요? 슬래시 명령어로 즉시 전환:

• /plan → Plan 모드로 (먼저 계획)
• /ask → Ask 모드로 (읽기 전용)

종료 후 재시작할 필요 없음 — 부드럽게 전환됩니다.

요약

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

다음: 04-non-interactive — 스크립트와 CI를 위한 비대화 모드