구성 및 사용자 지정

Verdent for VS Code는 개발 워크플로, 코딩 선호도, 팀 표준에 맞게 조정할 수 있는 폭넓은 구성 옵션을 제공합니다. VS Code의 기본 설정 인터페이스에서 설정을 구성하고, 키보드 단축키를 사용자 지정하며, 특화된 동작을 위한 규칙과 서브에이전트를 만들 수 있습니다.

배울 내용

• Verdent용 VS Code 확장 설정 구성하기
• 효율적인 워크플로를 위한 키보드 단축키 사용자 지정하기
• 개인화된 에이전트 동작을 위한 Rules 만들고 관리하기
• 특화된 작업을 위한 사용자 지정 서브에이전트 만들기

사전 요구 사항

• Verdent for VS Code 설치 및 인증 완료
• VS Code 설정 접근 권한(Cmd+, 또는 Ctrl+,)
• 규칙 파일을 위한 JSON 기본 이해(선택 사항)

VS Code 확장 설정

Verdent for VS Code 설정은 구성 유형과 범위에 따라 여러 위치에서 접근할 수 있습니다.

설정 접근하기

확장 설정(VS Code 기본):

1. VS Code 설정을 엽니다: Cmd+,(macOS) 또는 Ctrl+,(Windows/Linux)
2. 설정 검색창에서 "Verdent"를 검색합니다
3. 확장 설정을 수정합니다(예: verdent.enableCheckpoints)

Verdent 전용 설정:

Verdent 상단 바의 Settings 버튼을 선택해 다음에 접근합니다.

• Rules - 사용자 규칙, 프로젝트 규칙, Plan 규칙
• MCP Servers - Model Context Protocol 구성
• Subagents - 사용자 지정 서브에이전트 관리

채팅 내 컨트롤:

많은 설정은 Verdent 패널 하단의 입력 상자에서 바로 전환할 수 있습니다.

• Switch Permission - Manual Accept, Auto-Run, Plan, Skip Permissions
• Switch Mode - Agent, Plan, Chat 모드
• Switch/Customize AI Model - Performance, Balance, Efficiency 프리셋
• Think Hard Mode - 복잡한 추론을 위한 최대 사고 예산
• Add Context - @-멘션으로 파일 첨부
• Add Images or Files - 스크린샷 또는 문서 포함
• Add Subagent - 특화된 서브에이전트에 위임

설정 변경은 VS Code를 다시 시작하지 않아도 즉시 적용됩니다.

사용 가능한 확장 설정

Verdent for VS Code는 VS Code의 설정 인터페이스에서 구성할 수 있는 핵심 확장 설정 2개를 제공합니다.

입력 상자 컨트롤 참조

Verdent 패널 하단의 입력 상자에서 구성 컨트롤에 빠르게 접근할 수 있습니다.

권한 모드

모델 프리셋

키보드 단축키 사용자 지정

기본 단축키

주요 단축키:

• macOS: Cmd+L - Verdent 패널 열기/포커스
• Windows/Linux: Ctrl+L - Verdent 패널 열기/포커스
  • 명령: verdent.addToChat
  • Command Palette와 편집기 컨텍스트에서 작동합니다

이 단축키는 코딩 흐름을 방해하지 않고 VS Code 어디서든 Verdent에 빠르게 접근하기 위한 핵심 단축키입니다.

추가 명령:

Command Palette에서 사용할 수 있습니다(기본 단축키는 사용자 지정 가능).

• verdent.addFeedBack - 피드백 제공
• verdent.addTerminalOutputToChat - 터미널 출력을 Verdent에 추가
• verdent.addToChatBySearch - 검색으로 Verdent에 추가
• verdent.centerButtonClicked - 사용자 센터
• verdent.historyButtonClicked - 프로젝트 기록
• verdent.mcpButtonClicked - MCP Server 추가
• verdent.openInNewTabByParams - 새 탭에서 열기
• verdent.plusButtonClicked - 새 세션
• verdent.rulesButtonClicked - Rules 설정
• verdent.SettingClicked - Settings 메뉴
• verdent.subagentButtonClicked - Subagent 추가

단축키 사용자 지정하기

모든 Verdent 키보드 단축키는 VS Code의 표준 키 바인딩 시스템을 사용해 사용자 지정할 수 있습니다.

{
  "key": "cmd+shift+v",
  "command": "verdent.addToChat"
}

{
  "key": "ctrl+shift+v",
  "command": "verdent.addToChat"
}

사용자 지정 범위:

• 모든 Verdent 명령은 다시 매핑할 수 있습니다
• 같은 명령에 여러 단축키를 지정할 수 있습니다
• 기본 단축키를 제거할 수 있습니다
• 변경 사항은 VS Code Settings Sync로 여러 기기에 동기화됩니다

플랫폼별 단축키

Verdent는 VS Code의 플랫폼별 키보드 규칙을 따릅니다.

일반 패턴:

• 설정: Cmd+,(macOS) vs Ctrl+,(Windows/Linux)
• Command Palette: Cmd+Shift+P(macOS) vs Ctrl+Shift+P(Windows/Linux)
• 키보드 단축키: Cmd+K Cmd+S(macOS) vs Ctrl+K Ctrl+S(Windows/Linux)

