---
title: "Copilot CLI"
description: "按 GitHub 官方文件梳理 Copilot CLI 的安裝認證、許可權配置、任務委派、回復和 PR 工作流。"
verifiedAt: "2026-05-06"
---

GitHub Copilot CLI 把 Copilot 放進終端。它可以回答問題、寫程式碼、除錯、與 GitHub.com 互動，也可以用程式化（programmatic）方式接入指令碼。

這組頁面不把 CLI 當"命令直譯器"輕描淡寫。官方文件已經把它描述成"原生於終端的 AI 程式設計助手"：它能讀寫檔案、執行 shell commands、呼叫工具、管理 PR，也能進入 autopilot 自動模式——能力越靠近終端，越需要許可權、審查和回復這條配套鏈。

> [!TIP]
> **閱讀目標**：讀完本組索引，你應該能把 Copilot CLI 放進可回復、可審查、可限制工具許可權的終端工作流。

## 1. 工作流地圖

- **安裝認證**：用 npm、Homebrew、WinGet 或安裝指令碼安裝；首次啟動用 `/login`。
- **配置邊界**：確認 trusted directories、allowed tools、path permissions、URL permissions。
- **互動使用**：輸入 `copilot` 啟動 session，用 Ask / Plan / Execute 處理任務。
- **非互動使用**：用 `-p` 或 `--prompt` 從命令列傳入一次性 prompt。
- **委派任務**：用 autopilot 在本地執行，或用 `/delegate` 交給 cloud agent。
- **回復**：用雙擊 `Esc` 或 `/undo` 回到某個 prompt 前的 snapshot。

```mermaid
flowchart TD
    Install["安裝 Copilot CLI"] --> Login["/login 認證"]
    Login --> Trust["確認 trusted directory"]
    Trust --> Mode{"使用方式"}
    Mode --> Interactive["Interactive session"]
    Mode --> Programmatic["-p / --prompt"]
    Interactive --> Tools["工具批准 / allow-deny"]
    Programmatic --> Tools
    Tools --> Work["讀寫檔案 / shell / GitHub"]
    Work --> Review["diff / test / PR"]
    Review --> Rollback{"需要回復?"}
    Rollback -->|是| Undo["Esc Esc / /undo"]
    Rollback -->|否| Done["提交或 PR review"]

    style Trust fill:#fef3c7,stroke:#d97706,stroke-width:2px
    style Review fill:#dcfce7,stroke:#16a34a,stroke-width:2px
    style Undo fill:#fee2e2,stroke:#dc2626,stroke-width:2px
```

## 2. 本組頁面

<Cards>
  <Card title="Copilot CLI 是什麼" description="理解 CLI 的互動/非互動模式、Plan、自動上下文管理、模型和安全邊界。" href="/zh-Hant/docs/github-copilot/official/05-copilot-cli/about-copilot-cli" />
  <Card title="安裝、認證和配置" description="安裝 CLI，完成 /login，配置 trusted folders、allowed tools、paths、URLs 和 LSP。" href="/zh-Hant/docs/github-copilot/official/05-copilot-cli/install-auth-config" />
  <Card title="委派任務" description="區分本地 autopilot 和 /delegate 到 cloud agent 的任務邊界。" href="/zh-Hant/docs/github-copilot/official/05-copilot-cli/delegate-tasks" />
  <Card title="回復和 PR 管理" description="用 snapshots、Esc Esc、/undo、git diff 和 PR review 保留回復鏈路。" href="/zh-Hant/docs/github-copilot/official/05-copilot-cli/rollback-pr" />
</Cards>

## 3. 團隊預設策略

建議把 Copilot CLI 作為受控終端 agent，而不是預設全自動：

- 不從 home directory 啟動。
- 不在含敏感資料或未知執行檔的目錄裡信任 workspace。
- 預設不使用 `--allow-all-tools`。
- 禁止自動執行 `rm`、`git push`、部署、雲資源修改。
- 允許工具時優先 `--allow-tool` 精確授權。
- 每次寫入後看 `git diff` 和測試結果。
- 會話失敗時先回復，再重新縮小任務。

## 4. 適合任務

適合：

- 解釋命令和錯誤。
- 快速探索程式碼庫。
- 生成小補丁、測試或指令碼。
- 管理 issue、PR、GitHub Actions。
- 把任務委派到 cloud agent 繼續非同步執行。

不適合：

- 無人值守生產部署。
- 需要真實憑據和客戶資料的排障。
- 沒有 Git 儲存庫和快照的高風險寫入。
- 任務範圍不清卻開啟 autopilot。

<details>
<summary>深讀：為什麼 CLI 比 IDE Chat 更需要許可權模型</summary>

IDE Chat 的很多輸出仍需要你複製或應用；CLI 可以直接執行 shell command、修改檔案、呼叫 GitHub 或 MCP 工具。終端的副作用更直接。

所以 Copilot CLI 的商業級使用重點不是“能不能幫我做”，而是“允許它用哪些工具、哪些路徑、哪些 URL，以及出錯後怎麼撤回”。
</details>

## 本組自檢

讀完整組後，用這 4 個問題檢查：

1. 當前目錄是否值得信任，是否含敏感或未知可執行內容？
2. 當前任務需要哪些 tool、path、URL 許可權，哪些必須停用？
3. 使用 autopilot 或 `/delegate` 前，任務邊界是否足夠清楚？
4. 寫入後能否用 snapshot、Git、PR 或人工 review 回復和審查？

透過標準：CLI 會話的每次寫入、命令和委派都有可審查證據。

## 官方來源

- [About GitHub Copilot CLI](https://docs.github.com/en/copilot/concepts/agents/copilot-cli/about-copilot-cli) —— 官方概念頁，覆蓋模式、用例、上下文、定製、安全、模型和 ACP。
- [Getting started with GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/cli-getting-started) —— 官方快速開始。
- [Installing GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli) —— 官方安裝認證頁。
- [Configuring GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli) —— 官方許可權配置頁。

## 接下來去哪

<Cards>
  <Card title="Copilot CLI 是什麼" description="先理解 CLI 模式和安全邊界。" href="/zh-Hant/docs/github-copilot/official/05-copilot-cli/about-copilot-cli" />
  <Card title="安裝、認證和配置" description="再把安裝、登入、trusted directory 和工具許可權跑通。" href="/zh-Hant/docs/github-copilot/official/05-copilot-cli/install-auth-config" />
</Cards>
