VS Code + GitHub Copilot 세팅 처음 설치부터 활용까지

IT에서 일하는 분들이라면 제말에 공감하실텐데 많이들 거북목과 손목 터널 증후군을 가지고 있을꺼에요. 특히 손목은 너무 아파서 키보드에서 뭔가 하는 것 자체가 힘들때도 있거든요. 손목 보호대를 착용하는건 기본이고 병원가서 주사를 맞아야 하는 경우도 있었어요. 그런데 신기한게 옆자리 신입 개발자는 제 타자 속도보다 느린 편임에도 퇴근은 늘 저보다 한 시간씩 빨랐습니다. 아 뭔가 손해 보는 것 같아서 물어보니 VS Code에 GitHub Copilot을 연동해서 쓴다더군요.

오랫동안 it에서 일했지만 고집만 쎄서 이전 방식을 고집했더니 이렇게 차이가 발생하더군요. 그래서 저도 코파일럿을 제 개발 환경에 도입했습니다. 단순히 확장 프로그램을 설치하는 걸 넘어서, 실무에서 효과를 최대한 뽑아내려 단축키를 직접 커스텀해보고 코파일럿 이녀석이 제대로 알아듣도록 프롬프트를 꽤 공을 들였습니다.

vscode-ui

1. 내 손목을 구원한 로컬 IDE 개발 환경

일단 저는 회사에서는 윈도우PC를 쓰고 집에서는 맥북(겉멋용)을 번갈아 사용하지만, GitHub Copilot은 깃허브 계정과 연동되기 때문에 어떤 기기에서든 비슷한 퍼포먼스를 보여줍니다. 이 점은 여러 장비에서 작업하는 제게는 아주 큰 장점이었습니다. 특히 윈도우 11 Pro와 macOS 환경 모두에서 문제없이 작동하는 걸 확인했습니다.

운영체제: Windows 11 Pro 및 macOS Sonoma (OS 구분 없이 안정적 실행)
코드 편집기: Visual Studio Code (버전 1.87 이상 최신 버전 사용 권장)
필수 확장 프로그램: GitHub Copilot, GitHub Copilot Chat 두 가지를 반드시 함께 설치해야 제대로 된 기능을 경험할 수 있습니다.
구독 플랜: GitHub Copilot Individual (월 10달러, 연 100달러. 학생이나 인증된 오픈소스 기여자는 무료입니다)
주요 테스트 언어: Python 3.12, JavaScript

특히 코파일럿 채팅 확장 프로그램이 없으면 생각보다 답답한 점이 많더군요. 그래서 두 개 확장 프로그램을 꼭 세트로 쓰는 게 아주아주 중요합니다.

2. 코파일럿 설치부터 활용법까지

자 기본적인 설치는 마켓플레이스에서 버튼 한번 클릭으로 간단히 끝나지만, 진짜 문제는 이걸 얼마나 내 업무 스타일에 맞게 길들이느냐입니다. 제대로 세팅하지 않으면 코파일럿은 그저 1달러짜리 타자기 수준일 뿐, 제대로 활용하면 100달러짜리 개발자급 보조 역할을 톡톡히 해줍니다.

제가 가장 먼저 손본 게 단축키 맞춤화였습니다. 기본 단축키는 제가 자주 사용하는 것 들과 맞지 않아 자주 헷갈렸고, 특히 다른 확장 프로그램과 충돌이 빈번했었습니다. 이걸 고치고 이후에는 프롬프트 작성법도 연구했는데, 간단한 한 줄 주석만으로도 코파일럿이 훨씬 정확한 코드를 추천하는 경우가 많았습니다.

1단계: 확장 프로그램 설치 및 깃허브 계정 인증

VS Code 왼쪽 사이드바에서 확장(Extensions) 아이콘을 눌러 ‘GitHub Copilot’을 검색하시면 됩니다. 아시는 것처럼 파란색 배지(아이콘)가 붙은 공식 확장을 골라 설치하면, 우측 하단에 로그인 창이 뜹니다. 거기에 본인 GitHub 계정 정보를 입력해 인증 절차를 마무리해야 합니다. 인증이 완료되면 우측 하단 상태 표시줄에 사람 얼굴 모양의 귀여운 Copilot 아이콘이 생기는데, 이게 제대로 작동한다는 의미겠죠?

2단계: 실무 생산성을 폭발시키는 필수 단축키 숙지