사용자 지정 지침 및 페르소나

Verdent for VS Code는 AI 동작을 사용자 지정하기 위한 두 가지 시스템을 지원합니다. 선호도와 가이드라인을 위한 Rules, 특화된 작업 페르소나를 위한 Subagents입니다.

Rules 시스템

Rules는 코딩 세션 중 Verdent가 동작하고 응답하는 방식을 정의합니다. Rules는 Markdown 파일에 저장되며 대화 전체에 계속 적용됩니다.

세 가지 Rules 유형

1. 사용자 Rules(VERDENT.md):

• 위치: ~/.verdent/(전역 구성 디렉터리)
• 범위: 모든 프로젝트의 모든 대화에 적용
• 목적: 개인 코딩 선호도, 커뮤니케이션 스타일, 문서화 표준

2. 프로젝트 Rules(AGENTS.md):

• 위치: 프로젝트 루트 디렉터리 또는 워크스페이스
• 범위: 현재 프로젝트에만 적용
• 버전 관리: 팀 전체 표준을 위해 git에 커밋할 수 있음
• 목적: 프로젝트별 코딩 표준, 아키텍처 패턴, 테스트 요구 사항

3. Plan Rules(plan_rules.md):

• 위치: ~/.verdent/(전역 구성 디렉터리)
• 범위: 모든 프로젝트에서 Plan Mode를 사용할 때 적용
• 목적: 플랜 내용, 형식, 세부 수준 사용자 지정

Rules 만들기 및 편집하기

사용자 Rules 예시:

# Code Style Preferences
- Always use functional React components with hooks
- Prefer TypeScript over JavaScript
- Add JSDoc comments for all exported functions
- Provide explanations before showing code

프로젝트 Rules 예시:

## Testing instructions
- Run `pnpm turbo run test --filter <project_name>` to run all checks
- Fix test and type errors until suite is green
- Add or update tests for code changes

## PR instructions
- Title format: [<project_name>] <Title>
- Always run `pnpm lint` and `pnpm test` before committing

Rules 저장 및 적용

구성 우선순위:

Rules가 충돌할 때 Verdent는 다음 우선순위를 적용합니다.

1. 프로젝트 Rules(AGENTS.md) - 가장 높은 우선순위(프로젝트별)
2. 사용자 Rules(VERDENT.md) - 전역 사용자 선호도
3. 기본 동작 - Verdent의 내장 기본값

Subagents

Subagents는 특정 작업을 처리하기 위해 사용자 지정 시스템 프롬프트와 격리된 컨텍스트 창을 가진 특화 AI 에이전트입니다.

기본 제공 Subagents

Verdent에는 구성 없이 바로 사용할 수 있는 기본 서브에이전트 세 개가 포함되어 있습니다.

사용자 지정 Subagents 만들기

Subagent 파일 형식:

---
name: security-reviewer
description: Security-focused code review specialist
---
# System Prompt

You are a security-focused code reviewer. When analyzing code:
- Prioritize security vulnerabilities (SQL injection, XSS, auth flaws)
- Use skeptical, critical tone - assume code is vulnerable until proven otherwise
- Provide specific remediation steps with code examples
- Reference OWASP Top 10 and security best practices
- Never approve code with unresolved security issues

Invocation policy (strict): Only run security-reviewer if user explicitly requests it.

When to use the security-reviewer agent:
- User requests security review of authentication/authorization logic
- User asks to audit code for vulnerabilities
- User needs security assessment before deployment

When NOT to use:
- General code review without security focus
- Opening or reading files without analysis

Subagents 관리

Settings → Subagents에서 다음을 수행할 수 있습니다.

• 편집: 시스템 프롬프트, 도구 권한, 구성 수정
• 복사: 변형 또는 템플릿용으로 서브에이전트 복제
• 삭제: 사용하지 않는 서브에이전트 제거
• 활성화/비활성화: 삭제하지 않고 사용 가능 여부 전환

Subagents 사용하기

기본 제공 Subagents:

• @-멘션으로 참조: @Verifier, @Explorer, @Code-reviewer
• 적절한 작업 유형이 감지되면 자동으로 호출됩니다

사용자 지정 Subagents:

• 입력 상자에서 Add Subagent 버튼을 선택합니다
• 드롭다운에서 선택합니다
• 메인 에이전트가 적절한 작업을 자동으로 위임합니다

Subagent와 Rules 비교

워크플로 예시:

1. 사용자 Rule: "모든 새 함수에 대해 단위 테스트를 생성하세요"
2. 메인 에이전트: 테스트 생성 필요성을 감지합니다
3. Test Generator Subagent에 위임: 전문적이고 포괄적인 테스트 접근 방식
4. Subagent: 격리된 컨텍스트로 완전한 테스트 스위트를 생성합니다
5. 메인 에이전트: 결과를 받고 컨텍스트 오염 없이 계속 진행합니다

FAQ(자주 묻는 질문)

함께 보기