AI와 개발을 쉽게 이해하는 실험실

비개발자도 따라오는 AI 도구, 자동화, 개발 실험 기록

개발 & 기술/개발 환경

VS Code Tab 자동완성 안 될 때: Copilot·Cursor·Claude별 원인

루민 Lumin 2026. 7. 12. 15:33
반응형

VS Code Tab 자동완성이 안 되는 원인은 사용 중인 AI 확장 프로그램에 따라 다릅니다. Copilot은 로그인·구독 상태, Cursor는 별도 에디터라는 점, Claude Code는 애초에 인라인 자동완성이 아니라는 점에서 원인이 갈립니다. 이 글은 지난 1편에서 다룬 공통 원인(키 바인딩·확장 충돌) 다음 단계로, 도구별로 실제 걸리는 지점을 하나씩 짚습니다. 처음엔 저도 "왜 나만 안 되지" 싶었는데, 알고 보면 도구 성격을 오해한 경우가 절반 이상이었습니다. 특히 Claude Code 쪽은 Tab 자동완성을 기대하는 것 자체가 잘못된 접근일 수 있어서, 이 부분부터 짚고 갑니다.

세 도구는 자동완성 방식이 아예 다릅니다

Copilot·Cursor·Claude Code는 겉보기엔 비슷해 보여도 자동완성 동작 원리가 다릅니다. 그래서 "Tab이 안 먹힌다"는 같은 증상이라도 원인 위치가 완전히 달라집니다.

먼저 한눈에 비교하겠습니다.

도구 형태 Tab 자동완성 주요 원인 위치
GitHub Copilot VS Code 확장 ⭕ 인라인 회색 텍스트 로그인·구독·확장 활성화
Cursor 별도 에디터 (VS Code 포크) ⭕ Cursor Tab 기능 Cursor 앱 안에서만 동작
Claude Code CLI(터미널) 도구 ❌ 원래 없음 자동완성 개념 자체가 다름

여기서 Claude Code부터 짚고 넘어가야 합니다. Claude Code는 터미널(검은 화면에 명령어를 치는 창)에서 실행되는 도구입니다. VS Code 편집기 안에서 코드를 치는 동안 회색 글씨로 다음 코드를 미리 보여주는 방식이 아니라는 뜻입니다.

그래서 "VS Code에서 Claude Code Tab 자동완성이 안 된다"는 질문 자체가 성립하지 않는 경우가 많습니다. Claude Code는 대화로 지시를 내리면 파일을 통째로 수정해주는 도구에 가깝습니다.

💡 Copilot·Cursor는 "다음 몇 줄을 예측해서 회색으로 보여주고 Tab으로 확정"하는 인라인 방식입니다. Claude Code는 "이 함수 리팩터링해줘"라고 말하면 파일을 편집해주는 방식이라, Tab 키와는 애초에 무관합니다.

Copilot에서 Tab이 안 먹힐 때

GitHub Copilot에서 Tab 자동완성이 안 되는 가장 흔한 원인은 로그인 세션 만료구독 상태 미인식입니다. 확장 설치가 됐다고 끝이 아니라, GitHub 계정 인증이 살아 있어야 회색 힌트가 뜹니다.

확인 순서는 이렇습니다.

  1. VS Code 오른쪽 아래 상태바에서 Copilot 아이콘 확인
  2. 아이콘에 사선(빗금)이 있으면 → 비활성 상태
  3. 아이콘 클릭 → "Sign in to GitHub" 또는 "Enable Completions"

저는 예전에 계정을 두 개 오가면서 쓰다가 세션이 꼬여서, 한동안 Tab 힌트가 아예 안 뜨는 상태로 방치한 적이 있습니다. 명령 팔레트(F1 또는 Ctrl+Shift+P)에서 GitHub Copilot: Sign Out 후 다시 로그인하니 바로 복구됐습니다.

구독 확인도 놓치기 쉽습니다. 무료 체험이 끝나면 확장은 설치돼 있어도 인라인 힌트가 안 뜹니다. github.com/settings/copilot 페이지에서 상태를 봐야 합니다.

