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

# Includere Copilot CLI nel bundle

> Descrive come includere Copilot CLI come dipendenza npm nel progetto Laravel quando vuoi controllarne rigorosamente la versione.

## Includere Copilot CLI nel progetto

Se vuoi controllare rigorosamente la versione di Copilot CLI, puoi includerla nel progetto come pacchetto npm.

In generale è sufficiente installare Copilot CLI separatamente al momento del deploy.
Consulta anche [Uso su Laravel Cloud](/it/packages/laravel-copilot-sdk/laravel-cloud) e [Uso con GitHub Actions](/it/packages/laravel-copilot-sdk/github-actions).

## Prerequisiti

Il progetto Laravel ha un `package.json` e anche il server di produzione dispone di un ambiente di esecuzione Node.js, quindi è possibile installare pacchetti npm.

## Setup

### 1. Installa il pacchetto npm

Installa `@github/copilot` in `dependencies`.

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

Dopo l'installazione, puoi eseguire direttamente Copilot CLI dal seguente percorso.

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

Da Copilot CLI 1.0.64 in avanti, `index.js` è incluso solo nei pacchetti specifici per piattaforma; se usi `index.js`, adattalo all'ambiente.

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

### 2. Configura `.env`

Imposta in `COPILOT_CLI_PATH` il percorso completo fino a `npm-loader.js`.

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

Se vuoi impostare dinamicamente il percorso usando `base_path()`, modifica direttamente `config/copilot.php`.

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

## Deploy

Quando esegui il deploy sul server di produzione, dopo la build degli asset reinstalla escludendo `devDependencies`. Poiché `@github/copilot` è in `dependencies`, viene mantenuto.

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

Con `npm install --omit=dev` i pacchetti di `devDependencies` vengono rimossi e in `node_modules` restano solo quelli di `dependencies`, incluso `@github/copilot`.

## Vantaggi e considerazioni

| Vantaggi                                             | Considerazioni                          |
| ---------------------------------------------------- | --------------------------------------- |
| Puoi controllare rigorosamente la versione della CLI | La dimensione di `node_modules` aumenta |
| Puoi bloccare la versione in `package.json`          | L'aggiornamento della CLI è manuale     |
| Tutto il team usa la stessa versione                 | Serve un ambiente di esecuzione Node.js |

## Autenticazione

Il metodo di autenticazione è lo stesso indipendentemente dal tipo di installazione. In `.env` imposta `COPILOT_GITHUB_TOKEN`.

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

Per i dettagli consulta [Autenticazione](/it/packages/laravel-copilot-sdk/auth).

<Info>
  Per le informazioni più recenti fai riferimento al [repository GitHub](https://github.com/invokable/laravel-copilot-sdk).
</Info>


## Related topics

- [Loop dell'agente](/it/packages/laravel-copilot-sdk/agent-loop.md)
- [Plugin Directories](/it/packages/laravel-copilot-sdk/plugin-directories.md)
- [Bundle degli asset con Vite](/it/vite.md)
- [Laravel Pennant](/it/pennant.md)
- [Autenticazione - GitHub Copilot SDK for Laravel](/it/packages/laravel-copilot-sdk/auth.md)