자주 묻는 질문

가장 흔한 원인: 프록시 구성 문제

해결 방법:

1. VS Code Settings를 엽니다(macOS에서는 Cmd+,, Windows/Linux에서는 Ctrl+,)
2. "useProxy" 또는 "verdent.enableProxy"를 검색합니다
3. 프록시 설정을 켜거나 끕니다(현재 상태의 반대로 전환)
4. 다시 로그인을 시도합니다

설명: 회사 방화벽 뒤에 있다면 프록시 설정을 활성화해야 할 수 있습니다. 홈 네트워크를 사용 중이라면 비활성화해 보세요.

오류: 무료 체험 크레딧을 받지 못했거나 무료 체험 접근이 거부됨

이유: 등록 중 서비스 약관 위반이 감지됨

해결 방법: 무료 체험 접근과 관련해 도움이 필요하면 support@verdent.ai로 문의하세요. 지원팀이 계정을 검토하고 문제 해결을 도와드립니다.

오류: 계정 등록이 거부되었거나 제한됨

이유: 등록이 Verdent의 서비스 약관을 위반하여 접근 제한이 적용됨

해결 방법: 도움이 필요하면 support@verdent.ai로 문의하세요. 지원팀이 등록 상태를 검토하고 문제 해결 방법을 안내할 수 있습니다.

문제: 모델 선택 메뉴에서 특정 AI 모델을 찾을 수 없음

이유: 모델 제공사의 위치 기반 제한

설명: 일부 AI 모델 제공사(Anthropic, OpenAI, Google)는 지역 제한을 적용하여 특정 지역에서 일부 모델을 사용할 수 없게 합니다. 이런 경우:

• 제한된 모델은 모델 선택 메뉴에 표시되지 않습니다
• 사용 가능한 다른 모든 모델은 중단 없이 계속 사용할 수 있습니다
• 구독 또는 크레딧에는 영향이 없습니다

사용 가능한 모델 확인: https://www.verdent.ai/regions 에서 해당 지역에서 사용할 수 있는 모델을 확인하세요

참고: 지역 제한은 Verdent가 아니라 AI 모델 제공사가 설정합니다. Verdent는 이러한 제한을 우회할 수 없습니다.

Visual Studio Code는 Microsoft에서 개발한 무료 오픈 소스 코드 편집기입니다. 여러 프로그래밍 언어를 지원하고 디버깅, 구문 강조, 지능형 코드 완성, 통합 버전 관리 같은 기능을 제공하는 가볍지만 강력한 개발 환경입니다. Verdent는 Visual Studio Code에 확장 프로그램으로 직접 통합되어 기존 워크플로에 AI 기반 코딩 기능을 추가합니다.

Verdent는 Visual Studio Code용 AI 코딩 어시스턴트 확장 프로그램으로, 자연어 대화를 통해 코드 생성, 리팩터링, 디버깅, 프로젝트 탐색을 돕습니다.

주요 기능:

• 파일 도구를 통한 코드 생성 및 수정
• 전문 서브에이전트를 통한 코드베이스 탐색
• bash 연동을 통한 명령 실행
• 규칙과 MCP 서버를 통한 사용자 지정 확장

최소 요구 사항:

• Visual Studio Code 1.90.0 이상
• 활성 Verdent 구독
• 인터넷 연결

플랫폼 지원: macOS, Windows, Linux, WSL

1. VS Code marketplace에서 Verdent 확장 프로그램을 설치합니다
2. 안내가 표시되면 Verdent 계정으로 로그인합니다
3. 아무 코드 파일이나 프로젝트를 엽니다
4. Chat View를 열고 Verdent와 대화를 시작합니다

첫 작업 제안: Verdent에게 프로젝트 구조를 설명하거나 특정 파일을 검토해 달라고 요청하세요.