그 외 자주 걸리는 지점:

  • 파일 확장자가 지원 목록에 없음 (예: 커스텀 확장자 .myext)
  • .gitignore에 걸린 파일 (Copilot이 의도적으로 제안 안 함, 공식 문서 기준)
  • 워크스페이스 설정에서 특정 언어만 비활성화됨

마지막 항목은 특히 헷갈립니다. 설정 검색창에 copilot.enable을 넣으면 언어별 on/off 표가 뜨는데, JavaScript는 켜져 있고 Markdown은 꺼져 있는 식으로 언어별로 갈립니다.

Cursor의 Tab이 안 될 때

Cursor의 Tab 자동완성은 Cursor 에디터 안에서만 동작합니다. 일반 VS Code에 Cursor 확장을 설치해서 쓰는 방식이 아닙니다.

이 부분에서 헷갈리는 분이 많습니다. Cursor는 VS Code를 기반으로 만든 별도 프로그램입니다. 아이콘도 다르고 설치 파일도 다릅니다. VS Code를 열어놓고 "Cursor Tab이 왜 안 되지"라고 하면 당연히 안 됩니다.

VS Code (파란 아이콘)     ← Copilot 확장 설치 가능
   ≠
Cursor (검은 아이콘)      ← Cursor Tab 내장, 앱 자체가 별개

Cursor 앱을 열었는데도 Tab이 안 먹히는 경우는 다음을 확인합니다.

원인 확인 방법
무료 크레딧 소진 우측 상단 프로필 → Usage에서 남은 요청 수 확인
Cursor Tab 기능 꺼짐 Settings → Features → Cursor Tab 토글
로그인 세션 끊김 왼쪽 하단 계정 아이콘 확인
네트워크·프록시 문제 사내 방화벽·VPN 환경에서 자주 발생

글 작성 시점 기준으로 Cursor는 무료 요금제에도 일정량의 Tab 자동완성이 포함돼 있습니다. 다만 한도가 있어서, 하루 종일 코딩하다 보면 갑자기 회색 힌트가 안 뜨는 순간이 옵니다. 이때는 앱이 고장 난 게 아니라 한도 초과입니다.

저도 처음엔 "왜 갑자기 안 되지" 하고 재시작을 두 번쯤 했는데, Usage 페이지 들어가보니 그날치 무료 요청을 다 쓴 상태였습니다. 이런 정보는 Settings 안쪽에 숨어 있어서 놓치기 쉽습니다.

Claude Code는 Tab 자동완성이 없습니다

Claude Code에서 Tab 자동완성을 찾고 있다면, 아마 도구를 잘못 고른 것입니다. Claude Code는 코드를 치는 동안 다음 줄을 예측해 회색으로 보여주는 도구가 아닙니다.

Claude Code는 터미널에서 이런 식으로 동작합니다.

$ claude
> 이 프로젝트에 로그인 기능 추가해줘
(Claude가 여러 파일을 분석하고 편집)

대화형 지시로 파일을 통째로 편집하는 도구입니다. Copilot처럼 커서 옆에 회색 텍스트가 붙는 방식이 아닙니다.

만약 원하는 게 "타이핑하면서 다음 줄이 회색으로 미리 뜨는 기능"이라면, 선택지는 다음 셋 중 하나입니다.

  • GitHub Copilot (VS Code + 확장 설치, 월 구독)
  • Cursor (별도 에디터, 무료 티어 있음)
  • Codeium / Supermaven 등 대안 확장 (무료 옵션 있음)

Claude를 굳이 편집기 안에서 쓰고 싶다면, VS Code 확장 중 "Claude for VS Code" 같은 대화 패널 형태가 있긴 합니다. 하지만 이것도 채팅 패널이지 Tab 인라인 자동완성은 아닙니다.

솔직히 이 부분에서 저도 처음엔 헷갈렸습니다. 이름이 비슷비슷하고 다들 "AI 코딩"이라고 광고하니까요. 그런데 UX가 완전히 다른 세 축이 있다고 정리하면 편합니다.

[인라인 예측형]      [채팅 지시형]        [에이전트형]
  Copilot            Claude Sidebar      Claude Code
  Cursor Tab         Copilot Chat        Cursor Agent
   ↓                   ↓                    ↓
회색 힌트 + Tab     사이드 대화창       터미널 대화 + 자동편집

