본문으로 건너뛰기

GitHub Copilot 연결 문제 해결

팁

GitHub Copilot 연결 문제를 해결하고 AI 지원 코딩을 다시 시작하세요.

일반적인 오류 메시지​

1. 연결 실패​

오류: 'GitHub Copilot' 확장 프로그램이 서버에 연결할 수 없습니다.
확장 프로그램 활성화 실패: Copilot 토큰을 가져올 수 없습니다

2. 인증 실패​

GitHub Copilot이 서버에 연결할 수 없습니다.
GitHub 계정에 로그인하세요.

빠른 해결 방법​

1. 다시 로그인​

  1. 명령 팔레트 열기 (Ctrl/Cmd + Shift + P)
  2. "Copilot: Sign In" 입력
  3. 인증 절차 따르기

2. 자격 증명 재설정​

# Windows
del "%APPDATA%\Code\User\settings.json"

# macOS/Linux
rm ~/.config/Code/User/settings.json

단계별 문제 해결​

1. GitHub 인증 확인​

# GitHub 인증 페이지 열기
github.com/login/device

# 장치 코드 입력
Cursor에 표시된 코드 입력

2. 네트워크 연결​

# GitHub 연결 테스트
ping github.com

# Copilot API 확인
curl https://copilot.githubusercontent.com

3. 확장 프로그램 상태​

  1. 확장 프로그램 상태 확인:

    • 확장 프로그램 패널 열기
    • "GitHub Copilot" 검색
    • 버전 및 상태 확인

  2. 확장 프로그램 재설정:

    # Windows
    rd /s /q "%USERPROFILE%\.vscode\extensions\github.copilot-*"

    # macOS/Linux
    rm -rf ~/.vscode/extensions/github.copilot-*

고급 문제 해결​

1. 캐시 지우기​

# Windows
rd /s /q "%APPDATA%\Code\Cache"
rd /s /q "%APPDATA%\Code\CachedData"

# macOS
rm -rf ~/Library/Application\ Support/Code/Cache
rm -rf ~/Library/Application\ Support/Code/CachedData

# Linux
rm -rf ~/.config/Code/Cache
rm -rf ~/.config/Code/CachedData

2. 프록시 설정 확인​

settings.json
{
  "http.proxy": "http://proxy.example.com:8080",
  "http.proxyStrictSSL": true
}

3. 디버그 모드​

# 디버그 로그 활성화
1. 명령 팔레트 열기
2. "Developer: Set Log Level"
3. "Trace" 선택

일반적인 문제와 해결책​

1. 토큰 만료​

# 토큰 강제 새로 고침
1. Copilot에서 로그아웃
2. 자격 증명 지우기
3. 다시 로그인

2. 네트워크 제한​

# 필요한 도메인
copilot.githubusercontent.com
api.github.com
github.com

3. 확장 프로그램 충돌​

settings.json
{
  "extensions.autoUpdate": false,
  "extensions.ignoreRecommendations": true
}

모범 사례​

1. 정기적인 유지 관리​

# 주간 점검
1. 인증 확인
2. 확장 프로그램 업데이트
3. 필요한 경우 캐시 지우기

2. 설정 관리​

settings.json
{
  "github.copilot.enable": {
    "*": true,
    "plaintext": false,
    "markdown": false
  },
  "github.copilot.advanced": {
    "debug.overrideEngine": "stable",
    "debug.testOverrideProxyUrl": null
  }
}

3. 보안​

# 안전한 토큰 저장
1. 자격 증명 관리자 사용
2. 2단계 인증 활성화
3. 정기적인 토큰 교체

Cursor와의 통합​

1. 확장 프로그램 설정​

{
  "cursor.github.copilot.enable": true,
  "cursor.github.copilot.inlineSuggest.enable": true
}

2. 키보드 단축키​

동작Windows/LinuxmacOS
제안 수락TabTab
다음 제안Alt + ]Option + ]
이전 제안Alt + [Option + [
인라인 표시Alt + \Option + \

문제 해결 워크플로우​

1. 초기 점검​

graph TD
    A[시작] --> B{연결 확인}
    B -->|실패| C[인증 확인]
    B -->|성공| D[확장 프로그램 확인]
    C --> E[다시 로그인]
    D --> F[확장 프로그램 업데이트]

2. 고급 진단​

# 진단 단계
1. 디버그 로그 활성화
2. 문제 재현
3. 로그 수집
4. 오류 분석

3. 복구 단계​

# 단계별 복구
1. 로그아웃
2. 캐시 지우기
3. 확장 프로그램 제거
4. Cursor 재시작
5. 확장 프로그램 재설치
6. 로그인

예방 팁​

  1. 정기적인 업데이트

    • Cursor 최신 상태 유지
    • 확장 프로그램 업데이트
    • 토큰 만료 확인

  2. 네트워크 설정

    • 프록시 설정 구성
    • 필요한 도메인 허용
    • 연결 테스트

  3. 설정 백업

    # 설정 백업
    cp settings.json settings.backup.json

지원팀에 문의해야 할 때​

1. 지속적인 문제​

  • 모든 단계를 시도해도 연결 실패
  • 인증 루프
  • 확장 프로그램 충돌

2. 필요한 정보​

# 정보 수집
1. Cursor 버전
2. Copilot 버전
3. 오류 메시지
4. 디버그 로그

3. 지원 채널​

  • GitHub Issues
  • Cursor 지원
  • 커뮤니티 포럼
팁

지원팀에 문의하기 전에 기본적인 문제 해결 단계를 반드시 시도하세요!

관련 리소스​