Visual Studio Code를 열고 Help → About으로 이동합니다(macOS에서는 Code → About Visual Studio Code). 대화상자에 버전 번호가 표시됩니다. Verdent에는 Visual Studio Code 1.90.0 이상이 필요합니다.

명령줄에서도 확인할 수 있습니다:

code --version

Verdent 제품 전반에서 사용하는 크레딧의 공통 정의, 가격 티어, 사용 기본 사항은 크레딧 및 플랜을 참고하세요.

공통 계정 정책과 복구 옵션은 크레딧을 모두 사용하면 어떻게 되나요를 참고하세요.

클립보드로 붙여 넣거나 파일 경로로 참조한 이미지는 대화 세션 안에서 처리됩니다. 이미지는 영구 저장되지 않으며 새 대화를 시작하면 삭제됩니다. 파일 경로 참조는 업로드 없이 로컬에서 이미지를 읽습니다.

Plan Mode는 Verdent가 파일을 수정하거나 명령을 실행하지 않고 코드를 분석하고, 리서치를 수행하고, 상세한 구현 플랜을 만드는 읽기 전용 실행 모드입니다. 플랜을 생성한 뒤 Verdent는 두 가지 옵션을 제시합니다. Edit(수정을 요청하고 플랜을 다듬기) 또는 Start Building(Agent Mode로 전환해 실행 시작)입니다. 에이전트는 실행 전에 불확실성을 줄이기 위해 확인 질문을 할 수 있습니다. 이 모드는 변경에 착수하기 전에 접근 방식을 검토하고 싶은 복잡한 작업에 적합하며, 사용자의 기대와 Verdent가 제안한 해결책이 일치하도록 돕습니다.

아니요. Plan Mode는 엄격히 읽기 전용입니다:

• Verdent는 파일을 읽고, 코드를 검색하고, 코드베이스를 분석할 수 있습니다
• Plan Mode 중에는 파일 쓰기, 편집, 삭제가 발생하지 않습니다
• 플랜은 Chat View에만 표시됩니다
• 사용자가 명시적으로 승인하고 Agent Mode로 전환한 뒤에만 코드 실행이 시작됩니다

안전 보장: Plan Mode는 실수로 코드를 수정할 수 없습니다. 안전한 탐색과 전략 수립을 위해 설계되었습니다.

Input Box에서 즉시 전환할 수 있습니다:

Plan Mode로 들어가기:

• Input Box에서 Switch Mode 버튼을 선택합니다
• 드롭다운에서 Plan Mode를 선택합니다
• 또는 "Switch to Plan Mode"라고 말합니다

Plan Mode에서 나가기:

• Input Box에서 Switch Mode 버튼을 선택합니다
• 드롭다운에서 Agent Mode를 선택합니다
• 또는 플랜을 검토한 뒤 Start Building을 선택합니다

모드 유지:

• 모드 선택은 현재 세션 안에서 유지됩니다
• 새 세션은 기본 Agent Mode로 시작합니다
• 언제든지 자유롭게 모드를 전환할 수 있습니다

일반적인 워크플로: Plan Mode → 검토 → Agent Mode → 실행 → 다음 복잡한 기능을 위해 다시 Plan Mode.

상단 바에서 "New Session" 버튼을 선택합니다. 현재 대화 기록이 지워지고 Verdent에 다음 작업을 위한 새 컨텍스트 창이 제공됩니다.

네. 각 VS Code 창은 독립적으로 동작합니다. 여러 프로젝트에서 Verdent를 열 수 있으며, 각각 별도의 대화 컨텍스트를 유지합니다.

네. Verdent는 표준 Git 명령을 사용하므로 호스팅 플랫폼과 관계없이 모든 Git 저장소에서 작동합니다. pull request를 만들 때는 GitHub가 필요한 gh CLI를 사용하지만, 그 외 모든 Git 작업은 어디서나 작동합니다.

지원됨: 다음을 포함한 모든 텍스트 기반 파일 형식:

