Passer au contenu principal

Inclure le Copilot CLI dans le projet

Si vous souhaitez contrôler strictement la version du Copilot CLI, vous pouvez l’inclure dans votre projet en tant que paquet npm. En général, installer le Copilot CLI séparément lors du déploiement suffit. Voir aussi Utilisation avec Laravel Cloud et Utilisation avec GitHub Actions.

Prérequis

Votre projet Laravel possède un package.json et votre serveur de production dispose d’un environnement Node.js, ce qui vous permet d’installer des paquets npm.

Mise en place

1. Installer le paquet npm

Installez @github/copilot dans les dependencies.
npm install @github/copilot
Après installation, vous pouvez exécuter le Copilot CLI directement via le chemin suivant.
node node_modules/@github/copilot/npm-loader.js --version
À partir de Copilot CLI 1.0.64, index.js n’est inclus que dans les paquets par plateforme. Si vous utilisez index.js, adaptez-le à votre environnement.
node node_modules/@github/copilot-linux-x64/index.js --version

2. Configurer .env

Indiquez dans COPILOT_CLI_PATH le chemin complet vers npm-loader.js.
COPILOT_CLI_PATH=/path/to/project/node_modules/@github/copilot/npm-loader.js
Pour définir le chemin dynamiquement avec base_path(), modifiez directement config/copilot.php.
'cli_path' => base_path('node_modules/@github/copilot/npm-loader.js'),

Déploiement

Lors du déploiement en production, après la construction des assets, réinstallez sans les devDependencies. @github/copilot étant dans les dependencies, il est conservé.
npm install
npm run build
npm install --omit=dev
npm install --omit=dev retire les paquets des devDependencies et ne laisse dans node_modules que les paquets des dependencies, dont @github/copilot.

Avantages et points d’attention

AvantagesPoints d’attention
Contrôle strict de la version du CLILa taille de node_modules augmente
Version épinglée via package.jsonLes mises à jour du CLI doivent être faites manuellement
Toute l’équipe utilise la même versionNécessite un environnement Node.js

Authentification

La méthode d’authentification est identique quelle que soit la méthode d’installation. Définissez COPILOT_GITHUB_TOKEN dans .env.
COPILOT_GITHUB_TOKEN=your-token
Pour plus de détails, voir Authentification.
Pour les dernières informations, consultez le dépôt GitHub.
Dernière modification le 13 juillet 2026