Skip to content
 
 

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 代理同步協作。

  • 終端機原生開發: 直接在命令列中與 Copilot coding agent 協作——不需要切換情境。
  • 開箱即用的 GitHub 整合: 透過自然語言存取你的儲存庫、issue 與 pull request,並使用你現有的 GitHub 帳號完成驗證。
  • 代理式能力: 與能規劃並執行複雜任務的 AI 協作者一起建置、編輯、除錯與重構程式碼。
  • MCP 驅動的可擴充性: 利用 coding agent 預設隨附 GitHub 的 MCP server,且支援自訂 MCP server 以擴充能力的特性。
  • 完整掌控: 每個動作在執行前都可先預覽——沒有你的明確批准,任何事都不會發生。

我們仍處於這段旅程的早期階段,但有了你的回饋,我們正快速迭代,讓 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 slash command。輸入這個指令並依照畫面上的說明完成驗證。

使用 Personal Access Token (PAT) 進行驗證

你也可以使用已啟用「Copilot Requests」權限的細粒度 PAT 進行驗證。

  1. 前往 https://github.com/settings/personal-access-tokens/new
  2. 在「Permissions」下,點選「add permissions」並選擇「Copilot Requests」
  3. 產生你的權杖
  4. 透過環境變數 GH_TOKEN 或 GITHUB_TOKEN(依優先順序)將權杖加入你的環境

使用 CLI

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

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

實驗模式

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

  • 使用 --experimental 旗標啟動:copilot --experimental
  • 在 CLI 中使用 /experimental slash command

啟用後,該設定會持續保存在你的 config 中,因此後續啟動時不再需要 --experimental 旗標。

實驗功能

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

每次你向 GitHub Copilot CLI 提交一則 prompt,你每月的 premium requests 配額就會減少一個。關於 premium requests 的更多資訊,請參閱 About premium requests。

如需更多關於如何使用 GitHub Copilot CLI 的資訊,請參閱 我們的官方文件。

🔧 設定 LSP Servers

GitHub Copilot CLI 支援 Language Server Protocol (LSP),可提供更強的程式碼智慧功能。此功能可帶來跳至定義、懸停資訊與診斷等智慧程式碼能力。

安裝 Language Servers

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

npm install -g typescript-language-server

若是其他語言,請安裝對應的 LSP server,並依照下方所示的相同模式進行設定。

設定 LSP Servers

LSP servers 會透過專用的 LSP 設定檔進行設定。你可以在使用者層級或儲存庫層級設定 LSP servers:

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

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

範例設定:

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

查看 LSP Server 狀態

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

更多資訊請參閱 changelog。

📢 回饋與參與

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

我們正快速建置中。預期會有頻繁更新——請讓你的 client 保持最新,以取得最新功能與修正!

你的洞見非常寶貴!歡迎在此 repo 開啟 issue、加入 Discussions,並在 CLI 中執行 /feedback 來提交一份保密的意見調查!

About

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

Resources

Stars

32 stars

Watchers

4 watching

Forks

Releases

Packages

Contributors