• 소스 코드(JavaScript, Python, TypeScript, Java, Go 등)
• 구성 파일(JSON, YAML, TOML, XML, ENV)
• 문서(Markdown, HTML, LaTeX)
• 빌드 파일(package.json, Makefile, requirements.txt)

지원되지 않음: 바이너리 파일(이미지, 동영상, PDF, 컴파일된 바이너리, Office 문서)

우회 방법: 코드에서 바이너리 파일을 참조할 수는 있지만, 수정하려면 외부 도구가 필요합니다.

매우 우수한 지원:

• JavaScript, TypeScript, Python, React, Vue, Angular
• Node.js, Go, Java/Spring, C#/.NET
• Swift, Kotlin, Flutter

우수한 지원: Rust, C/C++, Ruby, R

양호한 지원: PHP, Assembly, Julia

일반적으로 널리 쓰이는 언어는 학습 데이터가 많아 더 강하게 지원됩니다.

세 가지 파일 작업 도구가 있습니다:

• file_read: 전체 파일 또는 특정 줄 범위 읽기
• file_edit: 특정 텍스트 패턴 바꾸기(대상 지정 수정)
• file_write: 새 파일 생성 또는 전체 파일 다시 쓰기

권장 사항: 수정에는 file_edit를 사용하고, 새 파일에는 file_write만 사용하세요.

테스트 실행, 패키지 설치, 빌드 명령 실행 같은 작업을 포함해 Verdent를 통해 터미널 명령이나 셸 스크립트를 실행하는 것입니다. 명령 실행은 의도하지 않은 시스템 변경을 막기 위해 대부분의 Permission Modes에서 승인이 필요합니다.

네. bash 도구를 사용합니다. Verdent는 다음 조건으로 터미널 명령을 실행할 수 있습니다:

• 최대 제한 시간: 120초(2분)
• &&를 사용한 명령 연결
• 크로스 플랫폼 지원(Unix에서는 bash, Windows에서는 PowerShell)

안전: 명령은 사용자 권한으로 실행됩니다. 실행 전에 검토하려면 Manual Accept Mode를 사용하세요.

최대 제한 시간: 120초(2분)

2분을 초과하는 명령은 자동으로 종료됩니다. 더 긴 작업에는 다음을 고려하세요:

대안:

• 더 작은 명령으로 나누기: bash("task1") && bash("task2")
• 더 작은 작업으로 나누기
• 백그라운드에서 실행하고 결과를 별도로 확인하기

코드가 생성되고, 테스트되고, 포괄적인 테스트를 통과할 때까지 수정되는 반복 검증 프로세스입니다. Verdent는 자동으로 테스트를 실행하고, 실패를 분석하고, 문제를 수정하고, 코드가 올바르게 작동할 때까지 여러 차례 다시 테스트합니다. 이는 단순한 제안이 아니라 프로덕션에 사용할 수 있는 코드를 제공합니다. 각 결과에는 무엇이 변경되었는지 정확히 보여주는 상세 요약과 코드 diff가 포함됩니다.

서브에이전트는 특정 작업을 위한 격리된 컨텍스트 창을 가진 전문 AI 에이전트입니다.

내장 서브에이전트:

• @Explorer: 코드베이스 검색, 아키텍처 질문
• @Verifier: 빠른 검증 확인
• @Code-reviewer: 보안 및 품질 리뷰

사용 시점: 메인 대화 컨텍스트를 절약하기 위해 리서치, 검증, 리뷰 작업을 위임합니다.

사용자 지정 서브에이전트 생성 방법:

~/.verdent/subagents/에 Markdown 파일을 만듭니다:

---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]

사용 사례: 도메인별 전문성(금융, 헬스케어), 팀 워크플로, 기술 전문가.

