Copilot CLI 번들 - Knowledge of Laravel

프로젝트에 Copilot CLI 포함하기

Copilot CLI 버전을 엄격하게 관리하려는 경우, npm 패키지로 프로젝트에 포함할 수 있습니다. 일반적으로는 배포 시 별도로 Copilot CLI를 설치하는 방법으로 충분합니다. Laravel Cloud에서의 사용법과 GitHub Actions에서의 사용법도 참고하세요.

사전 조건

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

설정

1. npm 패키지 설치

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

npm install @github/copilot

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

node node_modules/@github/copilot/npm-loader.js --version

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

node node_modules/@github/copilot-linux-x64/index.js --version

2. `.env` 설정

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

COPILOT_CLI_PATH=/path/to/project/node_modules/@github/copilot/npm-loader.js

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

'cli_path' => base_path('node_modules/@github/copilot/npm-loader.js'),

배포

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

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을 설정합니다.

COPILOT_GITHUB_TOKEN=your-token

자세한 내용은 인증을 참고하세요.

최신 정보는 GitHub 저장소를 참고하세요.

마지막 수정일 2026년 7월 13일

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

​사전 조건

​설정

​1. npm 패키지 설치

​2. .env 설정

​배포

​장점과 주의점

​인증

프로젝트에 Copilot CLI 포함하기

사전 조건

설정

1. npm 패키지 설치

2. `.env` 설정

배포

장점과 주의점

인증