GitHub Copilot 처음 시작하기, VS Code에서 질문·제안·수정을 나누는 법

GitHub Copilot 입문을 상징하는 빈 코드 노트와 키보드, 작은 데스크톱 컴퓨터가 놓인 작업대

AI를 활용하여 생성한 이미지입니다.

AI · LLM · 초보자 가이드

GitHub Copilot을 처음 쓸 때는 코드를 한 번에 맡기기보다, 질문·자동 제안·수정 요청을 서로 다른 작업으로 나누는 편이 이해하기 쉬워요. GitHub 공식 문서에 따르면 Copilot은 지원되는 IDE에서 개념 설명, 코드 완성, 수정 제안, 파일 검증을 도와줄 수 있습니다.[1] 다만 시작하려면 활성 Copilot 플랜, IDE 확장 프로그램, IDE 안의 GitHub 로그인이라는 세 가지 준비가 필요해요.[1]

Copilot으로 무엇을 할 수 있을까?

초보자에게는 세 가지 기능만 먼저 익히면 충분해요. 첫째, 열어 둔 코드에 대해 “이 파일은 무엇을 하나요?”처럼 질문할 수 있습니다. 둘째, 함수 머리말을 쓰면 회색 글씨로 코드 제안이 나타나고 Tab 키로 받아들일 수 있어요. 셋째, Chat 창에서 수정할 파일과 원하는 결과를 설명해 제안을 받을 수 있습니다.[1]

하고 싶은 일 먼저 쓸 기능 확인할 것
처음 보는 코드 이해하기 Chat 질문 설명이 실제 코드와 맞는지 줄 단위로 확인해요
반복적인 함수 뼈대 만들기 인라인 제안 입력·출력과 예외 처리를 직접 읽어요
여러 파일을 고치기 Agent 모드 또는 수정 제안 바뀐 파일 목록과 diff를 먼저 검토해요
실행 오류 찾기 오류 메시지 질문 비밀값과 개인정보를 지운 뒤 붙여 넣어요

설치 전에 준비할 것

  1. GitHub 계정으로 사용할 Copilot 플랜이 활성 상태인지 확인합니다.
  2. 사용 중인 IDE에 GitHub Copilot 확장 프로그램을 설치합니다.
  3. IDE 안에서 GitHub 계정으로 로그인합니다.
  4. 테스트용 작은 프로젝트나 비밀값이 없는 파일을 엽니다.

이 준비가 끝나지 않으면 단축키나 프롬프트를 바꿔도 Copilot이 나타나지 않을 수 있어요. GitHub 문서는 VS Code, Visual Studio, JetBrains IDE, Eclipse, Xcode 등 지원 IDE를 구분해 안내하므로, 설치 전에 자신의 편집기가 지원 대상인지 확인하는 것이 좋습니다.[1]

첫 질문은 코드 설명으로 시작해요

VS Code에서는 코드 파일을 연 뒤 Copilot Chat 창을 열 수 있고, 공식 안내에는 Windows·Linux의 Ctrl + Alt + I, macOS의 Control + Command + I 단축키가 예시로 나와 있어요.[1] 첫 질문은 “이 파일의 입력과 출력, 외부 의존성을 초보자에게 설명해 주세요”처럼 범위를 나누어 쓰는 편이 좋아요.

답변을 그대로 문서로 믿지는 마세요. 설명이 틀렸는지 보려면 함수 호출 위치, 파일을 읽고 쓰는 부분, 예외 처리 부분을 실제 코드와 비교해야 합니다. Copilot은 코드의 의도를 추측해 설명할 수 있지만, 프로젝트의 실행 결과를 자동으로 보증하는 도구는 아니에요.

인라인 코드 제안을 받는 순서

  1. 새 JavaScript 파일을 만듭니다.
  2. 함수 이름과 매개변수처럼 의도를 보여 주는 머리말을 작성합니다.
  3. 회색 제안이 나타나면 입력값, 반환값, 오류 처리부터 읽습니다.
  4. 필요한 부분만 Tab으로 받아들이고, 낯선 코드는 바로 실행하지 않습니다.
  5. 작은 입력값으로 테스트한 뒤 변경 내용을 저장합니다.

GitHub의 quickstart는 날짜 사이의 차이를 계산하는 함수 머리말을 예로 들어 자동 제안을 받고 Tab으로 수락하는 흐름을 보여 줍니다.[1] 예제와 똑같은 코드가 나와야 하는 것은 아니에요. 중요한 것은 제안이 나타나는 과정과 수락 전에 내용을 읽는 습관입니다.

여러 파일을 바꿀 때는 Agent를 늦게 써요

지원되는 IDE의 Agent 모드에서는 원하는 작업을 설명하면 Copilot이 파일을 고르고, 편집하고, 명령을 실행하는 흐름을 제안할 수 있어요. GitHub 문서도 Agent가 파일을 변경하고 명령을 실행할 수 있으며, 사용자가 승인하는 절차를 거치도록 설명합니다.[1]

초보자는 “앱 전체를 고쳐 줘”보다 “src/date.js의 함수에 잘못된 입력 검사를 추가하고, 테스트 파일에는 실패하는 입력 두 개를 넣어 주세요. 파일별 변경 이유를 먼저 보여 주세요”처럼 범위를 좁혀 요청하세요. 실행 명령이 포함되면 승인 전에 명령어와 변경 파일을 읽고, 생성된 diff를 확인한 뒤 테스트를 실행하는 순서가 안전합니다.

비밀값은 질문에 넣지 않아요

API 키, 비밀번호, 개인 식별 정보, 회사 내부 문서를 그대로 Chat에 붙여 넣지 마세요. 오류를 설명할 때는 실제 값을 REDACTED로 바꾸고, 파일 경로와 계정 이름도 필요하지 않으면 지우는 편이 좋습니다. 생성된 코드에 키를 하드코딩하지 말고 환경 변수나 프로젝트의 비밀 관리 방법을 사용하세요.

Copilot이 제안한 코드가 실행된다고 해서 안전하다는 뜻도 아니에요. 네트워크 요청, 파일 삭제, 인증 처리, 결제 로직처럼 결과가 큰 부분은 공식 문서와 테스트를 따로 확인해야 합니다. AI 답변의 구조를 만드는 방법은 AI에게 원하는 답을 받는 프롬프트 구조에서도 이어서 볼 수 있어요.

처음 사용할 때의 점검 목록

  • Copilot 플랜·IDE 확장·GitHub 로그인을 확인하기
  • 비밀값이 없는 작은 파일로 첫 질문 시작하기
  • 코드 제안을 수락하기 전에 입력·출력·예외 처리 읽기
  • 여러 파일 수정은 범위와 파일 목록을 먼저 제한하기
  • Agent가 제시한 명령과 diff를 승인 전에 검토하기
  • 테스트를 실행하고 결과를 직접 확인하기

Sources

함께 읽을 글