VS Code Copilot 프롬프트 파일 만들기: .prompt.md로 반복 요청 저장·실행하기

VS Code Copilot에 코드 설명을 부탁할 때마다 같은 조건을 다시 입력하나요? 프롬프트 파일에 요청 문장을 저장하면 필요한 순간에 불러올 수 있습니다. 자동으로 적용되는 지침과 달리 직접 실행하는 기능이므로, 파일을 만든 뒤 어디서 호출하는지까지 함께 알아두는 것이 중요합니다.

확인일: 2026년 10월 18일 KST. 10월 14일자 VS Code 공식 문서를 바탕으로 정리했습니다. 실제 PC에서 실행한 후기가 아니며, 예시는 문서에 있는 형식을 조합한 안내입니다. 현행 기능 전체의 최소 버전은 문서에 없어 미확인입니다.

빠른 결론

프로젝트용 파일은 기본적으로 .github/prompts에 .prompt.md 확장자로 저장합니다.
채팅의 /이름 또는 Chat: Run Prompt로 수동 실행합니다.
현재 공식 지원 범위는 Local harness 세션이며, 모든 Copilot 실행 환경에 공통 적용되는 기능은 아닙니다.

시작 전 기능 체크리스트

• VS Code에서 Copilot Chat을 사용할 수 있는 계정·환경을 준비합니다.
• 반복 요청을 현재 프로젝트에서만 쓸지, 사용자 프로필 전체에서 쓸지 정합니다.
• 프롬프트 파일은 수동 호출, custom instructions는 자동 적용이라는 차이를 구분합니다.
• Local 선택을 오프라인 모델 실행이나 데이터 무전송 보장으로 해석하지 않습니다.

워크스페이스 파일은 해당 작업 공간에서, 사용자 파일은 여러 작업 공간에서 사용할 수 있습니다. 팀과 공유할 요청은 프로젝트 범위를, 개인 작업 습관은 사용자 범위를 검토하세요. 사용자 파일의 운영체제별 절대 경로는 이 글에서 추측해 제시하지 않습니다.

1. 프롬프트 파일 만들기

1. Chat 화면의 Configure Chat 톱니바퀴를 열고 Prompts 탭으로 이동합니다.
2. New Prompt (Workspace) 또는 New Prompt (User)를 선택합니다.
3. 명령 팔레트의 Chat: New Prompt File을 사용하는 방법도 있습니다. 기본 단축키는 Windows·Linux Ctrl+Shift+P, macOS Shift+Command+P입니다.
4. 프로젝트 예시는 .github/prompts/explain-selection.prompt.md로 저장합니다. 다른 저장 위치를 고른 경우에는 실제 선택한 위치를 확인하세요.

2. 선택한 코드를 설명하는 요청 작성

다음은 공식 문법을 조합한 작성 예시입니다. 특정 모델·MCP 도구를 고정하지 않고 설명 요청에 필요한 내용만 넣었습니다.

---
description: 선택한 코드 설명
agent: ask
---
다음 코드를 초보자에게 한국어로 설명하세요.
입력과 반환값, 처리 흐름을 순서대로 정리하고
코드만으로 알 수 없는 부분은 미확인으로 표시하세요.

${selection}

YAML 헤더는 선택 사항이며 description은 설명, agent는 실행할 에이전트를 지정합니다. 현재 문서는 ask·agent·plan 또는 사용자 정의 에이전트 이름을 안내합니다. 모델을 생략하면 현재 모델 선택기의 모델을 사용합니다. 예시의 변수는 선택한 코드를 문맥에 넣는 용도입니다.

3. 저장한 요청을 직접 실행하기

1. 설명을 받을 코드 부분을 선택합니다.
2. Local harness 채팅에서 /explain-selection을 입력해 해당 프롬프트를 선택합니다.
3. 또는 Chat: Run Prompt를 실행해 파일을 고릅니다. 파일 편집기 위쪽 재생 버튼에서는 현재 채팅 또는 새 채팅 실행을 선택할 수도 있습니다.
4. 답변이 나오면 실제 선택한 코드의 입력·반환값과 대조합니다. 출력됐다는 사실만으로 설명이 정확하다고 보지는 않습니다.

활용 예를 들면 매주 검토하는 Java 메서드를 하나씩 선택해 같은 설명 형식으로 읽을 수 있습니다. 이는 활용 시나리오이지 실제 실행 결과가 아닙니다. 프롬프트가 같아도 코드 문맥과 모델에 따라 답변은 달라질 수 있습니다.

안 보이거나 실행되지 않을 때

• Local 세션인지, 확장자가 .prompt.md인지, 현재 작업 공간의 기본 폴더에 저장했는지 확인합니다.
• Chat: Configure Prompt Files 목록에서 파일 위에 마우스를 올려 출처 위치를 확인합니다.
• 발견 오류는 Chat의 … → Show Agent Debug Logs에서 확인합니다. 파일을 발견한 것과 요청을 올바르게 실행한 것은 따로 점검합니다.
• 화면이 문서와 다르면 VS Code·Copilot 버전과 계정의 기능 제공 상태를 기록해 공식 문서와 대조합니다. 오래된 실험 설정을 무조건 추가하지 마세요.

보안·비용·동기화 주의

저장소에서 받은 프롬프트는 실행 전 내용을 읽고 비밀키·고객 자료가 문맥에 들어가지 않는지 확인하세요. tools를 넣는 경우 실행 권한과 영향을 별도로 검토해야 합니다. 파일을 저장하는 것과 AI 요청을 실행하는 것은 다르며, Copilot Chat 실행은 계정의 사용량·청구 조건을 따릅니다. 무료 계정도 무제한 실행으로 단정하지 않습니다.

사용자 프롬프트를 기기 사이에 동기화하려면 Settings Sync: Configure에서 Prompts and Instructions 항목을 확인합니다. 관련해서 VS Code 설정 동기화 켜기·끄기를, 낯선 저장소의 실행 권한은 Workspace Trust·제한 모드 안내를 함께 읽어보세요.

FAQ

Q1. 저장하면 모든 채팅에 자동 적용되나요?

아닙니다. 프롬프트 파일은 직접 호출합니다. 자동 적용 지침과 용도를 구분하세요.

Q2. 다른 harness에서도 같은 방식으로 실행하나요?

현재 문서는 Local만 지원한다고 명시합니다. 다른 harness의 재사용 작업에는 agent skill을 안내하므로 같은 기능으로 가정하지 마세요.

Q3. 만들기 명령이 없으면 파일 이름만 바꾸면 되나요?

이름만 맞춰도 현재 환경의 지원 여부가 확인되는 것은 아닙니다. 버전·계정·세션과 공식 생성 경로부터 확인하세요.

공식 출처

• VS Code: Use prompt files — 위치·형식·생성·실행·지원 범위
• GitHub: Copilot 개인 사용량·청구 — 실행 시 사용량 구분

2026년 10월 18일 확인. 메뉴 이름은 공식 영문 표기이며 언어팩에 따라 번역이 다를 수 있습니다.