IntelliJ 코파일럿 업데이트가 막힐 때 필요한 IDE 버전

IntelliJ를 최신판으로 올렸는데 Copilot 플러그인 설치가 호환 오류로 막혔다. 오류 창에 적힌 빌드 번호는 무엇을 뜻하고, 내 IDE는 어느 버전이어야 할까?

IntelliJ 코파일럿 업데이트가 막힐 때 필요한 IDE 버전
세 줄 요약
  • Copilot 최신 플러그인의 최소 지원 IDE는 JetBrains 2025.2다.
  • 새 IDE에서도 잘못된 버전의 플러그인 파일을 설치하면 호환 오류가 난다.
  • IDE의 About 화면과 플러그인의 호환 범위를 대조한 뒤 업데이트해야 한다.

2025.1을 쓰고 있다면 IDE부터 올려야 한다

IntelliJ나 PyCharm에서 Copilot을 업데이트하지 못한다면 현재 IDE가 2025.1 계열인지 먼저 확인할 필요가 있다. GitHub는 10월 10일 변경 기록에서 JetBrains IDE 2025.1 지원이 끝났으며 플러그인 사용에 2025.2 이상이 필요하다고 밝혔다.

최소 지원판과 권장판은 다르다. Microsoft의 사전 안내는 최소 버전을 2025.2.x로, 권장 업그레이드 대상을 2026.1 이상으로 제시했다. 2025.1.7처럼 패치 번호만 높은 2025.1 계열도 지원 종료 대상이다.

IDE 버전과 플러그인 버전을 따로 읽는다

업데이트 판단에는 두 숫자가 필요하다. 하나는 실행 중인 IDE의 버전·빌드 번호이고, 다른 하나는 설치하려는 Copilot 플러그인이 허용하는 IDE 범위다.

  1. Windows·Linux에서는 Help → About, macOS에서는 IDE 이름 → About에서 IDE 버전을 확인한다.
  2. Settings → Plugins에서 GitHub Copilot의 설치 상태와 버전을 확인한다.
  3. 공식 Marketplace의 Versions에서 해당 플러그인의 호환 범위를 대조한다.
  4. IDE가 지원 기준보다 오래됐다면 IDE를 올린 뒤 플러그인을 갱신하고, 재시작 요청이 나오면 적용한다.

GitHub 설치 문서도 버전 호환성을 Marketplace에서 확인하도록 연결한다. 예전에 내려받은 설치 파일의 이름만 보고 현재 IDE에도 맞을 것으로 판단해서는 안 된다.

IDE가 최신이어도 설치 파일은 맞지 않을 수 있다

호환 오류는 IDE가 오래됐을 때만 생기지 않는다. 공식 피드백 저장소의 1432번 이슈에서는 새 IntelliJ에 이전 빌드용 플러그인을 설치하려다 실패한 사례가 나왔다. 오류는 플러그인이 허용하는 빌드 상한보다 현재 IDE 빌드가 높다는 내용이었다.

담당자는 당시 더 새로운 IDE용 패키지를 안내했고, 10월 20일에는 올바른 빌드 설치 후 동작한 것으로 확인했다. 따라서 오류 문구에 나온 요구 빌드가 최솟값인지 최댓값인지 읽는 것이 중요하다. 옛 이슈에 등장하는 플러그인 번호를 지금 설치할 정답으로 받아들여서는 안 된다.

현재 상황다음 확인
IDE가 2025.1.x다지원되는 IDE로 업그레이드할 수 있는지 확인한다.
IDE는 새 버전인데 설치가 거부된다플러그인 파일의 호환 빌드 상한·하한을 확인한다.
설치는 됐지만 로그인·제안이 실패한다호환 오류와 구분해 로그인 상태와 실제 오류를 확인한다.

지원 종료가 기존 플러그인의 즉시 중단은 아니다

Microsoft는 지원 종료가 기존 설치를 즉시 비활성화하지 않으며, 기존 플러그인은 계속 동작할 것으로 예상한다고 안내했다. 다만 그 IDE 버전에는 이후 버그 수정·성능 개선·새 기능이 제공되지 않는다.

회사 표준 환경 때문에 IDE 업데이트를 미뤄야 한다면 현재 동작 여부와 앞으로 업데이트할 수 있는지를 나누어 판단해야 한다. 지원되는 IDE인데도 실패한다면 재설치를 반복하기보다 IDE 빌드, Copilot 버전, 정확한 오류 문구를 함께 남겨야 호환성 문제를 구체적으로 설명할 수 있다.