코딩은 단순히 코드를 작성하는 것만이 아닙니다. 오래된 로직을 읽거나, Git 커밋 형식을 맞추고, 터미널 명령어를 찾는 등의 작업은 개발 시간을 빼앗아 갑니다. GitHub Copilot은 이를 변화시키겠다고 약속하지만, 기본적인 프롬프트(Prompt)는 종종 일반적이거나 잘못된 결과를 제공합니다.

Copilot을 고도로 전문화된 어시스턴트로 바꾸려면 적절한 컨텍스트(Context)를 제공해야 합니다. 이 가이드는 Visual Studio Code 내에서 더 빠르게 코드를 개발할 수 있도록 도와주는 커스텀 AI 규칙(Custom AI rules)과 워크플로우 단축키를 활용한 최고의 숨겨진 기능들을 탐구합니다.

(참고: 따라 하려면 GitHub Copilot 확장 프로그램을 수동으로 설치하고 무료 또는 유료 플랜에 연결해야 합니다).

1. 구체적으로 작성하세요: 더 나은 코드를 위한 비결

Copilot에 주는 지침이 훌륭한 결과를 얻는 비결입니다. 모호한 프롬프트(Prompt)를 작성하면 AI는 사용자가 원하는 것을 추측해야만 하며, 이는 대개 오류로 이어집니다. 나중에 망가진 코드를 다시 작성하는 것보다 처음에 명확한 지침을 작성하는 데 시간을 쓰는 것이 훨씬 빠릅니다. 복잡한 작업이 있다면, Copilot에 붙여넣기 전에 ChatGPT와 같은 도구를 사용하여 완벽하고 상세한 프롬프트를 계획하는 데 도움을 받을 수도 있습니다.

• ❌ 나쁜 프롬프트 (너무 일반적임): "내 앱을 위한 회원가입 함수를 만들어줘."
• ✅ 좋은 프롬프트 (구체적이고 명확함): "Node.js와 Express를 사용하여 사용자 회원가입을 위한 JavaScript 함수를 만들어줘. 이름, 이메일, 비밀번호를 수집해야 해. MongoDB 데이터베이스에 저장하기 전에 bcrypt를 사용하여 비밀번호를 해싱해줘. 이메일이 이미 존재하면 400 에러를 반환해줘."

프롬프트가 상세할수록 결과는 더 좋아집니다. 다양한 컴포넌트로 페이지를 구축하거나, 특정 코딩 표준을 따르고, 테스트를 추가하는 것과 같은 더 큰 작업의 경우, 요청을 명확한 단계로 나누세요. ChatGPT는 Copilot이 이해할 수 있도록 해당 프롬프트를 정리하는 데 큰 도움이 될 수 있습니다.

2. VS Code 내부에서 직접 Copilot으로 UI 디버깅하기

VS Code는 에디터를 벗어나지 않고도 웹 애플리케이션을 실행하고 테스트할 수 있는 통합 브라우저 (integrated browser) 기능을 제공합니다. Copilot과 결합하면, 이 기능은 강력한 AI 기반 디버깅 어시스턴트로 변모합니다. UI 요소를 검사하고 캡처한 다음, Copilot에게 즉시 코드를 다시 작성하고 수정 사항을 적용하도록 요청할 수 있습니다. 통합 브라우저 설정 방법 알아보기.

3. AI를 위한 커스텀 규칙 파일 (Custom rules files)

프롬프트 채팅을 사용할 때마다 매번 지침을 입력하는 대신, Markdown 형식의 규칙 파일을 프로젝트 내부에 직접 저장할 수 있습니다. Copilot은 프로젝트 공간 내에서 세 가지 특정 유형의 Markdown 설정 파일을 기본적으로 지원합니다:

AGENTS.md

프로젝트의 루트 (root) 디렉토리에 직접 배치합니다. 이는 범용적인 멀티 에이전트 (multi-agent) 표준이 되어가고 있으며, VS Code는 모든 채팅 요청에 대해 이를 자동으로 감지합니다. 내용은 짧게 유지하고, 기술 스택 (tech stack), 프로젝트 구조, 빌드/테스트 명령, 그리고 명확하지 않은 도구 사용법(예: Python의 경우 pip 대신 uv, JavaScript의 경우 npm 대신 pnpm)을 문서화하세요. 상세한 디렉토리 목록, 코드 스타일 가이드라인, 특정 작업에 국한된 지침은 피하십시오. 이러한 정보는 집중도를 떨어뜨리고 에이전트가 더 빠르게 탐색하는 데 도움이 되지 않습니다. 예시는 agents.md에서 확인할 수 있습니다.

