VSCode Copilot 활용법 실전: 엉뚱한 코드 추천 줄이는 법

VSCode Copilot이 기껏 좋은 제안을 해주겠거니 기다렸는데, 매번 같은 패턴이나 맥락에 맞지 않는 불필요한 코드만 제안해서 오히려 코딩 흐름이 끊기고 답답했던 경험, 있으실 겁니다.

이는 Copilot이 주변 코드와 파일 확장자만으로 전체 컨텍스트를 완벽히 파악하기 어렵거나, 기본 설정이 모든 상황에 최적화되어 있지 않기 때문에 발생합니다.

이 글에서는 이러한 비효율적인 코드 추천을 효과적으로 줄이고, Copilot을 진정한 생산성 도구로 활용할 수 있는 실전 팁들을 구체적인 설정과 예시를 통해 제시합니다.

VSCode `settings.json`으로 Copilot 제어하기

Copilot은 기본적으로 모든 프로그래밍 언어에서 활성화되어 있습니다. 하지만 특정 언어에서는 Copilot의 제안이 오히려 방해가 되거나, 인라인 제안 자체가 불필요한 경우도 많습니다. 이러한 상황에서는 `settings.json` 파일을 수정하여 Copilot의 동작 방식을 세밀하게 제어하는 것이 중요합니다.

예를 들어, 마크다운 문서 작성 중에는 코드 제안이 거의 필요 없으며, YAML 파일에서는 스키마에 맞지 않는 엉뚱한 제안이 자주 나타날 수 있습니다. 개발 흐름을 방해하는 이러한 제안들을 언어별로 비활성화하거나, 인라인 제안의 전반적인 빈도를 조절함으로써 Copilot의 효율성을 획기적으로 개선할 수 있습니다.

1. `settings.json` 열기 — VSCode에서 `Ctrl + Shift + P` (macOS: `Cmd + Shift + P`)를 눌러 명령 팔레트를 열고, “Preferences: Open User Settings (JSON)”을 검색하여 선택합니다.
2. 언어별 Copilot 비활성화 — 특정 언어에서 Copilot의 인라인 제안을 비활성화하려면 다음 설정을 추가합니다. 예를 들어, `markdown`과 `yaml` 파일에서 Copilot을 끄려면 아래와 같이 설정합니다.
   json
   “github.copilot.enable”: {
   “*”: true, // 기본적으로 모든 언어에서 활성화
   “markdown”: false, // 마크다운에서 비활성화
   “yaml”: false // YAML에서 비활성화
   }
3. 인라인 제안 전체 비활성화 (선택 사항) — Copilot뿐만 아니라 다른 모든 인라인 제안 기능이 불편하다면, `editor.inlineSuggest.enabled` 설정을 `false`로 변경할 수 있습니다. 이는 Copilot의 인라인 제안에도 영향을 미치지만, 모든 인라인 제안을 끄기 때문에 신중하게 결정해야 합니다.

똑똑한 주석으로 Copilot 길들이기

Copilot은 단순히 코드만 분석하는 것이 아니라, 코드 주변의 주석도 중요한 컨텍스트로 활용합니다. 따라서 명확하고 구체적인 주석을 작성하는 것은 Copilot에게 원하는 코드의 의도를 정확하게 전달하고, 엉뚱한 제안을 줄이는 가장 효과적인 방법 중 하나입니다.

단순히 “이 함수는 데이터를 가져온다”와 같은 모호한 주석보다는, “이 함수는 `users` 테이블에서 `status`가 ‘active’인 사용자들을 비동기적으로 조회하여, 그 결과를 `User` 타입의 리스트로 반환한다”와 같이 상세한 설명을 제공해야 합니다. Copilot은 이러한 구체적인 지시를 바탕으로 약 80% 이상의 정확도로 사용자의 의도에 부합하는 코드를 생성할 확률이 높아집니다.

불필요한 추천, 단축키로 즉시 차단하기

아무리 Copilot을 잘 설정하고 똑똑하게 길들여도, 때로는 맥락에 맞지 않는 제안을 하는 것은 피할 수 없는 일입니다. 이럴 때는 잘못된 제안을 무시하거나, 다음 제안으로 빠르게 넘어가거나, 아예 다른 제안들을 한눈에 확인하는 기술이 필요합니다. 불필요한 제안에 시간을 낭비하지 않고 코딩 흐름을 유지하는 것이 중요합니다.

Copilot의 제안이 나타났을 때, 잘못된 코드라고 판단되면 즉시 키보드로 거절하고 원래 작업을 이어나가야 합니다. 멈칫하는 시간 5초가 쌓여 전체 개발 시간을 비효율적으로 만듭니다. 몇 가지 핵심 단축키를 익히면 이런 비효율을 효과적으로 줄일 수 있습니다.

프로젝트 컨텍스트 학습 및 제약 설정

Copilot은 단순히 현재 열려 있는 파일만으로 컨텍스트를 파악하는 것이 아닙니다. 프로젝트 내의 다른 파일들, 특히 관련성이 높은 파일들을 분석하여 제안의 품질을 높입니다. 따라서 Copilot이 불필요하거나 잘못된 컨텍스트를 학습하지 않도록, 학습 범위를 적절히 제약하는 것도 중요한 활용 팁입니다.

예를 들어, 테스트 코드, 설정 파일, 혹은 특정 빌드 스크립트처럼 일반적인 로직 흐름과 무관한 파일들은 Copilot의 제안에 혼란을 줄 수 있습니다. `.gitignore` 파일에서 제외된 파일들처럼, Copilot이 분석할 필요가 없는 파일들을 명시적으로 지정하여 학습 효율을 높이고, 더욱 정확한 제안을 유도할 수 있습니다.

1. `.copilotignore` 파일 활용 (Gitignore와 유사) — 프로젝트 루트에 `.copilotignore` 파일을 생성하고, Copilot이 분석하지 않기를 원하는 파일이나 폴더 패턴을 `.gitignore` 문법과 유사하게 작성합니다. 예를 들어, `test/`, `*.spec.ts`, `docs/` 등을 추가할 수 있습니다.
2. 코드베이스 일관성 유지 — Copilot은 코드베이스의 패턴을 학습하므로, 일관된 코딩 스타일과 명명 규칙을 유지하는 것이 중요합니다. 불필요하게 다양한 방식으로 작성된 100라인 이상의 파일은 Copilot에게 혼란을 줄 수 있습니다.
3. `README.md` 및 주석 파일 최신화 — 프로젝트의 핵심 로직이나 아키텍처를 설명하는 `README.md` 파일이나 별도의 `ARCHITECTURE.md` 같은 파일은 Copilot에게 프로젝트의 전체적인 맥락을 이해시키는 데 큰 도움을 줍니다. 이러한 문서들을 최신 상태로 유지하면 Copilot의 이해도를 높일 수 있습니다.