> ## 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

> 说明如何在 GitHub Actions 中安装 Copilot CLI 并配置 token 认证以使用 Laravel Copilot SDK。

## 在 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` 进行认证。只要是 Copilot CLI 支持的认证方式，`GH_TOKEN` 或 `GITHUB_TOKEN` 等都可以。
* 由于 token 需要 `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 token](/zh/packages/laravel-copilot-sdk/github-token.md)
- [GitHub Copilot SDK for Laravel](/zh/packages/laravel-copilot-sdk/index.md)
- [认证 - GitHub Copilot SDK for Laravel](/zh/packages/laravel-copilot-sdk/auth.md)
- [测试 - GitHub Copilot SDK for Laravel](/zh/packages/laravel-copilot-sdk/fake.md)
- [Laravel Cloud - GitHub Copilot SDK for Laravel](/zh/packages/laravel-copilot-sdk/laravel-cloud.md)