컨텍스트의 이전 작업과 정보가 이후 작업에 영향을 주는 의도치 않은 행동 패턴을 만드는 상황입니다. 예를 들어 코드를 반복해서 업데이트한 뒤 배포하면, 단순히 실험 중일 때도 에이전트가 모든 코드 업데이트를 즉시 배포와 연결하기 시작할 수 있습니다. 서브에이전트는 격리된 컨텍스트 창에서 작동하므로 컨텍스트 오염을 방지하고, 각 전문 작업이 깨끗한 컨텍스트에서 시작되며, 서로 다른 작업 유형 사이의 교차 오염을 피할 수 있습니다.

Verdent 패널 하단의 입력 상자를 확인하세요. "Switch Permission" 버튼에 현재 모드(예: "Manual", "Auto", "Plan")가 표시됩니다. 이 버튼을 선택해 모드를 전환할 수 있습니다.

Auto-Run Mode:

• 파일 작업은 승인 없이 자동 실행됩니다
• 명령은 여전히 권한이 필요합니다
• 신뢰할 수 있는 코드베이스에서 더 빠른 워크플로를 제공합니다
• 버전 관리를 사용하는 개인 프로젝트에 가장 적합합니다

Manual Accept Mode:

• 각 보호 작업을 검토하고 승인합니다
• 공유 코드베이스 또는 프로덕션에 더 안전합니다
• 실행 전에 정확히 무엇이 실행될지 볼 수 있습니다

Settings 또는 command palette에서 모드를 전환합니다.

데이터를 읽기만 하고 변경하지 않는 작업입니다. 예를 들어 파일 읽기와 웹 검색이 해당합니다. Auto-Run Mode에서는 이러한 작업이 자동 승인되지만, 안전을 위해 파일 편집과 명령 실행은 여전히 승인이 필요합니다.

아니요. permission mode는 상호 배타적이며 한 번에 하나만 사용할 수 있습니다:

• Manual Accept - 기본값, 최대 제어
• Auto-Run - 신뢰할 수 있는 프로젝트에서 간소화
• Plan - 읽기 전용 계획 모드
• Skip Permissions - 완전 자율

Input Box의 Switch Permission 버튼으로 즉시 모드를 전환할 수 있습니다. 대부분의 사용자는 작업 컨텍스트에 따라 모드를 전환합니다(예: 복잡한 기능에는 Plan Mode, 빠른 수정에는 Auto-Run).

메인 컨텍스트를 소모하지 않고 탐색과 검색을 해야 할 때 Explorer 에이전트를 사용하세요. 파일을 수정해야 할 때만 @-mentions로 직접 로드하세요. Explorer는 "다음에 해당하는 모든 파일 찾기..." 같은 질문에 적합하고, @-mentions는 "이 특정 파일 업데이트" 작업에 적합합니다.

네. ~/.verdent/subagents/에 사용자 지정 서브에이전트를 만드세요:

---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]

사용 사례: 도메인별 전문성(금융, 헬스케어), 팀 워크플로, 기술 전문가.

네. 언제든지 실행을 중단할 수 있습니다. Verdent는 현재 진행 중인 단계를 완료한 뒤 멈춥니다. 그 시점까지의 진행 상황은 보존됩니다. 완료된 내용을 검토하고, 조정한 뒤 계속 진행하거나 다른 접근 방식을 선택할 수 있습니다.

todo 목록을 확인하세요. 실시간 상태가 표시되며, 언제나 하나의 항목이 "in progress"로 표시됩니다. 활성 항목은 Verdent가 현재 작업 중인 내용을 정확히 보여줍니다. 완료된 항목은 done으로 표시되고, 대기 중인 항목에는 남은 작업이 표시됩니다.

아니요. Verdent는 사용자가 명시적으로 요청할 때만 커밋을 만듭니다. 변경 사항을 언제 커밋할지는 사용자가 완전히 제어합니다. 준비되면 "Stage all changes and create a commit"이라고 요청하면 됩니다.

