Skip to content

doggy8088/copilot-cli

 
 

Repository files navigation

GitHub Copilot CLI

GitHub Copilot 的強大能力,現在來到你的終端機。

GitHub Copilot CLI 直接將 AI 驅動的程式設計協助帶進你的命令列,讓你能透過自然語言對話來建置、除錯與理解程式碼。它採用與 GitHub 的 Copilot coding agent 相同的代理式執行框架,在與你的 GitHub 工作流程深度整合的同時提供智慧協助。

更多資訊請參閱 官方文件

Copilot CLI 啟動畫面的圖片

🚀 簡介與總覽

我們將 GitHub Copilot coding agent 的強大能力直接帶進你的終端機。透過 GitHub Copilot CLI,你可以在本機同步地與一個理解你的程式碼與 GitHub 情境的 AI agent 協作。

  • 終端機原生開發: 直接在命令列中與 Copilot coding agent 協作,不需要切換上下文。
  • 開箱即用的 GitHub 整合: 透過自然語言存取你的儲存庫、issues 與 pull requests,全部使用你現有的 GitHub 帳號完成驗證。
  • 代理式能力: 與能規劃並執行複雜任務的 AI 協作者一起建置、編輯、除錯與重構程式碼。
  • MCP 驅動的擴充性: 善用 coding agent 預設隨附 GitHub MCP server 的能力,並可透過支援自訂 MCP servers 來延伸功能。
  • 完整掌控: 每個動作在執行前都能先預覽,未經你明確核准,不會進行任何操作。

我們仍處於早期階段,但在你的回饋幫助下,我們正快速迭代,讓 GitHub Copilot CLI 成為你終端機中最好的夥伴。

📦 開始使用

支援平台

  • Linux
  • macOS
  • Windows

先決條件

  • (在 Windows 上)PowerShell v6 或更新版本
  • 有效的 Copilot 訂閱。請參閱 Copilot plans

如果你是透過組織或企業取得 GitHub Copilot 的存取權,且你的組織擁有者或企業管理員已在組織或企業設定中停用 GitHub Copilot CLI,則你無法使用 GitHub Copilot CLI。更多資訊請參閱 Managing policies and features for GitHub Copilot in your organization

安裝

使用安裝腳本安裝(macOS 與 Linux):

curl -fsSL https://gh.io/copilot-install | bash

wget -qO- https://gh.io/copilot-install | bash

使用 | sudo bash 可用 root 身分執行,並安裝到 /usr/local/bin

設定 PREFIX 可安裝到 $PREFIX/bin/ 目錄。以 root 執行時預設為 /usr/local, 以非 root 使用者執行時則預設為 $HOME/.local

設定 VERSION 可安裝特定版本。預設為最新版本。

例如,將版本 v0.0.369 安裝到自訂目錄:

curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bash

使用 Homebrew 安裝(macOS 與 Linux):

brew install copilot-cli
brew install copilot-cli@prerelease

使用 WinGet 安裝(Windows):

winget install GitHub.Copilot
winget install GitHub.Copilot.Prerelease

使用 npm 安裝(macOS、Linux 與 Windows):

npm install -g @github/copilot
npm install -g @github/copilot@prerelease

啟動 CLI

copilot

第一次啟動時,你會看到我們可愛的動態橫幅!如果你想再次看到這個橫幅,請使用 --banner 旗標啟動 copilot

如果你目前尚未登入 GitHub,系統會提示你使用 /login 斜線命令。輸入這個命令,並依照畫面上的指示完成驗證。

使用 Personal Access Token (PAT) 驗證

你也可以使用啟用了 "Copilot Requests" 權限的細粒度 PAT 來完成驗證。

  1. 造訪 https://github.com/settings/personal-access-tokens/new
  2. 在 "Permissions" 下按一下 "add permissions",並選擇 "Copilot Requests"
  3. 產生你的 token
  4. 透過環境變數 GH_TOKENGITHUB_TOKEN(依此優先順序)將 token 加入你的環境

使用 CLI

在包含你想處理程式碼的資料夾中啟動 copilot

預設情況下,copilot 會使用 Claude Sonnet 4.5。執行 /model 斜線命令,從其他可用模型中選擇,包括 Claude Sonnet 4 與 GPT-5。

實驗模式

實驗模式可讓你使用仍在開發中的新功能。你可以透過以下方式啟用實驗模式:

  • 使用 --experimental 旗標啟動:copilot --experimental
  • 在 CLI 內使用 /experimental 斜線命令

啟用後,這項設定會持久化寫入你的設定,因此後續啟動時就不再需要 --experimental 旗標。

實驗性功能

  • Autopilot mode: Autopilot 是一種新模式(按 Shift+Tab 可循環切換模式),會鼓勵 agent 持續工作直到任務完成。

每次你向 GitHub Copilot CLI 提交 prompt 時,你每月的 premium requests 額度都會減少一次。關於 premium requests,請參閱 About premium requests

若要進一步了解如何使用 GitHub Copilot CLI,請參閱 官方文件

🔧 設定 LSP 伺服器

GitHub Copilot CLI 支援 Language Server Protocol(LSP),以提供更完整的程式碼智慧功能。這項功能可提供像是跳到定義、懸停資訊與診斷等智慧型程式碼能力。

安裝語言伺服器

Copilot CLI 不會內建 LSP 伺服器。你需要另外安裝它們。例如,若要設定 TypeScript 支援:

npm install -g typescript-language-server

對於其他語言,請安裝對應的 LSP 伺服器,並依照下方示範的相同模式進行設定。

設定 LSP 伺服器

LSP 伺服器透過專用的 LSP 設定檔來設定。你可以在使用者層級或儲存庫層級設定 LSP 伺服器:

使用者層級設定(套用至所有專案): 編輯 ~/.copilot/lsp-config.json

儲存庫層級設定(套用至特定專案): 在儲存庫根目錄建立 .github/lsp.json

範例設定:

{
  "lspServers": {
    "typescript": {
      "command": "typescript-language-server",
      "args": ["--stdio"],
      "fileExtensions": {
        ".ts": "typescript",
        ".tsx": "typescript"
      }
    }
  }
}

檢視 LSP 伺服器狀態

你可以在互動式工作階段中使用 /lsp 指令檢查已設定的 LSP 伺服器,或直接查看你的設定檔。

更多資訊請參閱 changelog

📢 回饋與參與

很高興你在 Copilot CLI 旅程的早期就加入我們。

我們開發速度很快。更新會相當頻繁,請讓你的用戶端保持最新,以取得最新功能與修正!

你的意見非常重要!請在這個 repo 開 issue、加入 Discussions,並在 CLI 中執行 /feedback 送出保密的意見回饋問卷!

About

GitHub Copilot CLI 將 Copilot 程式設計代理的力量直接帶到您的終端機。

Resources

License

Stars

32 stars

Watchers

4 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors