Clash에서 GitHub Copilot이 안 될 때 VS Code 연결 오류 해결
먼저 GitHub Copilot 오류 유형을 구분하기
VS Code에서 GitHub Copilot이 작동하지 않을 때 곧바로 구독 만료나 확장 프로그램 손상으로 판단하지 않는 것이 좋습니다. 로그인 화면이 반복되는 문제, Copilot 채팅은 열리지만 인라인 자동완성만 멈추는 문제, 확장 프로그램이 활성화되었지만 응답이 늦거나 타임아웃되는 문제는 서로 다른 네트워크 경로에서 발생할 수 있습니다. GitHub 계정 인증, 확장 프로그램의 서비스 연결, 모델 응답 스트림은 같은 요청을 사용하지 않을 수 있기 때문입니다.
먼저 VS Code의 왼쪽 계정 메뉴에서 현재 로그인한 GitHub 계정을 확인하고, 상태 표시줄의 Copilot 아이콘을 클릭해 현재 상태를 살펴보세요. “Not authorized”, “Unable to connect”, “Extension activation failed”처럼 메시지의 성격을 기록하면 원인 범위를 줄일 수 있습니다. 계정 메뉴 자체가 열리지 않거나 브라우저 인증 페이지로 이동하지 않는다면 인증 경로를 먼저 점검해야 합니다. 로그인이 완료되었지만 제안만 나오지 않는다면 Copilot 확장 프로그램과 API 연결, 규칙 매칭을 별도로 확인해야 합니다.
테스트할 때는 코드 편집기에서 짧은 주석을 입력하고 잠시 기다리는 방식만 사용하지 말고, VS Code의 보기 → 출력 메뉴에서 출력 패널을 연 뒤 드롭다운에서 GitHub Copilot 또는 관련 확장 프로그램 채널을 선택하세요. 해당 채널에 요청 시작, 연결 실패, 인증 거부, 인증서 오류, 타임아웃 중 어떤 메시지가 표시되는지 확인합니다. 연결 기록이 전혀 생성되지 않으면 확장 프로그램이 실행되지 않았거나 로컬 설정에서 네트워크 요청이 차단된 경우일 수 있습니다.
문제를 재현하기 전에는 여러 프록시 클라이언트와 VPN을 동시에 실행하지 마세요. Clash Verge, Clash Verge Rev, 시스템 VPN, 브라우저 프록시 확장 프로그램이 동시에 활성화되면 브라우저 인증은 한 경로를 사용하고 VS Code는 다른 경로를 사용할 수 있습니다. 우선 하나의 Clash 인스턴스만 남기고, 테스트가 끝날 때까지 노드와 설정을 자주 바꾸지 않는 편이 로그를 비교하기 쉽습니다.
Clash 연결 기록에서 GitHub 관련 요청 확인
Clash의 연결 또는 네트워크 기록을 열고 VS Code에서 GitHub 로그인을 다시 시도하세요. 계정 인증 과정에서는 github.com 또는 GitHub 인증에 사용되는 관련 주소가 보일 수 있고, Copilot 확장 프로그램이 활성화되면 GitHub API와 Copilot 서비스에 연결하는 요청이 추가로 나타날 수 있습니다. 표시되는 정확한 호스트명은 VS Code 버전, Copilot 확장 프로그램 버전, 인증 방식과 서비스 변경에 따라 달라질 수 있으므로 특정 도메인 목록을 영구적인 규칙처럼 복사하지 않는 것이 안전합니다.
각 연결에서 대상 호스트, 포트, 사용된 규칙, 최종 정책 그룹, 연결 상태를 확인하세요. HTTPS 요청이라면 일반적으로 대상 포트는 443입니다. 요청이 DIRECT로 처리되어 실패한다면 GitHub와 Copilot 관련 트래픽이 의도한 프록시 그룹으로 전달되지 않은 것입니다. 반대로 요청이 프록시 그룹에 들어갔지만 반복적으로 타임아웃되면 노드 품질, 원격 서버 연결, DNS 처리 또는 TLS 협상 문제를 확인해야 합니다.
규칙은 위에서 아래로 매칭되며 첫 번째로 일치한 규칙이 적용됩니다. 상단에 광범위한 DOMAIN-SUFFIX,github.com,DIRECT 같은 규칙이 있으면 뒤에 추가한 프록시 규칙은 실행되지 않습니다. GitHub 관련 규칙을 수정할 때는 계정 인증에 필요한 일반 GitHub 주소와 Copilot 서비스 주소를 구분하고, 너무 넓은 DOMAIN-SUFFIX,githubusercontent.com 규칙이 다른 개발 도구의 다운로드까지 예상치 않게 같은 그룹으로 보내지 않는지 살펴보세요.
rules:
- DOMAIN-SUFFIX,github.com,Copilot
- DOMAIN-SUFFIX,githubusercontent.com,Copilot
- DOMAIN-SUFFIX,githubassets.com,Copilot
- MATCH,DIRECT
위 예시는 규칙 구조를 설명하기 위한 형태일 뿐이며, 모든 계정과 Copilot 요청이 이 세 도메인만 사용하는 것은 아닙니다. 실제로는 Clash 기록에 표시된 실패 호스트를 기준으로 최소한의 규칙을 추가하고, 설정을 수정한 뒤 코어에서 설정을 다시 로드해야 합니다. 구독 설정을 직접 편집했다면 다음 업데이트에서 변경 내용이 사라질 수 있으므로 클라이언트의 오버라이드, 병합 또는 사용자 규칙 기능을 우선 사용하세요.
노드 품질과 DNS 해석을 분리해서 점검
GitHub Copilot은 짧은 웹페이지를 여는 것보다 연결 품질에 민감하게 느껴질 수 있습니다. 인증 페이지는 열리지만 자동완성 요청이 멈추는 경우에는 노드가 장시간 HTTPS 연결이나 스트리밍 응답을 안정적으로 유지하지 못할 가능성이 있습니다. 지연 시간이 낮은 노드라도 패킷 손실, 순간적인 재연결, 특정 목적지에 대한 라우팅 품질이 나쁘면 Copilot 요청은 실패할 수 있습니다.
Clash의 프록시 그룹에서 여러 노드를 무작위로 교체하기보다 두세 개의 후보를 정해 순서대로 테스트하세요. 각 노드에서 github.com과 GitHub API 관련 연결을 다시 시도하고, 연결 기록의 DNS 오류, TLS 오류, 원격 닫힘, 타임아웃 여부를 비교합니다. 특정 노드에서만 실패한다면 VS Code 설정을 반복해서 바꾸기보다 해당 노드를 제외하거나 다른 정책 그룹을 선택하는 것이 빠릅니다.
DNS 모드도 함께 확인해야 합니다. 로컬 DNS가 특정 도메인을 잘못 해석하거나, 해석된 주소로 직접 연결하면서 지역 또는 네트워크 경로 문제가 발생할 수 있습니다. 반대로 모든 DNS 요청을 비정상적인 원격 서버로 보내면 지연이 커지고 연결 시작 자체가 늦어질 수 있습니다. 사용 중인 Mihomo 버전과 클라이언트가 지원하는 DNS 방식에 맞춰 설정하고, 설정을 바꾼 뒤에는 기존 DNS 캐시와 연결 기록의 영향을 줄이기 위해 Clash 코어를 재시작하거나 DNS 캐시를 초기화하세요.
dns:
enable: true
ipv6: false
enhanced-mode: fake-ip
nameserver:
- https://1.1.1.1/dns-query
- https://8.8.8.8/dns-query
이 설정은 일반적인 예시이며 그대로 복사하기 전에 현재 네트워크 환경과 코어 지원 여부를 확인해야 합니다. 이미 TUN과 Fake IP를 사용 중이라면 다른 DNS 설정을 추가해 충돌을 만들지 마세요. 특히 fake-ip-filter에 특정 주소를 넣었다고 해서 해당 주소의 모든 연결이 프록시로 바뀌는 것은 아닙니다. DNS 예외와 라우팅 규칙은 서로 다른 단계에서 동작합니다.
VS Code 프록시 설정과 Clash 포트 맞추기
VS Code는 운영체제 프록시를 자동으로 사용할 수 있지만, 플랫폼과 실행 방식에 따라 환경 변수가 적용되는 방식이 달라질 수 있습니다. Clash가 실행 중이어도 VS Code가 다른 포트나 다른 프록시를 참조하면 연결 기록에 요청이 나타나지 않습니다. 먼저 Clash 클라이언트에서 실제로 열려 있는 HTTP 또는 mixed 포트를 확인하고, VS Code가 그 포트를 사용하도록 설정할지 결정하세요.
VS Code 설정 검색창에서 http.proxy, http.proxySupport, http.proxyStrictSSL을 확인할 수 있습니다. HTTP 프록시 또는 mixed-port를 사용하는 경우에는 다음처럼 주소를 지정할 수 있습니다. 포트 번호는 예시이므로 현재 Clash 화면에 표시된 값으로 바꿔야 합니다.
{
"http.proxy": "http://127.0.0.1:7890",
"http.proxySupport": "override",
"http.proxyStrictSSL": true
}
http.proxySupport를 강제로 변경하기 전에 기본값에서 정상적으로 작동하는지 먼저 확인하세요. 일부 확장 프로그램은 VS Code의 공통 프록시 설정을 따르지만, 모든 확장 프로그램이 동일한 방식으로 동작한다고 보장할 수는 없습니다. 또한 http.proxyStrictSSL을 false로 바꾸면 인증서 검증을 약화시키므로 연결이 안 된다는 이유만으로 계속 유지해서는 안 됩니다. 회사 보안 장비나 자체 인증서를 사용하는 환경이 아니라면 원칙적으로 true를 유지하세요.
설정 변경 후에는 창을 새로 고치거나 VS Code를 완전히 종료한 뒤 다시 실행하세요. 확장 프로그램이 이미 생성한 연결이나 인증 세션을 재사용하면 변경 결과가 즉시 로그에 나타나지 않을 수 있습니다. 재실행한 다음 Clash 연결 기록을 지우고 VS Code에서 Copilot을 다시 활성화하면 새 요청만 관찰할 수 있습니다.
로컬 프록시 포트를 직접 테스트하기
VS Code 자체를 계속 재설정하기 전에 로컬 포트가 실제로 HTTP 프록시 요청을 받는지 확인하세요. 다음 명령은 Clash의 mixed-port 또는 HTTP 포트를 직접 지정합니다. 응답 코드가 반드시 성공해야 한다는 뜻은 아니지만, “로컬 포트 연결 거부”와 “원격 목적지 응답 실패”를 구분하는 데 도움이 됩니다.
curl -I -x http://127.0.0.1:7890 https://github.com
curl -I -x http://127.0.0.1:7890 https://api.github.com
connection refused가 나오면 VS Code보다 먼저 Clash 코어, 포트 번호와 다른 프로세스의 포트 점유를 확인하세요. 오래 기다린 뒤 타임아웃이 발생하면 연결 기록에서 해당 요청이 어느 정책 그룹으로 전달되었는지 확인합니다. 명령줄 테스트는 성공하지만 VS Code만 실패한다면 VS Code 설정, 확장 프로그램별 프록시 처리 또는 계정 인증 세션을 다음 대상으로 좁힐 수 있습니다.
인증 세션과 확장 프로그램 상태 재설정
Clash 경로가 정상이고 VS Code에서도 GitHub 관련 연결이 보이는데 인증이 반복된다면 오래된 로그인 세션이 남아 있을 수 있습니다. VS Code 계정 메뉴에서 GitHub 계정을 로그아웃한 뒤 VS Code를 종료하고 다시 실행하세요. 그다음 계정을 다시 추가하고 브라우저에서 표시되는 권한 승인 과정을 끝까지 완료합니다. 브라우저 인증이 성공해도 VS Code로 돌아오는 단계에서 실패한다면 기본 브라우저, 팝업 차단, 보안 프로그램 또는 로컬 콜백 처리도 확인해야 합니다.
GitHub Copilot과 Copilot Chat 확장 프로그램의 설치 상태와 활성화 상태도 확인하세요. 확장 프로그램을 무작정 삭제하기보다 먼저 업데이트가 진행 중인지, 비활성화되어 있지 않은지, 현재 VS Code 버전과 호환되는지 살펴보는 것이 좋습니다. 확장 프로그램을 다시 설치해야 한다면 기존 설정과 계정 정보를 기록한 뒤 진행하고, 설치 직후에는 노드 변경과 프록시 설정 변경을 동시에 하지 않아야 결과를 해석할 수 있습니다.
로그에 “token expired”, “not authorized” 같은 인증 관련 메시지가 있으면 라우팅만 고쳐도 기존 토큰이 자동으로 복구되지 않을 수 있습니다. 반대로 “certificate”, “socket hang up”, “ETIMEDOUT”처럼 전송 단계의 오류가 보이면 계정 로그아웃을 반복하는 것은 해결책이 아닙니다. 오류 문구와 발생 시점을 기록하고 인증 문제와 네트워크 문제를 분리하세요.
재현 가능한 순서로 최종 점검하기
문제를 해결한 뒤에는 다음 순서로 한 번 더 확인하면 임시로만 고쳐진 상태를 줄일 수 있습니다. 먼저 Clash 코어가 실행 중이고 로컬 프록시 포트가 열려 있는지 확인합니다. 다음으로 VS Code가 해당 포트를 사용하고 있는지 확인한 뒤, GitHub 로그인과 Copilot 확장 프로그램 요청이 Clash 연결 기록에 나타나는지 살펴봅니다. 마지막으로 동일한 노드에서 자동완성, 채팅 또는 다른 Copilot 기능을 각각 테스트합니다.
- 실행 인스턴스를 하나로 줄입니다. 다른 VPN, 프록시 확장 프로그램과 중복 Clash 프로세스를 잠시 끄고 테스트합니다.
- 로컬 포트를 확인합니다. Clash의 실제 mixed-port 또는 HTTP 포트와 VS Code의
http.proxy값을 비교합니다. - 규칙 매칭을 확인합니다. GitHub 관련 요청이
DIRECT인지, 의도한 정책 그룹인지 연결 기록에서 확인합니다. - 노드를 고정합니다. 테스트 중에는 노드를 계속 바꾸지 말고 타임아웃과 TLS 오류가 반복되는지 기록합니다.
- 인증을 마지막에 초기화합니다. 네트워크 경로가 정상으로 확인된 뒤에만 GitHub 계정을 로그아웃하고 다시 로그인합니다.
이 순서로 점검하면 “Copilot 자체의 인증 문제”, “VS Code가 Clash를 사용하지 않는 문제”, “규칙이 잘못된 정책으로 보내는 문제”, “노드 또는 DNS가 불안정한 문제”를 분리할 수 있습니다. 특히 모든 GitHub 도메인을 무조건 한 규칙으로 보내기보다 실제 실패 요청을 관찰하고 필요한 범위만 수정하는 것이 장기적으로 안전합니다. 설정을 수정한 뒤에는 코어를 다시 로드하고, 구독 업데이트가 사용자 규칙을 덮어쓰지 않는지도 확인하세요.