# 구성 최적화 (/ko/docs/verdent-for-vscode/configuration/tuning)

> 워크플로에 맞게 Verdent 최적화하기



워크플로 요구 사항에 따라 속도, 비용, 철저함의 균형을 맞추도록 Verdent for VS Code를 최적화합니다. 최적의 성능을 위해 모델 프리셋, 실행 모드, 컨텍스트 관리 전략을 설정합니다.

### 최적화 영역 [#최적화-영역]

* 비용과 성능의 균형을 위한 모델 프리셋 선택
* 워크플로 효율을 위한 실행 모드 설정
* 대규모 코드베이스를 위한 컨텍스트 관리
* 프로젝트별 및 워크스페이스 수준 사용자 지정

***

## 워크플로에 맞게 설정 조정하기 [#워크플로에-맞게-설정-조정하기]

### 모델 프리셋 선택 [#모델-프리셋-선택]

작업 복잡도와 예산에 따라 적절한 모델 프리셋을 선택합니다.

| 프리셋              | 비용                        | 비용 효율                   | 적합한 용도                   |
| ---------------- | ------------------------- | ----------------------- | ------------------------ |
| **Efficiency**   | Balance 대비 약 0.3배(70% 절감) | Sonnet보다 3.2배 더 효율적     | 간단한 작업, 빠른 수정, 빠른 프로토타이핑 |
| **Balance**(기본값) | 기준 1배                     | 기준 1배                   | 일반 개발 작업, 일상적인 코딩        |
| **Performance**  | Balance 대비 1-2배           | 효율 0.5배(비용 2배, 1M 컨텍스트) | 복잡한 아키텍처 결정, 정교한 리팩터링    |

**추가 모델:**

* **Claude-4.5-sonnet:** 균형 잡힌 범용 모델(기준 1배)
* **Claude-4.5-sonnet-1m:** 복잡한 작업을 위한 확장 컨텍스트(효율 0.5배, 입력이 200k 토큰을 초과하면 비용 2배)
* **Claude-4.5-haiku:** 가장 빠르고 가장 경제적(Sonnet보다 3.2배 더 효율적)
* **GPT-5 / GPT-5-codex:** 추론과 창의성 중심(Beta, Sonnet보다 1.3배 더 효율적)
* **Minimax-m2:** 빠르고 비용 효율적(Beta, 11월 10일까지 무료)

### 실행 모드 설정 [#실행-모드-설정]

<Tabs>
  <Tab title="권한 건너뛰기(속도)">
    * 승인 프롬프트 없이 완전한 자율 실행
    * 권한 요청으로 인한 중단 없음
    * 위험도가 가장 높음 - 자동화 환경에서만 사용하세요
  </Tab>

  <Tab title="자동 실행(균형)">
    * 명령은 승인이 필요하고, 파일 작업은 자동으로 처리
    * 권한 프롬프트 감소
    * 위험한 작업에 대한 안전성을 유지하면서 위험을 낮춤
  </Tab>

  <Tab title="수동 승인(철저함)">
    * 모든 작업에 승인 필요
    * 완전한 가시성과 제어
    * 가장 느리지만 가장 안전함 - 학습 및 프로덕션 코드에 가장 적합
  </Tab>

  <Tab title="플랜(리뷰)">
    * 실행 전 전략적 계획 수립
    * 읽기 전용 분석 단계
    * 변경 전에 검토하고 승인
  </Tab>
</Tabs>

### Think Hard Mode [#think-hard-mode]

복잡한 추론 작업에 활성화합니다.

* **철저함:** 정교한 문제를 위한 최대 추론 깊이
* **속도:** 확장된 사고 예산 때문에 더 느림
* **적합한 용도:** 아키텍처 결정, 복잡한 디버깅, 정교한 분석

***

## 속도와 철저함의 트레이드오프 [#속도와-철저함의-트레이드오프]

작업 요구 사항에 따라 실행 속도와 분석 깊이의 균형을 맞춥니다.

<Tabs>
  <Tab title="속도가 중요한 경우">
    **설정:**

    * **모델:** Efficiency 프리셋(Claude-4.5-haiku)
    * **권한 모드:** Auto-Run Mode
    * **실행 모드:** 직접 실행에는 Agent Mode
    * **사용 사례:** 빠른 수정, 반복적인 작업, 간단한 작업

    **이점:**

    * 가장 빠른 응답 시간
    * 최소한의 중단
    * Balance 프리셋 대비 비용 70% 절감
  </Tab>

  <Tab title="철저함이 중요한 경우">
    **설정:**

    * **모델:** Performance 프리셋(Claude-4.5-sonnet-1m)
    * **권한 모드:** Manual Accept Mode
    * **실행 모드:** 전략적 리뷰에는 Plan Mode
    * **Think Hard:** 정교한 추론을 위해 활성화
    * **사용 사례:** 복잡한 기능, 프로덕션 코드, 아키텍처 결정

    **이점:**

    * 최대 컨텍스트 창(1M 토큰)
    * 완전한 가시성과 제어
    * 복잡한 문제를 위한 깊은 추론
    * 실행 전 리뷰
  </Tab>

  <Tab title="하이브리드 접근">
    대부분의 사용자는 설정을 상황에 맞게 전환할 때 더 큰 이점을 얻습니다.

    * **빠른 수정:** Efficiency + Agent Mode
    * **복잡한 기능:** Balance/Performance + Plan Mode
    * **탐색:** 전략 수립에는 Plan Mode, 이후 실행에는 Agent Mode

    **전략:** 모든 작업에 하나의 설정을 적용하지 말고 작업 유형에 맞게 설정을 조정합니다.
  </Tab>
