GitHub Copilot App 안 될 때 로그인·권한 점검

GitHub Copilot App이 안 될 때는 처음부터 다시 설치하지 말고, 먼저 고장 난 층위를 나눠 확인해야 합니다. 이번 주에는 앱 실행, 로그인, 저장소 권한, 조직 정책, Agent Sessions, 모델과 사용량 순서로 한 단계씩 재현해 보시기 바랍니다. 개인 계정 문제인지 회사 정책 문제인지도 이 순서로 빠르게 구분할 수 있습니다.

이 글은 설치 뒤 첫 에이전트 세션을 만들지 못한 개인 개발자를 위한 글입니다. 비공개 저장소가 보이지 않거나 브랜치 업로드가 막힌 팀원, 앱 접근 정책을 확인해야 하는 GitHub 관리자에게도 해당합니다.

먼저 고장 난 층위를 점수로 나눕니다

증상만 보고 앱 전체를 다시 설치하면 같은 문제가 반복될 수 있습니다. 아래 표에서 가장 가까운 증상을 고르고 해당 층위부터 확인하십시오.

5점 항목은 다음 단계로 넘어가기 전에 반드시 확인하는 편이 좋습니다. 예를 들어 앱은 정상적으로 열리는데 저장소만 비어 있다면 설치 문제가 아닙니다. 로그인 계정이나 저장소 접근 범위를 먼저 봐야 합니다.

GitHub 공식 안내에 따르면 GitHub Copilot App은 macOS, Linux, Windows에서 사용할 수 있으며 모든 Copilot 요금제를 지원합니다. 다만 기업이나 조직 계정은 관리자의 앱 정책 영향을 받을 수 있습니다. 공식 앱 개요와 지원 운영 체제

앱 실행 문제는 설치보다 차단 지점을 먼저 봅니다

앱이 설치되지 않거나 실행 직후 닫힌다면 다음 순서로 확인하십시오.

1. GitHub의 공식 다운로드 경로에서 받은 설치 파일인지 확인합니다.
2. 운영 체제 업데이트가 끝났는지 확인합니다.
3. 앱 업데이트가 중간에 끊기지 않았는지 확인합니다.
4. 운영 체제의 보안 기능이 앱 실행을 차단했는지 확인합니다.
5. 화면에 표시된 문구와 발생 시각을 따로 기록합니다.

여기서 중요한 점은 성능 부족으로 단정하지 않는 것입니다. 앱이 실행되지 않는 원인은 파일 손상, 보안 차단, 권한 부족, 설치 경로 문제일 수 있습니다. 메모리나 프로세서 문제로 판단하려면 같은 장치에서 다른 데스크톱 앱도 비슷하게 종료되는지 비교해야 합니다.

공식 시작 안내는 앱 설치 뒤 GitHub 계정으로 로그인하고, 로컬 폴더나 저장소를 연결한 다음 첫 에이전트 세션을 만들도록 안내합니다. 공식 설치와 첫 세션 안내

앱이 열리지만 빈 화면만 보인다면 재설치 전 캐시와 보안 프로그램의 차단 기록을 확인하십시오. 회사 장치라면 관리자 권한 없이 설치된 앱을 막는 정책도 있을 수 있습니다.

로그인과 네트워크를 분리해서 확인합니다

GitHub Copilot App 로그인 실패는 세 가지로 나누면 빠릅니다.

브라우저 인증 확인

먼저 기본 브라우저에서 현재 계정으로 GitHub에 로그인합니다. 목표 저장소의 웹 주소도 직접 열어 보십시오. 웹에서도 계정 전환이 반복되거나 조직 승인 화면이 나타난다면 앱 문제가 아니라 계정 상태 문제일 가능성이 큽니다.

그다음 앱에서 로그인할 때 브라우저에 열린 계정과 앱에서 사용하려는 계정이 같은지 확인하십시오. 개인 계정과 회사 계정을 동시에 사용하는 환경에서는 다른 계정으로 승인되는 경우가 있습니다.

네트워크와 프록시 확인

회사 네트워크에서는 GitHub 로그인 주소와 관련 자원이 차단될 수 있습니다. 공식 허용 목록 문서는 로그인에 GitHub 일반 웹 자원 접근도 필요하다고 설명합니다. 특정 앱 주소만 허용해도 전체 GitHub 로그인이 막혀 있으면 인증이 완료되지 않을 수 있습니다. 공식 네트워크 허용 목록 안내

가능하면 같은 장치에서 회사 네트워크와 개인 휴대폰 연결을 비교하십시오.

• 개인 연결에서는 로그인 성공, 회사 네트워크에서 실패: 프록시나 방화벽 확인
• 두 네트워크에서 모두 실패: 계정, 앱 버전, 브라우저 인증 확인
• 로그인은 성공하지만 저장소만 없음: 저장소 권한과 조직 정책 확인

