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 整合: 使用自然語言存取你的 repositories、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

第一次啟動時,你會看到我們可愛的動畫橫幅!如果你想再次看到這個橫幅,請在啟動 copilot 時加上 --banner 旗標。

如果你目前尚未登入 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. 產生你的 token
  4. 透過環境變數 GH_TOKENGITHUB_TOKEN(依優先順序)把 token 加入你的環境

使用 CLI

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

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

實驗模式

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

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

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

實驗功能

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

每次你向 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 設定檔進行設定。你可以在使用者層級或 repository 層級設定 LSP servers:

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

Repository 層級設定(套用到特定專案): 在你的 repository 根目錄建立 .github/lsp.json

設定範例:

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

檢視 LSP Server 狀態

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

更多資訊請參閱 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