# Agent Mode (/ko/docs/verdent-manager/advanced-features/agent-mode)

> 모든 작업을 완전히 투명하게 보여주는 에이전트 기반 작업 실행



Agent Mode는 에이전트가 사용자의 지시에 따라 직접 작업을 수행하는 Verdent의 기본 실행 모드입니다. 구조화된 플래닝 세션보다, Agent Mode는 완전한 투명성을 유지하면서 빠른 실행을 우선합니다.

## 배울 내용 [#배울-내용]

* 언제 Agent Mode를 선택하는 것이 적합한지
* 실행 워크플로가 어떻게 동작하는지
* 권한과 가시성을 관리하는 방법

***

## Agent Mode가 유용한 경우 [#agent-mode가-유용한-경우]

Agent Mode는 해야 할 일이 명확할 때 가장 잘 맞습니다.

| 시나리오         | 상황                                                      | Verdent가 도움이 되는 방식                          |
| ------------ | ------------------------------------------------------- | ------------------------------------------- |
| **명확한 요구사항** | 구현하려는 내용을 정확히 알고 있습니다. 작업의 범위가 잘 정의되어 있고 구체적인 결과가 있습니다. | 에이전트가 바로 구현을 진행합니다. 플래닝 오버헤드 없이 결과에 집중합니다.  |
| **빠른 반복**    | 결과를 바탕으로 점진적으로 변경하는 빠른 피드백 루프 안에 있습니다.                  | 빠른 실행 주기를 통해 변경 사항을 즉시 확인하고 방향을 조정할 수 있습니다. |
| **단순한 작업**   | 버그 수정, 작은 기능, 코드 정리, 또는 범위가 분명한 리팩터링입니다.                | 에이전트가 불필요한 왕복 없이 작업을 효율적으로 완료합니다.           |

***

## Agent Mode 워크플로 [#agent-mode-워크플로]

<Steps>
  <Step title="요청 제출">
    원하는 작업을 설명합니다. Agent Mode에서는 명확하고 구체적인 지시가 가장 잘 동작합니다.
  </Step>

  <Step title="에이전트가 작업 수행">
    Verdent가 즉시 구현을 시작합니다. 파일 수정, 도구 사용, 진행 상황이 실시간으로 표시됩니다.
  </Step>

  <Step title="권한 요청">
    일부 작업에는 승인이 필요합니다. 검토하고 승인하면 계속 진행됩니다.
  </Step>

  <Step title="결과 확인">
    무엇이 왜 변경되었는지 완전히 확인할 수 있는 상태로 작업이 완료됩니다.
  </Step>
</Steps>

***

## 주요 특징 [#주요-특징]

| 특징          | 설명                                            |
| ----------- | --------------------------------------------- |
| **기본 모드**   | Plan Mode로 전환하지 않는 한 새 작업은 Agent Mode에서 시작됩니다 |
| **직접 실행**   | 에이전트가 긴 플래닝보다 구현을 바로 진행합니다                    |
| **완전한 가시성** | 파일 수정, 도구 사용, 진행 상황이 실시간으로 표시됩니다              |
| **인라인 확인**  | 질문은 구조화된 설문이 아니라 채팅 안에 자연스럽게 표시됩니다            |

***

## Agent Mode와 Plan Mode 비교 [#agent-mode와-plan-mode-비교]

작업의 명확성과 복잡도에 따라 선택합니다.

<Tabs>
  <Tab title="Agent Mode를 사용할 때">
    Agent Mode는 다음에 적합합니다.

    * 명확하고 잘 정의된 요구사항
    * 단순한 구현 작업
    * 빠른 반복과 피드백 루프
    * 접근 방식에 확신이 있는 작업
    * 버그 수정과 작은 기능
  </Tab>

  <Tab title="Plan Mode를 사용할 때">
    다음의 경우 Plan Mode로 전환합니다.

    * 복잡한 여러 단계의 기능
    * 아직 완성되지 않았거나 계속 발전 중인 아이디어
    * 아키텍처 결정
    * 구현 전에 탐색이 필요한 작업
    * 구조화된 요구사항 확인을 원할 때
  </Tab>
</Tabs>

***

## Agent Mode의 권한 [#agent-mode의-권한]

Agent Mode는 작업을 직접 실행하지만, 일부 작업에는 여전히 명시적인 승인이 필요합니다.

* 예상 범위를 벗어난 파일 수정
* 파괴적인 작업
* 특정 도구 실행
* 큰 부작용이 있는 작업

<Note>
  권한 요청은 일상적인 작업의 실행 속도를 유지하면서 의도하지 않은 변경을 방지합니다.
</Note>

***

## 자주 묻는 질문 [#자주-묻는-질문]

<AccordionGroup>
  <Accordion title="Agent Mode가 기본값인가요?">
    예. 새 작업은 Agent Mode에서 시작됩니다. 구조화된 플래닝이 필요할 때 Plan Mode로 전환합니다.
  </Accordion>

  <Accordion title="Agent Mode에서 에이전트가 질문하나요?">
    예, 필요할 때 질문합니다. 질문은 구조화된 설문이 아니라 채팅 안에 인라인으로 표시됩니다. 작업이 충분히 명확하면 에이전트가 질문 없이 진행할 수도 있습니다.
  </Accordion>

  <Accordion title="Plan Mode로 어떻게 전환하나요?">
    `Shift+Tab`를 누르면 모드가 전환됩니다(macOS: `Cmd+.`, Windows: `Ctrl+.`). 모드 전환은 특정 시점에서만 가능하며, 실행 중에는 사용할 수 없습니다.
  </Accordion>

  <Accordion title="Agent Mode는 모든 확인을 건너뛰나요?">
    아니요. 일부 작업에는 여전히 승인이 필요합니다. Agent Mode는 중요한 변경에 대한 안전성은 유지하면서 일상적인 작업의 마찰을 줄입니다.
  </Accordion>

  <Accordion title="대신 Plan Mode를 언제 사용해야 하나요?">
    복잡한 기능, 아키텍처 결정, 또는 구현을 시작하기 전에 요구사항을 탐색하고 다듬고 싶을 때 Plan Mode를 사용합니다.
  </Accordion>
</AccordionGroup>