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

# Copilot CLI 번들

> Copilot CLI 버전을 엄격하게 관리하려는 경우, Laravel 프로젝트에 npm 의존성으로 번들하는 방법을 설명합니다.

## 프로젝트에 Copilot CLI 포함하기

Copilot CLI 버전을 엄격하게 관리하려는 경우, npm 패키지로 프로젝트에 포함할 수 있습니다.

일반적으로는 배포 시 별도로 Copilot CLI를 설치하는 방법으로 충분합니다.
[Laravel Cloud에서의 사용법](/ko/packages/laravel-copilot-sdk/laravel-cloud)과 [GitHub Actions에서의 사용법](/ko/packages/laravel-copilot-sdk/github-actions)도 참고하세요.

## 사전 조건

Laravel 프로젝트에 `package.json`이 있고, 프로덕션 서버에도 Node.js 실행 환경이 있어 npm 패키지를 설치할 수 있어야 합니다.

## 설정

### 1. npm 패키지 설치

`dependencies`에 `@github/copilot`을 설치합니다.

```shell theme={null}
npm install @github/copilot
```

설치 후, 다음 경로에서 Copilot CLI를 직접 실행할 수 있습니다.

```shell theme={null}
node node_modules/@github/copilot/npm-loader.js --version
```

Copilot CLI 1.0.64 이후에는 `index.js`가 플랫폼별 패키지에만 포함되어 있으므로 `index.js`를 사용할 경우 환경에 맞게 사용하세요.

```shell theme={null}
node node_modules/@github/copilot-linux-x64/index.js --version
```

### 2. `.env` 설정

`COPILOT_CLI_PATH`에 `npm-loader.js`까지의 전체 경로를 지정합니다.

```dotenv theme={null}
COPILOT_CLI_PATH=/path/to/project/node_modules/@github/copilot/npm-loader.js
```

`base_path()`를 사용해 동적으로 경로를 설정하려면 `config/copilot.php`를 직접 편집합니다.

```php theme={null}
'cli_path' => base_path('node_modules/@github/copilot/npm-loader.js'),
```

## 배포

프로덕션 서버에 배포할 때는 에셋 빌드 후 `devDependencies`를 제외하고 재설치합니다. `@github/copilot`은 `dependencies`에 있기 때문에 남습니다.

```shell theme={null}
npm install
npm run build
npm install --omit=dev
```

`npm install --omit=dev`에 의해 `devDependencies`의 패키지가 삭제되고, `@github/copilot`을 포함한 `dependencies`의 패키지만 `node_modules`에 남습니다.

## 장점과 주의점

| 장점                            | 주의점                    |
| ----------------------------- | ---------------------- |
| CLI 버전을 엄격하게 관리할 수 있음         | `node_modules` 크기가 증가함 |
| `package.json`으로 버전을 고정할 수 있음 | CLI 업데이트는 수동으로 해야 함    |
| 팀 전원이 같은 버전을 사용할 수 있음         | Node.js 실행 환경이 필요함     |

## 인증

인증 방법은 설치 방법과 관계없이 동일합니다. `.env`에서 `COPILOT_GITHUB_TOKEN`을 설정합니다.

```dotenv theme={null}
COPILOT_GITHUB_TOKEN=your-token
```

자세한 내용은 [인증](/ko/packages/laravel-copilot-sdk/auth)을 참고하세요.

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


## Related topics

- [Laravel Boost Custom Agent for GitHub Copilot CLI](/ko/packages/laravel-boost-copilot-cli.md)
- [Laravel LSP — Language Server Protocol에 의한 IDE 기능 확장](/ko/blog/laravel-lsp-introduction.md)
- [Vite에 의한 에셋 번들](/ko/vite.md)
- [Laravel 12에서 13으로의 업그레이드 가이드](/ko/blog/upgrade-12-to-13.md)
- [Laravel 11에서 12로의 업그레이드 가이드](/ko/blog/upgrade-11-to-12.md)