> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Actions - GitHub Copilot SDK for Laravel

> Laravel Copilot SDK를 GitHub Actions에서 사용하기 위한 Copilot CLI 설치와 토큰 인증 설정을 설명합니다.

## GitHub Actions에서 사용법

GitHub Actions에서 Artisan 명령어를 실행하고 그 안에서 Copilot CLI를 사용하는 예시입니다.

GitHub Actions에서는 stdio 모드로 사용하는 것이 일반적입니다.

## `copilot` 명령어를 직접 설치하는 경우

```yaml theme={null}
      - name: Install Copilot CLI
        run: |
          curl -fsSL https://gh.io/copilot-install | bash
          copilot version

      - name: Run command
        run: php artisan copilot:ping
        env:
          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
```

* `copilot-install`을 사용해 설치합니다. path는 `copilot`인 채로 추가 설정 없이 사용할 수 있습니다.
* `COPILOT_GITHUB_TOKEN`으로 인증합니다. `GH_TOKEN`이나 `GITHUB_TOKEN` 등 Copilot CLI가 지원하는 인증 방법이라면 무엇이든 좋습니다.
* 토큰은 `Copilot Requests` 권한이 필요하므로 기본 `GITHUB_TOKEN`으로는 아마 사용할 수 없습니다.

## `gh` 명령어를 사용하는 경우

GitHub CLI 2.86.0에서 Copilot 설치 기능이 추가되었습니다. 일반적인 GitHub Actions 환경에서는 `gh` 명령어가 사전 설치되어 있으므로 추가 설치 없이 사용할 수 있습니다. 아마도 처음 `gh copilot ...` 명령어가 실행될 때 Copilot이 자동으로 설치되므로 `gh copilot version`만 실행합니다.

> gh version 2.86.0 (2026-01-21)
> [https://github.com/cli/cli/releases/tag/v2.86.0](https://github.com/cli/cli/releases/tag/v2.86.0)
> ✓ Copilot CLI installed successfully

```yaml theme={null}
      - name: Install Copilot CLI
        run: |
          gh --version
          gh copilot version

      - name: Run command
        run: php artisan copilot:ping
        env:
          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
          COPILOT_CLI_PATH: "gh copilot"
```

`COPILOT_CLI_PATH`는 `gh copilot`일 때만 특별한 처리를 하고 있으므로 `gh copilot` 이외의 설정에서는 동작하지 않습니다.

<Info>
  최신 정보는 [GitHub 저장소](https://github.com/invokable/laravel-copilot-sdk)를 참고하세요.
</Info>


## Related topics

- [GitHub 토큰](/ko/packages/laravel-copilot-sdk/github-token.md)
- [GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/index.md)
- [인증 - GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/auth.md)
- [Laravel Cloud - GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/laravel-cloud.md)
- [테스트 - GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/fake.md)