아니요. Verdent는 사용자가 명시적으로 요청할 때만 원격 저장소에 push합니다. 모든 Git 작업(commit, push, merge, rebase)은 안전을 위해 사용자의 명시적 지시가 필요합니다.

세 가지 사용자 지정 방법이 있습니다:

1. VERDENT.md: 개인 전역 기본 설정(~/.verdent/VERDENT.md)
2. AGENTS.md: 프로젝트별 팀 표준(프로젝트 루트, 버전 관리 대상)
3. plan_rules.md: Plan Mode 출력 형식(~/.verdent/plan_rules.md)

AGENTS.md는 팀 일관성을 위해 VERDENT.md보다 우선합니다.

대부분의 Verdent 설정은 재시작 없이 즉시 적용됩니다:

• Permission modes: Input Box에서 즉시 전환
• 모델 프리셋: 다음 요청부터 적용
• 규칙 파일: 새 대화부터 적용(저장하면 다시 로드)
• 서브에이전트: 생성 후 즉시 사용 가능
• 키보드 단축키: VS Code에서 저장한 뒤 적용

예외: verdent.enableCheckpoints 같은 VS Code 확장 프로그램 설정은 즉시 적용되지만, 완전히 적용하려면 파일이나 세션을 다시 열어야 할 수 있습니다.

Model Context Protocol(MCP)은 외부 도구와 서비스로 Verdent를 확장합니다:

구성: Settings → MCP Servers에서 ~/.verdent/mcp.json

기능:

• 데이터베이스 연결(PostgreSQL, MySQL, MongoDB)
• 클라우드 서비스(AWS, Azure, GCP)
• 프로젝트 관리 도구(Jira, Linear)
• CI/CD 파이프라인(Jenkins, GitHub Actions)

상태: MCP 연동 문서는 개발 중입니다. 설정 도움이 필요하면 support@verdent.ai로 문의하세요.

컨텍스트 창의 측정 단위입니다. 토큰은 AI 모델이 처리하는 텍스트 조각(단어, 단어의 일부, 문자)을 나타냅니다. 컨텍스트 한도는 문자나 단어가 아니라 토큰으로 측정되며, 일반적인 대화는 수천 개의 토큰을 사용합니다.

세션의 모든 것이 포함됩니다. 대화의 모든 메시지, 컨텍스트에 로드된 파일 내용, 도구 출력(grep/search 결과, 파일 읽기), 시스템 프롬프트와 지침, MCP 서버 정의가 모두 포함됩니다. 각각은 전체 컨텍스트 용량에서 토큰을 소비합니다.

표준 모델(Claude 4.5 Sonnet, Haiku, GPT-5, GPT-5-Codex, MiniMax-M2)은 대부분의 작업에 충분한 200K 토큰 컨텍스트 창을 제공합니다. Claude Sonnet 4.5는 1000+개 파일이 있는 대규모 코드베이스, 복잡한 다중 파일 리팩터링, 긴 개발 세션을 위해 5배 더 큰 확장 1M 토큰 컨텍스트를 제공합니다. 입력이 200K 토큰을 초과하면 1M 컨텍스트가 자동으로 활성화되며, 명시적으로 선택할 수도 있습니다.

고정된 파일 제한은 없습니다. 파일 크기와 전체 토큰 수에 따라 달라집니다. 200K 컨텍스트에서는 큰 파일 20+개(각각 >1000줄)를 로드하지 않는 것이 좋습니다. 현재 작업과 직접 관련된 파일에 집중하세요. @-mentions는 선별적으로 사용하고, 많은 예제 파일을 로드하는 대신 AGENTS.md 문서를 활용하세요. 1M 컨텍스트에서는 파일 선택이 훨씬 덜 중요해집니다.

응답 시간이 느려지거나, 세션이 몇 시간 동안 이어지거나, 큰 파일이 많이 로드되는 것이 신호입니다. 세션 길이와 파일 수를 모니터링하세요. 성능 저하가 느껴지면 현재 작업을 완료하고, 진행 상황을 커밋한 뒤, 깨끗한 컨텍스트로 새 세션을 시작하세요.