.github/copilot-instructions.md

이 파일은 Copilot 전용이며 저장소 루트의 .github 디렉토리에 위치합니다. 이미 루트에 AGENTS.md가 있다면 이 파일은 선택 사항입니다. 두 파일이 모두 존재하면 지침이 결합되므로, 동일한 규칙을 반복하지 않도록 주의하세요. 일반적으로 루트의 AGENTS.md 항목이 기본으로 취급되며, 다른 곳에 있는 추가 지침보다 더 큰 영향력을 갖는 경우가 많습니다.

.github/instructions/NAME.instructions.md

이러한 방식은 react.instructions.md 또는 database.instructions.md와 같이 세밀하고 경로별로 특화된 사용자 지정 지침 (custom instructions)을 위해 사용됩니다. Copilot은 현재 파일 경로가 파일 상단 프론트매터 (frontmatter)에 선언된 applyTo 패턴과 일치할 때만 이를 적용합니다. 예를 들어, TypeScript 파일만을 대상으로 하려면 applyTo: "**/*.{ts,tsx}"를 설정하십시오. 경로별 지침을 생성하는 방법은 Copilot 문서 여기에서 확인할 수 있습니다.

4. 터미널에서 Copilot 사용하기

GitHub CLI를 설치하고 gh copilot을 실행하여 AI 명령 도움말을 받고, 구문을 확인하며, 셸 (shell)에서 GitHub 워크플로우를 간소화하십시오. 이는 명령 및 워크플로우 단계에 대한 빠른 안내를 받으면서도 한 곳에서 계속 작업할 수 있는 훌륭한 방법입니다.

5. 인라인 채팅 (inline chat)으로 코드 생성 속도 높이기

Copilot Inline Chat을 사용하여 작업 중인 위치에서 즉시 코드 생성, 리팩터링 (refactor), 또는 수정 (fix)을 요청하십시오. 마우스 오른쪽 버튼을 클릭하고 'Open Inline Chat'을 선택하거나, Mac에서는 Cmd + I, Windows에서는 Ctrl + I를 누르면 별도의 패널로 이동할 필요 없이 현재 줄에 집중할 수 있습니다.

6. 더 빠른 도움을 위한 슬래시 명령어 (Slash commands)

슬래시 명령어는 매우 유용하며 Copilot을 채팅을 위한 커맨드 팔레트 (command palette)처럼 느껴지게 할 수 있습니다. 채팅창이나 인라인 채팅 창에서 /를 입력하면 /explain, /fix, /tests와 같은 동작을 볼 수 있으며, 몇 단어를 추가하여 결과를 좁힐 수 있습니다.

• 빠른 수정 (Quick fix): /fix를 입력하여 Copilot에게 현재 선택 영역을 복구하도록 요청하십시오.
• 대상 지정 리뷰 (Targeted review): /explain 뒤에 Focus on the security implications와 같은 프롬프트 (prompt)를 추가하여 더 구체적인 답변을 얻으십시오.

반복적인 작업을 위한 사용자 지정 프롬프트 생성

추가적인 컨텍스트 (context)가 포함된 재사용 가능한 프롬프트 지침 (prompt instruction) 파일을 생성하여 슬래시 명령어 (slash commands)를 사용자 지정할 수 있습니다. 이를 통해 코드 마이그레이션 (code migrations), 테스트 생성 (test generation), 보안 점검 (security checks), 또는 README 업데이트와 같은 반복적인 작업을 자동화할 수 있습니다. 이 파일들을 .github/prompts/ 디렉토리에 NAME.prompt.md 형식으로 저장하십시오 (예: readme.prompt.md). 프롬프트 파일에 대한 자세한 내용은 여기에서 확인하실 수 있습니다.

7. 빠른 코드 설명, 리뷰 및 수정

긴 프롬프트를 작성할 필요 없이 코드 블록에 대해 즉각적인 도움을 받으십시오. 작업하려는 코드를 선택하면 Copilot이 코드를 설명, 리뷰 또는 수정할 수 있는 스마트 액션 (smart actions)을 제시합니다. 이는 레거시 로직 (legacy logic)을 이해하거나, 숨겨진 버그를 발견하거나, 지저분한 포맷팅 (formatting)을 정리하는 가장 빠른 방법인 경우가 많습니다.

