메인 콘텐츠로 건너뛰기

​
인증

Copilot SDK는 여러 인증 방법을 지원합니다. 용도에 맞게 선택하세요.

​
인증 방법

방법주요 용도Copilot 구독비고
GitHub 로그인(CLI)개발, 수동 실행필요copilot CLI의 로그인 정보를 사용
OAuth GitHub App / PAT사용자별 토큰필요github_token으로 지정
환경 변수CI/CD, 서버 운영필요COPILOT_GITHUB_TOKEN 등
BYOK(Bring Your Own Key)자체 모델 프로바이더불필요커스텀 프로바이더 설정
BYOK는 Custom providers를 참고하세요.

​
GitHub 로그인(CLI)

copilot 또는 gh CLI에 로그인이 되어 있는 경우, 아무것도 지정하지 않으면 저장된 인증 정보가 사용됩니다. 
use Revolution\Copilot\Facades\Copilot;

$response = Copilot::run(prompt: 'Hello');

​
OAuth GitHub App / PAT

OAuth 플로우로 취득한 사용자 액세스 토큰 또는 Fine-grained PAT를 github_token에 전달합니다.
  • gho_ / ghu_ / github_pat_을 상정
  • ghp_(Classic PAT)는 권장하지 않음
use Revolution\Copilot\Facades\Copilot;

$config = array_merge(config('copilot'), [
    'github_token' => $user->github_token,
]);

$response = Copilot::useStdio($config)->run(prompt: '...');
Copilot::stop();
github_token을 지정하면 use_logged_in_user는 자동으로 false가 됩니다. 명시적으로 전환하려면 다음과 같이 합니다. 
$config = [
    'github_token' => $user->github_token,
    'use_logged_in_user' => true,
];
자세한 내용은 GitHub token을 참고하세요. github_token과 use_logged_in_user는 stdio 모드 전용입니다. TCP 모드에서는 Copilot CLI 쪽에서 인증되어 있어야 합니다.

​
환경 변수

환경 변수로 토큰을 전달하는 경우 CLI가 자동으로 검출합니다. 우선순위는 위에서부터 순서대로입니다.
  1. COPILOT_GITHUB_TOKEN
  2. GH_TOKEN
  3. GITHUB_TOKEN
COPILOT_GITHUB_TOKEN=github_pat_xxx

use Revolution\Copilot\Facades\Copilot;

$response = Copilot::run(prompt: 'Hello');
TCP 모드에서는 CLI 서버 쪽의 환경 변수를 설정하세요.

​
인증 우선순위

SDK는 다음 순서로 인증 정보를 해결합니다.
  1. github_token(명시적 지정)
  2. 환경 변수 토큰(COPILOT_GITHUB_TOKEN → GH_TOKEN → GITHUB_TOKEN)
  3. CLI에 저장된 OAuth 인증 정보
  4. gh CLI의 인증 정보

​
자동 로그인 비활성화

저장된 인증 정보를 사용하지 않으려면 use_logged_in_user를 false로 설정합니다. 
use Revolution\Copilot\Facades\Copilot;

$response = Copilot::useStdio([
    'use_logged_in_user' => false,
])->run(prompt: 'Hello');
github_token과 마찬가지로 stdio 모드에서만 지원됩니다. TCP 모드에서는 Copilot CLI 쪽에서 인증되어 있어야 합니다.

​
인증 상태 확인

auth.getStatus의 결과를 취득해 확인할 수 있습니다. 
use Revolution\Copilot\Facades\Copilot;

$status = Copilot::client()->getAuthStatus();

if (! $status->isAuthenticated) {
    // 미인증
}
최신 정보는 GitHub 저장소를 참고하세요.
마지막 수정일 2026년 7월 13일

관련 항목

GitHub Actions - GitHub Copilot SDK for LaravelGitHub Copilot SDK for LaravelGitHub 토큰시작하기 - GitHub Copilot SDK for LaravelLaravel Cloud - GitHub Copilot SDK for Laravel