Tab 키가 등장하는 건 왼쪽 열뿐입니다.

도구별 진단 체크리스트

원인을 도구별로 좁혔다면, 아래 순서로 하나씩 짚어보시는 게 가장 빠릅니다.

Copilot 사용 중이라면:

  • [ ] 상태바 Copilot 아이콘에 사선 없는지
  • [ ] github.com/settings/copilot에서 활성 상태인지
  • [ ] Ctrl+Shift+PGitHub Copilot: Sign Out 후 재로그인
  • [ ] 설정에서 해당 언어가 켜져 있는지 (copilot.enable)
  • [ ] 파일이 .gitignore에 포함돼 있진 않은지

Cursor 사용 중이라면:

  • [ ] 지금 열려 있는 앱이 VS Code인지 Cursor인지 확인 (아이콘 색 다름)
  • [ ] Settings → Features → Cursor Tab 토글 ON
  • [ ] Usage 페이지에서 남은 크레딧 확인
  • [ ] 사내망이면 프록시·방화벽 예외 처리 확인

Claude Code라면:

  • [ ] 애초에 인라인 Tab 자동완성 도구가 아님을 인지
  • [ ] 원하는 게 인라인 힌트라면 Copilot 또는 Cursor로 전환
  • [ ] Claude를 유지하고 싶다면 채팅 패널 확장으로 대체

한 가지 덧붙이면, 세 도구를 동시에 켜두는 건 피하는 게 좋습니다. 실제로 Copilot과 다른 자동완성 확장을 같이 켜면 힌트가 서로 덮어써서 Tab을 눌러도 엉뚱한 게 확정되는 경우가 있습니다. 저는 도구를 바꿀 때마다 이전 확장은 Disable(비활성화)로 두는 편입니다.

자주 놓치는 함정 몇 가지

지금까지의 진단으로도 해결이 안 될 때 마지막으로 확인하면 좋은 지점들입니다.

Vim / Emacs 키 바인딩 확장을 쓰면 Tab 키가 다른 명령으로 재매핑돼 있을 수 있습니다. Vim 확장에서는 삽입 모드가 아닐 때 Tab이 자동완성이 아니라 다른 동작을 합니다.

한글 입력기(IME) 상태도 종종 원인입니다. 한글 조합 중에는 Tab이 조합 확정으로 먹히면서 자동완성 힌트가 취소되는 케이스가 있습니다. 저는 이걸로 30분 넘게 헤맨 적이 있는데, 영문 상태로 바꾸니 바로 정상이었습니다.

VS Code Insiders 버전과 안정 버전 혼용도 함정입니다. 확장은 Insiders에 설치돼 있는데 안정 버전을 열면 당연히 안 됩니다. 아이콘이 초록색이면 Insiders, 파란색이면 안정 버전입니다.

마지막으로 재시작의 힘을 얕보지 마세요. 확장 업데이트 직후에는 VS Code를 완전히 종료(트레이·독에서까지)했다가 다시 여는 것만으로 해결되는 경우가 꽤 있습니다. 개발자다운 진단은 아니지만, 실제로 통계상 재시작으로 풀리는 비율이 무시 못 할 수준입니다.

마무리

Tab 자동완성이 안 될 때 가장 먼저 할 일은 "지금 내가 쓰는 도구가 어느 계열인가"를 확인하는 것입니다. Copilot이면 로그인·구독, Cursor면 앱 자체와 크레딧, Claude Code면 애초에 다른 도구라는 것부터 짚어야 합니다.

1편에서 다룬 키 바인딩·확장 충돌을 확인했는데도 해결이 안 됐다면, 이번 편의 도구별 체크리스트를 따라 위에서부터 하나씩 짚어보시면 대부분 풀립니다. 그래도 안 되면 확장을 잠깐 다 끄고 새 폴더에서 테스트해보는 게 빠릅니다 — 워크스페이스 설정이 개별 프로젝트에 남아 있는 경우가 의외로 많거든요.

다음 편에서는 인라인 자동완성이 뜨긴 뜨는데 품질이 이상할 때 — 엉뚱한 코드가 자꾸 제안되는 경우 — 를 다뤄볼 예정입니다.

함께 보면 좋은 글

반응형