주의: 인증 토큰이나 개인 키를 로그에 그대로 붙여 넣지 마십시오. 지원 요청용 기록에는 계정 이름, 저장소 주소, 토큰, 쿠키를 제거해야 합니다.

저장소 연결은 GitHub 권한과 Git 인증을 따로 봅니다

Copilot App에서 비공개 저장소가 보이지 않는다면 웹에서 해당 저장소를 열 수 있는지부터 확인하십시오. 웹 접근이 되지 않으면 앱에서도 목록에 나타나지 않습니다. 웹 접근은 되지만 앱 목록만 비어 있다면 조직 승인, 계정 불일치, 앱의 저장소 접근 범위를 확인해야 합니다.

저장소 연결 뒤 복제나 업로드가 실패하는 경우에는 다음 항목을 점검합니다.

• 원격 주소가 실제 저장소 주소인지 확인합니다.
• origin이 다른 계정을 가리키지 않는지 확인합니다.
• 개인 액세스 토큰이나 SSH 키가 만료되지 않았는지 확인합니다.
• 보호된 기본 브랜치에 직접 업로드하려는 것은 아닌지 확인합니다.
• 조직의 승인 절차나 외부 협력자 제한을 확인합니다.

GitHub 저장소가 아닌 곳을 Git URL로 연결하는 경우도 주의해야 합니다. 공식 문서는 외부 Git 호스트나 앱 접근이 없는 비공개 저장소를 저장소 주소로 연결할 수 있다고 설명하지만, 복제와 업로드에 필요한 Git 인증은 별도로 준비해야 합니다. 공식 저장소 연결 안내

즉, GitHub 로그인 성공이 곧 Git push 성공을 뜻하지 않습니다. 앱의 계정 인증과 터미널의 SSH 또는 HTTPS 인증은 서로 다른 확인 대상입니다.

조직 정책은 2026년 7월 27일 변경 사항부터 확인합니다

기업 계정에서 앱 자체가 막힌다면 예전 명령줄 도구 정책만 보지 마십시오. GitHub는 2026년 7월 27일 GitHub Copilot App을 위한 독립 정책을 추가했습니다. 이제 앱과 명령줄 도구의 접근 정책을 따로 관리할 수 있습니다. 독립 앱 정책 변경 안내

관리자는 기업 또는 조직 설정에서 다음을 확인해야 합니다.

1. 인공지능 제어 영역을 엽니다.
2. Copilot 클라이언트 설정으로 이동합니다.
3. GitHub Copilot App 정책을 확인합니다.
4. 전체 허용, 전체 차단, 조직별 결정 중 현재 값을 확인합니다.
5. 관리형 설정 파일에서 플러그인과 승인 우회 제한을 확인합니다.

앱 정책이 전체 차단이면 개인 장치에서 재설치해도 해결되지 않습니다. 반대로 정책은 허용인데 특정 사용자만 실패한다면 조직 배정, 계정 소속, 관리형 설정의 예외를 확인해야 합니다.

GitHub는 같은 시점부터 기업 관리형 설정을 앱과 클라우드 에이전트에도 적용할 수 있다고 안내합니다. 플러그인 허용 범위나 승인 요청 우회 여부가 세션 실행을 막는지 함께 확인하십시오. 기업 관리형 설정 변경 안내

Agent Sessions는 최소 작업으로 재현합니다

Agent Sessions가 명령을 실행하지 않으면 큰 기능 개발을 계속 시도하지 마십시오. 먼저 아래처럼 작은 작업으로 범위를 줄이십시오.

1. 새 브랜치 또는 격리된 작업 공간을 선택합니다.
2. 프로젝트의 파일 하나를 읽도록 요청합니다.
3. 의존성 목록만 확인하도록 요청합니다.
4. 위험하지 않은 테스트 하나만 실행합니다.
5. 변경된 파일과 실행 결과를 확인합니다.

이 과정에서 확인할 항목은 다음과 같습니다.

• 세션이 올바른 프로젝트 폴더에서 실행되는지
• 패키지 설치가 끝났는지
• 필요한 실행 파일이 경로에 등록됐는지
• 작업 폴더에 파일을 쓸 권한이 있는지
• 방화벽이 패키지 저장소나 외부 API를 막는지
• 샌드박스가 셸 명령이나 네트워크 접근을 제한하는지
• 고위험 명령이 사용자 승인을 기다리고 있는지

공식 문서는 앱의 세션 모드가 대화형, 계획형, 자동 실행형으로 나뉘며, 각 세션이 별도 작업 공간과 브랜치를 사용할 수 있다고 설명합니다. 따라서 세션이 멈춘 것처럼 보여도 실제로는 승인 입력을 기다리는 상태일 수 있습니다. 공식 앱 작업 흐름 안내