전략:

1. 전략적 파일 읽기: 큰 파일에는 줄 범위를 사용합니다
2. 서브에이전트에 위임: 백그라운드 리서치에는 Explorer/Verifier를 사용합니다
3. 읽기 전에 검색: 관련 파일을 식별하려면 grep_file을 사용합니다
4. 작업 나누기: 다단계 작업을 추적하려면 todo_update를 사용합니다

경험칙: 500줄이 넘는 파일은 줄 범위를 사용하세요.

컨텍스트를 초기화하려면 직접 새 세션을 시작해야 합니다. Verdent는 컨텍스트를 자동으로 지우지 않습니다. 권장 방식은 하나의 독립적인 작업 단위를 완료하고, 테스트하고, 버전 관리에 커밋한 뒤 초기화하는 것입니다. 1M 토큰 컨텍스트에서는 초기화가 훨씬 덜 자주 필요합니다.

아니요. 컨텍스트 초기화는 대화 기록과 메모리에 로드된 파일만 지웁니다. 실제 코드 변경, 커밋, 파일 수정은 보존됩니다. 안전을 위해 컨텍스트를 초기화하기 전에 항상 작업을 버전 관리에 커밋하세요. 초기화 → 새 세션 시작 → 다음 작업 계속 진행 순서로 진행합니다.

모호함을 없앨 만큼 구체적으로 작성하되, 명백한 세부사항을 과도하게 설명하지는 마세요. 정확한 파일 경로, 구현 접근 방식, 기대 결과, 제약 조건을 포함하세요. 나쁜 예: "Fix the code" - 너무 모호합니다. 좋은 예: "ContactForm.js의 이메일 필드에 입력 검증을 추가해 잘못된 이메일 형식을 거부하세요" - 범위와 목표가 명확합니다. 확실하지 않다면 더 구체적으로 작성하는 편이 좋습니다.

Verdent는 프롬프트에 이름이 언급된 파일과 같은 디렉터리의 관련 파일을 자동으로 로드합니다. @-mentions(@filename.js)는 파일이 컨텍스트에 포함되도록 명시적으로 보장합니다. 이는 긴밀하게 결합된 파일을 작업하거나, 한 파일의 패턴을 참조해 다른 파일에 적용하거나, 대규모 코드베이스에서 자동 감지가 컨텍스트를 놓칠 수 있을 때 중요합니다. Verdent에게 "같은 패턴을 따르라"고 요청할 때는 정확한 코드 참조를 보장하기 위해 항상 @-mentions를 사용하세요.

아니요. Verdent는 세션 안에서 대화 컨텍스트를 유지하므로 이미 논의한 아키텍처 세부사항이나 규칙을 반복할 필요가 없습니다. 다만 중요한 제약 조건이 있거나 세션이 길어졌다면(100+ 메시지) 중요한 컨텍스트를 다시 명시하세요. 더 나은 방법은 프로젝트 규칙(AGENTS.md)을 사용해 기술 스택, 코딩 표준, 패턴 같은 지속 컨텍스트를 문서화하는 것입니다. 그러면 반복해서 설명할 필요가 없습니다.

반복적으로 다듬으세요. 출력을 검토하고, 무엇이 잘못됐는지 파악한 뒤, 후속 프롬프트로 수정 사항을 제공합니다. 예: "검증 로직은 좋지만 수동 검사 대신 Joi schema validation을 사용하세요. ProductController.js의 검증 패턴과 맞추세요." 설명을 요청할 수도 있습니다. "Redux 대신 Context API를 사용한 이유는 무엇인가요?"라고 물은 뒤 이해한 내용을 바탕으로 다듬으세요. 같은 프롬프트를 반복하지 말고 실패한 부분에 맞춰 조정하세요.