Copilot을 제대로 쓰려면 마우스 클릭을 줄이고 단축키를 몸에 익히는 게 기본입니다. 저는 모니터 옆에 포스트잇으로 붙여놓고 무의식적으로 쓰게 될 때까지 반복했습니다. 핵심 단축키 세 가지는 다음과 같습니다.

Tab: 코파일럿이 회색으로 제안한 전체 코드를 한 번에 수락할 때 씁니다. 한 줄씩 확인하려면 너무 무리이고, 빠르게 적용할 때 유용하지만 무조건 신뢰하면 의도치 않은 코드가 들어갈 수 있어 주의가 필요합니다.
Ctrl + Right Arrow (Mac은 Cmd + Right Arrow): 한 단어 단위로 제안된 코드를 받아들일 때 씁니다. 개인적으로 가장 자주 쓴 단축키인데, 뒷부분이 마음에 안 들 때 조각조각 받아서 수정하는 게 편리했습니다.
Alt + ] / Alt + [ (Mac은 Option + ] / [): Copilot이 제안하는 여러 대안을 넘나들 때 씁니다. 여러 제안 중에 뭔가 더 나은 문장이 있을까 싶어 종종 살펴보지만, 이 기능이 생각보다 직관적이지 않아 한참 헤맬 때가 많았습니다.

이 단축키들이 자동 완성 기능을 과신하지 않고 내 의도를 최대한 반영해 코딩할 수 있도록 도와줍니다. 하지만 실무에서 단축키를 외워도 가끔 헷갈려서 마우스에 손이 가는 일이 있었는데, 그럴 때마다 작업 흐름이 끊겨서 번번이 집중력이 흐트러졌습니다.

3단계: 주석을 활용한 마법의 자동 생성 실습 (전체 코드)

제가 가장 유용하게 느낀 건 주석으로 직접 기능을 설명해서 필요한 코드를 자동 생성하는 것 이었습니다. 예를 들자면 파이썬 파일에 아래처럼 주석으로 요구사항을 상세히 적어놓으면, Copilot이 그 맥락을 읽고 적절한 코드를 제안합니다. 이걸 ‘프롬프트 주석’이라고 부르는데 그냥 단순히 함수 이름만 적는 것보다는 훨씬 더 정확한 코드를 받을 수 있었습니다.

import requests
from bs4 import BeautifulSoup
import pandas as pd

1. 뉴스 IT/과학 섹션 메인 페이지를 스크래핑하는 함수를 만들어줘.
2. 기사 제목과 링크를 추출해서 리스트 형태로 반환해야 해.
3. HTTP 상태 코드가 200이 아닐 경우 예외 처리를 반드시 포함해줘.
4. 헤더에 User-Agent를 포함해서 봇 차단을 우회해줘.
def get_naver_it_news():
# 여기서부터 엔터(Enter)를 치고 잠시 기다리면,
# 아래의 코드가 회색 글씨로 스르륵 나타납니다. Tab을 눌러 수락합니다.
url = "https://news.naver.com/main/main.naver?mode=LSD&mid=shm&sid1=105"
headers = {
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()
    
    soup = BeautifulSoup(response.text, 'html.parser')
    articles = []
    
    # 실제 웹 구조에 맞춰 셀렉터를 자동 추천해줍니다.
    for item in soup.select('.sh_text a'):
        title = item.text.strip()
        link = item.get('href')
        articles.append({'title': title, 'link': link})
        
    return articles
    
except requests.exceptions.RequestException as e:
    print(f"네트워크 에러 발생: {e}")
    return []
테스트 실행 코드까지 알아서 제안해 줍니다.
if name == "main":
news_data = get_naver_it_news()
df = pd.DataFrame(news_data)
print(df.head())

다만 코파일럿이 가끔 이상한 셀렉터를 추천하거나 예외 처리 구문에서 미묘한 실수를 ㅎ는 경우도 있긴해요. 자동 생성된 코드를 무조건 믿으면 낭패를 볼 수 있으니, 무조건 여러분도 검토해보시고 테스트까지 하셔야 합니다.

💡 여기서 주의할 점: ‘열려 있는 탭’이 곧 컨텍스트(Context)다

코파일럿은 마술사가 아닙니다. 달랑 파일 하나만 보고 척척 코드를 맞춰주는 수준은 아니에요. 제가 직접 써보니, 공통 함수나 DB 모델링 같은 중요한 파일들을 VS Code에서 다른 탭으로 열어둬야 이를 이해하고 제대로 된 코드를 뽑아내더군요. 이 열린 탭들이 코파일럿에 배경지식 역할을 하는거죠.

3. 치명적 에러 완벽 해결법

집에서 잘만 돌아가던 코파일럿이 회사 보안망에 들어가면 완전히 멈춰버리는 상황이 생기기도 했어요.

첫 번째 위기: 사내 VPN 접속 시 self signed certificate 에러 발생

VPN이나 프록시를 켜면 코파일럿 로그인 시 우측 하단 아이콘에 빨간 X가 뜨면서 인증서 오류 메시지가 떴습니다. 회사 방화벽이 패킷을 가로채면서 자체 인증서를 씌우기 때문에 생긴 문제였죠. 이걸 해결하려면 settings.json 파일에 "http.proxyStrictSSL": false를 넣어 SSL 검증을 끄고, "github.copilot.advanced": { "debug.overrideProxyUrl": "http://사내프록시주소:포트" }를 강제로 지정해야 했습니다. 덕분에 사내망에서도 코파일럿이 제대로 작동해 답답함이 줄었지만, 이런 설정은 보안상 신중해야 한다는 점을 간과하면 곤란합니다.

두 번째 낭패: 구버전(Deprecated) 문법만 고집하는 고집불통 문제

저는 파이썬 Pydantic 라이브러리 v2 버전을 사용하는데, 코파일럿이 계속 v1 시절 문법만 추천해서 코드가 에러 투성이가 됐습니다. AI 학습 데이터가 2021~2022년까지만 반영돼서 최신 문법을 알지 못한 겁니다. 이럴 때는 사이드바의 Copilot Chat (대화형 챗봇)을 열고 @workspace Pydantic v2 공식 문서를 기반으로 이 코드를 마이그레이션 해줘라고 명령하거나, 공식 문서 URL을 채팅창에 넣어줘야 그제서야 최신 문법에 맞게 코드를 고쳐줍니다. 개인적으로 이런 ‘과거 기억 고집’ 현상은 AI가 아직 실무에 완벽하지 않다는 걸 보여주는 단면이겠죠.

4. 코파일럿 도입 후 체감

실제 결제 후 체감된 업무 변화는 상당했습니다.

관절 통증 해방: 코드 짤때 무조건 하던 여러가지 반복 타이핑이 엄청 줄었습니다. 예를 들어, For문이나 Try-Catch문, 기본 API 엔드포인트 세팅처럼 기계적으로 쳐야 했던 코딩 시간이 기존 30분에서 단 2분으로 줄어들었죠. 솔직히 이건 진짜 꿀 인것 같아요.
구글링 시간 90% 증발: 복잡한 이메일 검증 정규표현식(Regex)이나 Pandas 데이터프레임 병합 코드를 검색하느라 허비하던 하루 평균 1.5시간이 주석 한 줄로 대체되면서 완전히 사라졌습니다. 물론 초반에는 코파일럿이 제시한 코드가 맞는지 검증하는 데 시간이 좀 걸렸어요.
테스트 코드(TDD) 작성률 증가: 가장 귀찮았던 단위 테스트 작성이 Copilot Chat의 /tests 명령어 한 번으로 통째로 생성되더군요.

5. 요약

저는 GitHub Copilot 세팅 덕분에 일하는 시간도 손목 통증도 많이 줄었어요.

VS Code에 GitHub Copilot 확장을 깔고, Tab과 Alt+] 단축키를 완전히 몸에 익히는 게 기본 중의 기본입니다. 당연히 단축키 없이는 자동 완성 기능을 쓰기는 어려워요.
주석으로 AI에게 뭘해야 하는지 구체적인 작업 지시를 주고, 관련 파일을 미리 열어 컨텍스트를 충분히 제공해야 AI가 더 정확한 코드를 제안합니다. 안 그러면 엉뚱한 코드가 나와서 시간만 낭비합니다.
사내망에서 인증서 문제로 에러가 뜨면 settings.json에서 Proxy와 SSL 설정을 꼼꼼히 조정해 우회해야 합니다. 이 부분은 네트워크 환경마다 달라서 제대로 설정하지 않으면 한참 헤맬 수밖에 없습니다.

하지만 코파일럿이 제안하는 코드를 제대로 검증할 기본 문법 지식이 없는 초보자라면, 오타와 잘못된 코드가 섞여 버그를 양산할 위험이 큽니다. 그래서 최소한의 문법 감각은 반드시 갖추고 써야 한다고 봅니다.

목차