</Tabs>

<Tip>
  신뢰할 수 있는 프로젝트에서는 Auto-Run Mode를 사용해 권한 프롬프트를 줄이면서도 위험한 작업에 대한 안전성을 유지하세요. 중요한 보호 장치를 희생하지 않고 워크플로가 간소화됩니다.
</Tip>

***

## 워크스페이스 수준 설정 [#워크스페이스-수준-설정]

Verdent는 팀 전체의 일관성을 위해 프로젝트별 및 워크스페이스별 설정을 지원합니다.

### 프로젝트별 설정 [#프로젝트별-설정]

**프로젝트 규칙(AGENTS.md):**

* **위치:** 프로젝트 루트 디렉터리 또는 워크스페이스 폴더
* **범위:** 현재 프로젝트에만 적용
* **버전 관리:** 팀 전체 표준으로 사용하려면 git에 커밋
* **내용:** 코딩 표준, 테스트 요구 사항, 아키텍처 패턴

**예시:**

```markdown filename="AGENTS.md"
# Project Rules

## Code Standards
- Use TypeScript strict mode
- Generate unit tests for all new functions
- Follow MVC pattern

## Testing
- All endpoints require input validation
- Run tests before committing
```

### VS Code 워크스페이스 설정 [#vs-code-워크스페이스-설정]

워크스페이스 수준에서 확장 설정을 구성합니다.

**위치:** 워크스페이스 루트의 `.vscode/settings.json`

**예시:**

```json filename=".vscode/settings.json"
{
  "verdent.enableCheckpoints": true
}
```

### 설정 우선순위 [#설정-우선순위]

설정이 충돌하면 Verdent는 다음 우선순위를 적용합니다.

1. **프로젝트 규칙(AGENTS.md)** - 가장 높은 우선순위(프로젝트별)
2. **워크스페이스 설정** - VS Code 워크스페이스 수준 설정
3. **사용자 규칙(VERDENT.md)** - 전역 사용자 선호도
4. **기본 설정** - Verdent의 내장 기본값

***

## 프로젝트별 사용자 지정 [#프로젝트별-사용자-지정]

### 대규모 프로젝트를 위한 컨텍스트 관리 [#대규모-프로젝트를-위한-컨텍스트-관리]

<Tabs>
  <Tab title="서브에이전트">
    * 별도 컨텍스트 창을 가진 서브에이전트에 복잡한 작업을 위임
    * 전체 과정이 아니라 서브에이전트 결과만 기본 컨텍스트를 소비
    * 구현 세부 정보로 기본 컨텍스트가 가득 차는 것을 방지
  </Tab>

  <Tab title="파일 선택">
    * `@filename`를 사용해 관련 파일만 명시적으로 추가
    * 전체 프로젝트를 불필요하게 컨텍스트에 로드하지 않음
    * 특정 컴포넌트를 대상으로 집중 분석
  </Tab>

  <Tab title="작업 쪼개기">
    * 큰 작업을 더 작고 완료 가능한 단위로 나눔
    * 서로 다른 기능이나 컴포넌트에는 새 세션 시작
    * 자연스러운 중단 지점으로 컨텍스트 고갈 방지
  </Tab>

  <Tab title="Plan Mode">
    * 실행 컨텍스트를 소비하기 전에 접근 방식 검토
    * 잘못된 구현에 컨텍스트를 낭비하는 일을 줄임
    * Plan Mode에는 별도의 컨텍스트 관리가 있음
  </Tab>
</Tabs>

### 성능 최적화 [#성능-최적화]

**체크포인트를 선택적으로 활성화:**

`verdent.enableCheckpoints` 설정은 버전 관리를 위해 git을 사용합니다.

* 매우 큰 리포지터리에서는 성능에 영향을 줄 수 있음
* 체크포인트 기능이 필요할 때만 활성화
* 대규모 코드베이스에서 최대 성능이 필요하면 비활성화

<Tip>
  중요한 작업에만 체크포인트를 선택적으로 활성화하세요. 과도한 체크포인트는 가치를 더하지 않고 워크플로를 느리게 만듭니다.
</Tip>

**모델 선택:**

* 간단하고 독립적인 작업에는 Efficiency 프리셋(Haiku) 사용
* 컨텍스트가 많이 필요한 작업에는 Performance 프리셋(Sonnet-1M) 사용
* 일반 작업에는 Balance 프리셋 사용

**실행 모드:**

* Auto-Run Mode는 권한 프롬프트가 소비하는 컨텍스트를 줄임
* Skip Permissions Mode는 자동화 환경에서 효율을 극대화

<Note>
  여러 워크스페이스를 사용하는 경우 워크스페이스를 전환할 때 적절한 프로젝트 규칙이 자동으로 적용됩니다. 수동으로 설정을 전환할 필요가 없습니다.
</Note>

<Tip>
  여러 워크스페이스 설정을 사용하면 프로젝트 유형, 개발과 프로덕션, 모노레포와 마이크로서비스에 따라 설정을 최적화할 수 있습니다.
</Tip>

***

## 함께 보기 [#함께-보기]

<CardGroup cols="2">
  <Card title="구성 설정" icon="gear" href="/docs/verdent-for-vscode/configuration/settings">
    전체 구성 옵션과 모델 선택
  </Card>

  <Card title="리소스 모니터링" icon="chart-line" href="/docs/verdent-for-vscode/resource-management/monitoring">
    성능을 모니터링하고 토큰 사용량 최적화
  </Card>
</CardGroup>