명령 실행 실패와 코드 생성 실패도 구분하십시오. 코드 생성은 되지만 테스트만 실패한다면 앱보다 프로젝트 의존성이나 환경 변수가 원인일 수 있습니다.

모델과 사용량 제한은 마지막에 확인합니다

모델 선택 뒤 오류가 발생한다면 다음 세 가지를 분리하십시오.

• 선택한 모델이 현재 계정에서 사용 가능한지
• BYOK 키와 제공자 주소가 올바른지
• GitHub AI Credits 또는 제공자 자체 사용량 제한에 걸렸는지

BYOK를 사용하면 모델 제공자의 요금 제한과 속도 제한이 적용될 수 있습니다. 사용량 추적도 GitHub가 아니라 해당 제공자 쪽에서 이뤄질 수 있습니다. BYOK 제한 사항 공식 안내

GitHub의 사용 제한 안내는 포함된 인공지능 크레딧을 모두 사용했을 때 추가 사용 예산이나 요금제 변경이 필요할 수 있다고 설명합니다. 일시적인 요청 제한이라면 잠시 기다린 뒤 다시 시도해야 합니다. 공식 사용 제한 안내

지원 요청을 제출할 때는 다음 정보만 정리하십시오.

• 앱 버전
• 운영 체제와 업데이트 상태
• 문제가 발생한 날짜와 시각
• 개인 계정인지 조직 계정인지
• 연결하려던 저장소의 공개 여부
• 선택한 모델과 BYOK 사용 여부
• 오류 문구 전문
• 재현에 성공한 최소 작업
• 토큰과 주소를 제거한 로그

오류 코드를 직접 만들어 쓰지 마십시오. 화면에 실제로 표시된 문구만 기록해야 지원팀이 경로를 추적할 수 있습니다.

자주 묻는 문제를 짧게 확인합니다

로그인 실패와 저장소 접근 실패는 같은 문제인가요?

같지 않습니다. 로그인은 브라우저 인증과 계정 상태의 문제입니다. 저장소 접근은 조직 승인, 비공개 저장소 권한, 앱 접근 범위의 문제입니다. 웹에서 저장소를 열 수 있는지 먼저 확인한 뒤 앱 목록을 비교하면 두 문제를 빠르게 분리할 수 있습니다.

조직 계정인데 앱만 차단될 수 있나요?

가능합니다. 2026년 7월 27일부터 GitHub Copilot App에는 명령줄 도구와 별도의 접근 정책이 적용됩니다. 따라서 명령줄 도구를 허용한 조직에서도 앱 정책이 차단되어 있을 수 있습니다. 관리자는 앱 클라이언트 정책과 관리형 설정을 함께 확인해야 합니다.

로컬 폴더를 연결하면 GitHub 저장소 권한을 우회하나요?

아닙니다. 로컬 폴더를 여는 것과 원격 저장소를 읽거나 업로드하는 것은 다릅니다. 로컬 파일 편집은 가능해도 원격 저장소 동기화에는 Git 인증과 브랜치 규칙이 적용됩니다. 외부 Git 주소를 연결할 때도 독립적인 인증 정보가 필요할 수 있습니다.

그래도 실패하면 원인을 고정해 기록합니다

최종적으로는 다음 네 줄을 작성할 수 있어야 합니다.

• 어디서 실패했는가: 앱, 로그인, 저장소, 조직 정책, 세션, 모델
• 무엇은 정상인가: 브라우저 로그인, 저장소 웹 접근, 로컬 테스트 등
• 가장 작은 재현 방법은 무엇인가
• 어떤 환경에서만 실패하는가: 회사 네트워크, 특정 계정, 특정 작업 공간 등

이 기록이 있으면 무차별 재설치보다 해결 속도가 빠릅니다. 특히 조직 정책 문제는 개인 장치에서 해결할 수 없고, 로컬 의존성 문제는 관리자 설정만 바꿔도 해결되지 않습니다.

현재 장치에서만 실행 환경, 권한, 네트워크 연결이 반복해서 걸린다면 원격 개발 환경을 비교해 볼 수 있습니다. 로컬 장치의 절전, 회사 방화벽, 제한된 권한을 계속 우회하는 것보다 원격 맥에서 동일한 프로젝트를 재현하는 편이 적합한 경우가 있습니다. VPSSpark의 원격 맥 환경 안내를 먼저 확인하고, 필요한 경우 한국 지역 맥 대여 옵션에서 작업 방식과 연결 조건을 비교하십시오.

다만 장기간 무거운 작업을 계속 실행하거나 물리 장치와 직접 연결해야 한다면 자가 장비가 더 적합할 수 있습니다. 반대로 단기 테스트, 외부 접속이 필요한 개발, 로컬 환경 장애를 분리하려는 목적이라면 원격 맥 대여가 재설치 반복보다 현실적인 선택이 될 수 있습니다.