Skip to main content

將 Copilot CLI 納入專案

若要嚴格控制 Copilot CLI 的版本,可將其作為 npm 套件納入專案。 一般而言,於部署時另外安裝 Copilot CLI 的方式即已足夠。 另請參考 在 Laravel Cloud 上的使用方式在 GitHub Actions 上的使用方式

前置條件

Laravel 專案已有 package.json,且正式伺服器也具備 Node.js 執行環境,因此可安裝 npm 套件。

設定

1. 安裝 npm 套件

dependencies 安裝 @github/copilot
安裝後可透過下列路徑直接執行 Copilot CLI。
Copilot CLI 1.0.64 之後,index.js 僅包含在各平台專屬套件中。若要使用 index.js,請依環境挑選。

2. 設定 .env

COPILOT_CLI_PATH 指定至 npm-loader.js 的完整路徑。
若要以 base_path() 動態設定路徑,可直接編輯 config/copilot.php

部署

部署到正式伺服器時,於資產建置後排除 devDependencies 重新安裝。由於 @github/copilot 位於 dependencies 中,因此會保留。
透過 npm install --omit=dev 會刪除 devDependencies 中的套件,僅將包含 @github/copilot 在內的 dependencies 保留於 node_modules

優點與注意事項

認證

認證方式與安裝方式無關,皆相同。於 .env 設定 COPILOT_GITHUB_TOKEN
詳情請參考 認證
最新資訊請參考 GitHub 儲存庫
最後修改於 2026年8月2日