VS Code Copilot 디버깅: Agent Debug Log와 Chat Debug

로그를 읽는 목표와 준비

목표는 “Copilot이 왜 이 답을 했는가”를 관찰 가능한 입력·도구 결과로 좁히는 것입니다. VS Code Chat 사용과 프로젝트 파일 열기를 알고 시작합니다. 로그는 모델의 모든 내부 판단을 증명하지 않으며, 요청에 들어간 컨텍스트와 실제 도구 호출을 확인하는 자료입니다. 아래 진입점은 2026-09-13 공식 문서 기준이며 Agent Debug Log는 Preview입니다.

호스트에 맞는 로그를 켜고 세션을 선택하기

일반 확장 호스트 채팅에서는 Settings에서 아래 키를 검색하여 활성화하고 창을 다시 로드합니다. 기존 settings.json이 있다면 객체 전체를 교체하지 말고 한 속성만 병합합니다.

사용자 settings.json — 해당 속성 예시

{
  "github.copilot.chat.agentDebugLog.fileLogging.enabled": true
}

Agent Host 세션은 별도로 chat.agentHost.agentDebugLog.enabled를 세션 시작 전에 켭니다. 설정이 검색되지 않으면 설치한 VS Code와 Copilot 확장 버전, 세션 유형을 기록하고 해당 버전 문서를 확인하세요.

Command Palette에서 Developer: Open Agent Debug Logs로 시간순 이벤트를, Developer: Show Chat Debug View로 요청 내용을 엽니다. Chat 메뉴의 Show Agent Debug Logs도 사용할 수 있습니다. 이전 기록이 보일 수 있으므로 재현 시각과 대상 세션을 먼저 맞춥니다.

파일 누락을 비교하는 작은 재현 과제

민감 정보가 없는 새 프로젝트에 아래 파일을 만듭니다. 이 값은 공개 실습 문자열입니다.

src/retry-policy.js — 전체 파일

export const retryLimit = 3;

첫 요청은 “이 프로젝트의 재시도 횟수를 알려줘”로 보내고, 두 번째는 첨부 버튼이나 파일 참조로 src/retry-policy.js를 명시한 뒤 같은 질문을 보냅니다. 첫 요청도 검색을 통해 정답을 찾을 수 있으므로 반드시 실패한다고 가정하지 않습니다. 비교할 것은 답의 우열보다 파일이 요청에 포함되었거나 도구로 읽혔다는 증거입니다.

관찰 항목	기록할 근거
Discovery	설정·파일 탐색 성공, 건너뜀, 오류
Context	대상 파일 또는 첨부 정보 포함 여부
Tool calls / responses	어느 파일을 요청했고 반환 결과가 무엇인지
Response	최종 답의 3이 실제 파일 내용과 맞는지

두 번째 요청에도 파일 근거가 없으면 참조 경로·현재 workspace·파일 저장 여부를 확인합니다. 파일이 포함됐지만 답이 틀렸다면 단순 로딩 오류라고 결론내리지 말고 요청 내용과 도구 결과 해석을 나누어 기록합니다.

MCP와 지침 문제에 적용하기

도구가 목록에 나타나는 것과 호출된 것은 다릅니다. available tools에 없으면 서버 연결·설정을 먼저 확인하고, 목록에 있다면 실제 호출 이벤트·입력·반환 오류를 봅니다. “연결됨”만으로 외부 API 성공을 판정하지 마세요. 지침 문제는 Discovery의 로드·검증 오류와 파일 위치·applyTo 범위를 대조합니다.

한 번에 여러 설정을 바꾸지 말고 새 세션에서 같은 짧은 요청으로 재시험합니다. 비교 기록은 VS Code/확장 버전, 호스트 종류, 설정 변경 한 가지, 세션 시각, 관찰 결과로 충분합니다. 로그 내보내기는 프롬프트·소스·도구 응답이 포함될 수 있으므로 비밀 값과 개인 경로를 제거한 재현 자료만 공유합니다.

검증 범위와 다음 학습

여기서는 공식 문서의 명령·설정 키와 절차를 대조했습니다. 실제 계정의 Copilot UI·MCP 호출은 실행 검증하지 않았습니다. 독자는 위 두 요청을 자신의 환경에서 비교해야 합니다. Preview의 메뉴·보이는 항목은 버전에 따라 달라질 수 있습니다.

1.113에서 추가된 CLI 로그 범위와 AI 지침 파일의 역할을 이어서 읽으세요.