구성 최적화
워크플로에 맞게 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일까지 무료)
실행 모드 설정
- 승인 프롬프트 없이 완전한 자율 실행
- 권한 요청으로 인한 중단 없음
- 위험도가 가장 높음 - 자동화 환경에서만 사용하세요
- 명령은 승인이 필요하고, 파일 작업은 자동으로 처리
- 권한 프롬프트 감소
- 위험한 작업에 대한 안전성을 유지하면서 위험을 낮춤
- 모든 작업에 승인 필요
- 완전한 가시성과 제어
- 가장 느리지만 가장 안전함 - 학습 및 프로덕션 코드에 가장 적합
- 실행 전 전략적 계획 수립
- 읽기 전용 분석 단계
- 변경 전에 검토하고 승인
Think Hard Mode
복잡한 추론 작업에 활성화합니다.
- 철저함: 정교한 문제를 위한 최대 추론 깊이
- 속도: 확장된 사고 예산 때문에 더 느림
- 적합한 용도: 아키텍처 결정, 복잡한 디버깅, 정교한 분석
속도와 철저함의 트레이드오프
작업 요구 사항에 따라 실행 속도와 분석 깊이의 균형을 맞춥니다.
설정:
- 모델: Efficiency 프리셋(Claude-4.5-haiku)
- 권한 모드: Auto-Run Mode
- 실행 모드: 직접 실행에는 Agent Mode
- 사용 사례: 빠른 수정, 반복적인 작업, 간단한 작업
이점:
- 가장 빠른 응답 시간
- 최소한의 중단
- Balance 프리셋 대비 비용 70% 절감
설정:
- 모델: Performance 프리셋(Claude-4.5-sonnet-1m)
- 권한 모드: Manual Accept Mode
- 실행 모드: 전략적 리뷰에는 Plan Mode
- Think Hard: 정교한 추론을 위해 활성화
- 사용 사례: 복잡한 기능, 프로덕션 코드, 아키텍처 결정
이점:
- 최대 컨텍스트 창(1M 토큰)
- 완전한 가시성과 제어
- 복잡한 문제를 위한 깊은 추론
- 실행 전 리뷰
대부분의 사용자는 설정을 상황에 맞게 전환할 때 더 큰 이점을 얻습니다.
- 빠른 수정: Efficiency + Agent Mode
- 복잡한 기능: Balance/Performance + Plan Mode
- 탐색: 전략 수립에는 Plan Mode, 이후 실행에는 Agent Mode
전략: 모든 작업에 하나의 설정을 적용하지 말고 작업 유형에 맞게 설정을 조정합니다.
신뢰할 수 있는 프로젝트에서는 Auto-Run Mode를 사용해 권한 프롬프트를 줄이면서도 위험한 작업에 대한 안전성을 유지하세요. 중요한 보호 장치를 희생하지 않고 워크플로가 간소화됩니다.
워크스페이스 수준 설정
Verdent는 팀 전체의 일관성을 위해 프로젝트별 및 워크스페이스별 설정을 지원합니다.
프로젝트별 설정
프로젝트 규칙(AGENTS.md):
- 위치: 프로젝트 루트 디렉터리 또는 워크스페이스 폴더
- 범위: 현재 프로젝트에만 적용
- 버전 관리: 팀 전체 표준으로 사용하려면 git에 커밋
- 내용: 코딩 표준, 테스트 요구 사항, 아키텍처 패턴
예시:
# 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 committingVS Code 워크스페이스 설정
워크스페이스 수준에서 확장 설정을 구성합니다.
위치: 워크스페이스 루트의 .vscode/settings.json
예시:
{
"verdent.enableCheckpoints": true
}설정 우선순위
설정이 충돌하면 Verdent는 다음 우선순위를 적용합니다.
- 프로젝트 규칙(AGENTS.md) - 가장 높은 우선순위(프로젝트별)
- 워크스페이스 설정 - VS Code 워크스페이스 수준 설정
- 사용자 규칙(VERDENT.md) - 전역 사용자 선호도
- 기본 설정 - Verdent의 내장 기본값
프로젝트별 사용자 지정
대규모 프로젝트를 위한 컨텍스트 관리
- 별도 컨텍스트 창을 가진 서브에이전트에 복잡한 작업을 위임
- 전체 과정이 아니라 서브에이전트 결과만 기본 컨텍스트를 소비
- 구현 세부 정보로 기본 컨텍스트가 가득 차는 것을 방지
@filename를 사용해 관련 파일만 명시적으로 추가- 전체 프로젝트를 불필요하게 컨텍스트에 로드하지 않음
- 특정 컴포넌트를 대상으로 집중 분석
- 큰 작업을 더 작고 완료 가능한 단위로 나눔
- 서로 다른 기능이나 컴포넌트에는 새 세션 시작
- 자연스러운 중단 지점으로 컨텍스트 고갈 방지
- 실행 컨텍스트를 소비하기 전에 접근 방식 검토
- 잘못된 구현에 컨텍스트를 낭비하는 일을 줄임
- Plan Mode에는 별도의 컨텍스트 관리가 있음
성능 최적화
체크포인트를 선택적으로 활성화:
verdent.enableCheckpoints 설정은 버전 관리를 위해 git을 사용합니다.
- 매우 큰 리포지터리에서는 성능에 영향을 줄 수 있음
- 체크포인트 기능이 필요할 때만 활성화
- 대규모 코드베이스에서 최대 성능이 필요하면 비활성화
중요한 작업에만 체크포인트를 선택적으로 활성화하세요. 과도한 체크포인트는 가치를 더하지 않고 워크플로를 느리게 만듭니다.
모델 선택:
- 간단하고 독립적인 작업에는 Efficiency 프리셋(Haiku) 사용
- 컨텍스트가 많이 필요한 작업에는 Performance 프리셋(Sonnet-1M) 사용
- 일반 작업에는 Balance 프리셋 사용
실행 모드:
- Auto-Run Mode는 권한 프롬프트가 소비하는 컨텍스트를 줄임
- Skip Permissions Mode는 자동화 환경에서 효율을 극대화
여러 워크스페이스를 사용하는 경우 워크스페이스를 전환할 때 적절한 프로젝트 규칙이 자동으로 적용됩니다. 수동으로 설정을 전환할 필요가 없습니다.
여러 워크스페이스 설정을 사용하면 프로젝트 유형, 개발과 프로덕션, 모노레포와 마이크로서비스에 따라 설정을 최적화할 수 있습니다.