• 우클릭 메뉴: 코드를 강조 표시한 후, 마우스 오른쪽 버튼을 클릭하고 Explain (설명), Review (리뷰) 또는 Fix (수정)를 선택하십시오.
• 전구 아이콘: 코드를 강조 표시한 후 에디터 거터 (gutter, 왼쪽 여백)에 있는 노란색 전구 아이콘을 클릭하여 동일한 AI 퀵 액션 (quick actions)에 접근하십시오.

8. AI가 생성하는 커밋 메시지

좋은 Git 커밋 메시지를 작성하는 데는 시간이 걸리지만, Copilot은 실제 파일 변경 사항을 기반으로 대신 작성해 줄 수 있습니다. 소스 제어 (Source Control) 패널 내에서 커밋 메시지 입력창 오른쪽의 반짝이는 Sparkle/Stars 아이콘을 클릭하기만 하면 됩니다. Copilot은 스테이징된 (staged) 변경 사항을 분석하여, 커밋하기 전에 검토, 편집 및 승인할 수 있는 명확하고 의미 있는 메시지를 생성합니다.

글로벌 settings.json에 규칙을 추가함으로써 Jira 티켓 번호를 포함하는 것과 같이 Copilot이 스타일 가이드 (style guide)를 따르도록 설정할 수 있습니다.
예를 들어, 커밋 메시지 앞에 현재 Git 브랜치 (branch) 이름을 접두사로 붙이도록 요청할 수 있습니다:

"github.copilot.chat.commitMessageGeneration.instructions": [
    {
      "text": "커밋 메시지는 반드시 다음 형식을 엄격히 따라야 합니다: [branch-name] [commit-message]. 제공된 컨텍스트 파일에서 활성 브랜치 이름을 읽으십시오. 닫는 대괄호 뒤에 정확히 한 칸의 공백을 두고 짧은 요약을 작성하십시오."
...

9. 작업에 가장 적합한 AI 모델 선택하기

Copilot은 무료 플랜에서도 GPT-5, Claude 또는 Gemini와 같은 다양한 모델을 사용할 수 있습니다. 코드 생성, 디버깅(debugging), 아키텍처(architecture) 등 자신의 목표에 맞는 모델을 선택한 다음, VS Code 채팅 패널 하단의 모델 선택기(model selector) 컨트롤에서 해당 모델을 선택하십시오. 지원되는 모델에 대해 자세히 알아보기.

10. Copilot 에이전트 (Copilot Agents)

에이전트(Agents)를 사용하면 Copilot이 도움을 주는 방식을 선택할 수 있습니다. VS Code 채팅 창 하단의 에이전트 모드(agent mode) 컨트롤을 사용하여 다음 내장 옵션 중 하나를 선택하십시오 (사용 가능한 옵션은 시간이 지남에 따라 변경될 수 있습니다):

• 에이전트 (Agent): 기본이자 가장 강력한 모드입니다. 터미널 명령어를 실행하고, 코드를 테스트하며, 파일을 편집하고, 더 광범위한 작업을 처리할 수 있습니다.
• 질문 (Ask): 코드에 대한 질문과 제안을 위한 더 가벼운 모드입니다. 빠른 예시, 가이드 및 테스트 조언을 얻기에 이상적입니다.
• 계획 (Plan): AI에게 변경 사항을 적용하도록 요청하기 전에 복잡한 작업을 더 작은 단계로 나누고 싶을 때 가장 적합합니다.

또한 특화된 워크플로우(workflows)를 위해 사용자 정의 에이전트(custom agents)를 생성할 수도 있습니다.

11. Copilot이 집중력을 유지하도록 돕기

하나의 채팅 창에 서로 다른 작업을 섞지 마십시오. 여러 주제를 결합하면 AI의 문맥 인식(contextual awareness)이 희석되어 환각(hallucination)된 로직으로 이어질 수 있습니다. 대신, 인증(authentication)을 위한 별도의 창과 WebSocket 프로토콜을 위한 별도의 창처럼 각 기능마다 새로운 세션을 여십시오. 이렇게 하면 프롬프트(prompt) 환경을 깨끗하게 유지하고 결과의 정확도를 높일 수 있습니다.

VS Code 채팅 세션 관리 가이드에서 스레드(threads)를 생성하고 전환하는 방법을 알아보십시오.

결론

GitHub Copilot은 명확한 지침을 제공하고 각 채팅의 집중도를 유지할 때 가장 잘 작동합니다. 프로젝트 규칙 파일, 터미널 AI 명령어, 그리고 작업에 적합한 모델 또는 에이전트를 사용하십시오. 더 나은 프롬프트가 더 나은 코드를 만듭니다.