> ## 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 bündeln

> Beschreibt, wie Sie die Copilot CLI bei strenger Versionskontrolle als npm-Abhängigkeit in ein Laravel-Projekt einbetten.

## Copilot CLI in das Projekt aufnehmen

Wenn Sie die Version der Copilot CLI streng verwalten möchten, können Sie sie als npm-Paket in Ihr Projekt aufnehmen.

Im Allgemeinen genügt es, die Copilot CLI beim Deployment separat zu installieren.
Siehe auch [Nutzung mit Laravel Cloud](/de/packages/laravel-copilot-sdk/laravel-cloud) und [Nutzung mit GitHub Actions](/de/packages/laravel-copilot-sdk/github-actions).

## Voraussetzungen

Ihr Laravel-Projekt verfügt über eine `package.json`, und auch auf dem Produktionsserver ist eine Node.js-Laufzeit vorhanden, sodass sich npm-Pakete installieren lassen.

## Setup

### 1. npm-Paket installieren

Installieren Sie `@github/copilot` in `dependencies`.

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

Nach der Installation können Sie die Copilot CLI direkt über folgenden Pfad ausführen.

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

Ab Copilot CLI 1.0.64 ist `index.js` nur noch in plattformspezifischen Paketen enthalten. Passen Sie den Aufruf entsprechend Ihrer Umgebung an, wenn Sie `index.js` verwenden.

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

### 2. `.env` konfigurieren

Geben Sie in `COPILOT_CLI_PATH` den vollständigen Pfad zu `npm-loader.js` an.

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

Wenn Sie den Pfad dynamisch über `base_path()` setzen möchten, bearbeiten Sie `config/copilot.php` direkt.

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

## Deployment

Beim Deployment auf den Produktionsserver installieren Sie nach dem Asset-Build ohne `devDependencies` neu. Da `@github/copilot` in `dependencies` liegt, bleibt es erhalten.

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

Durch `npm install --omit=dev` werden die Pakete aus `devDependencies` entfernt, sodass nur die `dependencies`-Pakete (inklusive `@github/copilot`) in `node_modules` verbleiben.

## Vorteile und Hinweise

| Vorteile                                       | Hinweise                               |
| ---------------------------------------------- | -------------------------------------- |
| CLI-Version lässt sich streng verwalten        | Die Größe von `node_modules` wächst    |
| Version kann per `package.json` fixiert werden | CLI-Updates müssen manuell erfolgen    |
| Das gesamte Team verwendet dieselbe Version    | Eine Node.js-Laufzeit ist erforderlich |

## Authentifizierung

Die Authentifizierung ist unabhängig von der Installationsmethode identisch. Setzen Sie `COPILOT_GITHUB_TOKEN` in `.env`.

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

Details finden Sie unter [Authentifizierung](/de/packages/laravel-copilot-sdk/auth).

<Info>
  Aktuelle Informationen finden Sie im [GitHub-Repository](https://github.com/invokable/laravel-copilot-sdk).
</Info>


## Related topics

- [Laravel Boost Custom Agent for GitHub Copilot CLI](/de/packages/laravel-boost-copilot-cli.md)
- [Laravel LSP – IDE-Erweiterung per Language Server Protocol](/de/blog/laravel-lsp-introduction.md)
- [HTTP-Client](/de/http-client.md)
- [Anwendungsstruktur ab Laravel 11](/de/advanced/app-structure.md)
- [Macroable-Trait](/de/advanced/macroable.md)