Plan Mode는 대규모 리팩터링이나 아키텍처 변경, 실행 전에 범위를 검토하고 싶은 다중 파일 수정, 요구사항이 불확실한 복잡한 작업, 구현 전에 Verdent가 확인 질문으로 인터뷰하길 원하는 경우에 사용하세요. 단순하고 명확한 작업, 빠른 버그 수정, 반복적인 작업에는 Plan Mode를 건너뛰세요. Plan Mode는 추가 시간이 들지만 복잡한 작업에서 비용이 큰 실수를 방지합니다.

모델 프리셋을 작업 복잡도와 예산에 맞추세요:

Efficiency 사용(Sonnet보다 3.2배 효율적):

• 빠른 버그 수정과 간단한 코드 생성
• 반복 작업과 자주 수행하는 작업
• 깊이보다 속도가 더 중요할 때

Balance 사용(1x 기준) - 기본값:

• 일반 개발과 일상적인 코딩
• 기능 구현과 코드 리뷰
• 대부분의 시나리오에 균형 잡힌 성능

Performance 사용(0.5x 효율, 2x 비용):

• 복잡한 아키텍처 결정
• 광범위한 컨텍스트가 필요한 대규모 코드베이스(200k+ 토큰)
• 정교한 디버깅과 리팩터링

전문가 팁: 대부분의 사용자는 Balance를 기본값으로 유지하고, 컨텍스트 한도에 도달하거나 깊은 추론이 필요할 때만 Performance로 전환합니다.

Verdent가 AI 서비스에 연결할 수 없다면 다음 일반적인 문제를 확인하세요:

기본 연결 테스트:

• 인터넷 연결이 활성 상태인지 확인합니다
• 다른 HTTPS 서비스에 접속해 아웃바운드 연결이 작동하는지 확인합니다

회사/엔터프라이즈 환경:

• 네트워크 관리자에게 Verdent의 API 엔드포인트를 허용 목록에 추가해 달라고 요청합니다
• 방화벽을 통해 아웃바운드 HTTPS 트래픽이 허용되는지 확인합니다
• 프록시 서버가 API 요청을 제대로 통과시키도록 구성되어 있는지 확인합니다
• SSL/TLS 검사는 Verdent 엔드포인트에 대한 예외가 필요할 수 있습니다

일반적인 증상:

• 확장 프로그램이 멈춘 것처럼 보이거나 시간 초과됨
• 올바른 자격 증명에도 인증 실패

방화벽 구성을 완료한 뒤에도 문제가 지속되면 Verdent 지원팀에 문의해 허용 목록에 추가할 구체적인 엔드포인트 정보를 받으세요.

확인:

• 위치: 프로젝트 루트 디렉터리에 파일이 있는지
• 구문: 유효한 Markdown인지
• 구체성: 규칙이 지시형인지("Try to..."가 아니라 "Always use...")
• 새 테스트: 새 대화를 시작해 적용 여부를 테스트

우선순위: AGENTS.md는 프로젝트별 동작에 대해 VERDENT.md보다 우선합니다.

원인:

• 마지막으로 읽은 뒤 텍스트가 변경됨
• 공백 차이(스페이스 vs 탭)
• 문자열이 파일에서 고유하지 않음

해결 방법:

• 파일을 다시 읽어 현재 내용을 가져옵니다
• 고유성을 위해 더 큰 컨텍스트 문자열을 제공합니다
• 동일한 문자열이 여러 개라면 replace_all=true를 사용합니다
• file_path가 올바른지 확인합니다

확인:

• 위치: ~/.verdent/subagents/[name].md에 파일이 있는지
• 호출 정책: strict policy에서는 명시적 @-mention이 필요합니다
• YAML frontmatter: 구문이 유효한지
• "When to use" 가이드라인: 요청 패턴과 일치하는지

테스트: 명시적 @-mention으로 서브에이전트가 작동하는지 확인합니다: @your-subagent do task