指令與旗標速查

這份附錄是你的「隨手翻」小抄——把整本書教過的指令、旗標、設定鍵、slash 指令，全部濃縮成一張張表格，讓你不用翻回前面十幾章就能查到。

想像它是一本料理書最後面的「食材對照表」：平常做菜你看正文步驟，但臨時忘了「一小匙醬油是幾毫升」，翻到最後一頁掃一眼就找到。這份附錄就是 GitHub Copilot CLI 的那一頁——不講原理、不講比喻，只給你「我想做 X → 該打什麼」。

A.1 安裝方式速查

四條官方安裝路徑，裝到的都是同一個 copilot 指令，差別只在你手邊工具最順手哪一種。

(料源：official，Installing GitHub Copilot CLI；已內建於 GitHub Codespaces 預設映像，不用額外裝)

# npm（注意套件名是 @github/copilot，不是 @github/copilot-cli）
npm install -g @github/copilot

# 若 ~/.npmrc 設了 ignore-scripts=true，改用這行讓安裝腳本正常跑完
npm_config_ignore_scripts=false npm install -g @github/copilot

# 想搶先用預發行版（不建議日常使用）
npm install -g @github/copilot@prerelease

# WinGet（Windows 原生，不需要 WSL）
winget install GitHub.Copilot
winget install GitHub.Copilot.Prerelease

# Homebrew（務必加 --cask，漏了會裝錯或找不到）
brew install --cask copilot-cli
brew install --cask copilot-cli@prerelease

(料源：official)

驗證安裝與解除安裝：

copilot --version          # 有反應就代表裝好了
npm uninstall -g @github/copilot        # 依你當初的安裝法對應反向指令
brew uninstall --cask copilot-cli
winget uninstall GitHub.Copilot

(料源：npm/Homebrew/WinGet 三種安裝指令為 official；解除安裝表官方安裝頁完全沒有「Uninstalling」段落，上面是各套件管理工具的標準反向指令推論，非官方逐字步驟，料源：community／推論)

A.2 主要 CLI 旗標分組

這些旗標加在 copilot 後面，用來「這一次」臨時改行為。

A.2.1 會話控制

(料源：official，GitHub Copilot CLI command reference)

A.2.2 非互動模式

(料源：official，GitHub Copilot CLI programmatic reference ＋ command reference，詳見第 10 章)

copilot -p "summarize this repository" -s
copilot -p "audit the auth module for security issues" --share=./audit-report.md
copilot -p "list the top 5 files by risk" --output-format=json

A.2.3 權限控制

(料源：official，Allowing tools to run，詳見第 6 章／第 7 章)

# 整個工具種類都放行
copilot --allow-tool=shell

# 精準放行某一句完整指令
copilot --allow-tool='shell(git commit)'

# 用萬用字元放行整組 git 子指令，但單獨擋掉 push
copilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'

# 只放行寫入某個特定檔案
copilot --allow-tool='write(.github/copilot-instructions.md)'

# 放行某個 MCP 工具
copilot --allow-tool='github(create_issue)'

(料源：official；萬用字元只在 shell 比對所有子指令、url 比對子網域或路徑後綴這兩種情境有效，不是到處都能丟 *)

A.2.4 MCP 相關

(料源：--add-github-mcp-toolset／--enable-all-github-mcp-tools 為 official，第 9 章已逐字核對；--additional-mcp-config／--disable-builtin-mcps／--disable-mcp-server 三項出自本書研究筆記引用 Add MCP servers 頁面，但完整逐字參數本次未能在其他章節二次核對，建議動手前先跑 copilot mcp --help 或 copilot --help 確認你這一版實際支援的寫法)

copilot --add-github-mcp-toolset discussions
copilot --enable-all-github-mcp-tools

A.2.5 模型指定

模型決定的五層優先序（由高到低）：custom agent 定義裡指定的 model → --model 旗標 → COPILOT_MODEL 環境變數 → ~/.copilot/settings.json 裡的 model 欄位 → CLI 預設模型。

(料源：official，GitHub Copilot CLI programmatic reference，詳見第 8 章／第 10 章)

copilot -p "What does this project do?" -s --model claude-haiku-4.5

A.3 子命令總表

copilot 後面直接接的子命令。

(料源：official，逐項出自各對應章節已核對的官方文件)

A.4 互動模式 Slash 指令速查

在互動畫面的輸入框打 / 會跳出選單。官方原始文件列出超過 80 個斜線指令，這裡只收本書逐章查證過、比較常用的一批，依用途分組。完整清單以實機 /help 為準。

A.4.1 帳號與 Session

A.4.2 工作模式與計畫

A.4.3 目錄與上下文

A.4.4 回滾與安全掃描

A.4.5 設定與模型

A.4.6 MCP、Skills、沙箱、委派

A.4.7 排程（僅限實驗模式）

(料源：official，逐項出自各對應章節已核對的官方文件；A.4.1～A.4.6 多數指令詳見對應章節，A.4.7 兩個指令官方說明明確標註「Only available in experimental mode」，先打 /experimental on 才會生效，正式生產排程建議改用外部 cron／Task Scheduler，詳見第 10 章)

A.5 快捷鍵速查（互動畫面）

(料源：official，逐項出自第 4 章／第 9 章已核對的官方文件)

A.6 環境變數速查

(料源：COPILOT_HOME／COPILOT_CACHE_HOME／COPILOT_CUSTOM_INSTRUCTIONS_DIRS／COPILOT_MODEL／三個認證 token／COPILOT_TASK_WAIT_TIMEOUT_SECONDS 為 official，出自第 8 章／第 10 章已核對的 CLI 設定目錄參考、programmatic reference、command reference；NODE_EXTRA_CA_CERTS／HTTPS_PROXY／HTTP_PROXY／NO_PROXY 出自本頁研究筆記引用的 network errors 疑難排解 與 network settings 頁面)

# 用 COPILOT_HOME 幫這次執行套上一個獨立、乾淨的設定人格
COPILOT_HOME=$(pwd)/.copilot-test copilot

(料源：practice，改寫自第 8 章示範寫法)

A.7 ~/.copilot 設定目錄結構

Windows 對應路徑是 %USERPROFILE%\.copilot\。目錄下的檔案分兩大類：你可以手動編輯的，和系統自動管理、不該手動碰的。

使用者可編輯

系統自動管理（別手動編輯）

(料源：official，CLI 設定目錄參考，詳見第 8 章)

A.8 Hooks 事件名稱速查

Copilot CLI 官方目前查證到 6 個生命週期事件，注意是 camelCase 命名——這點跟 Claude Code、Codex CLI 慣用的 PascalCase（PreToolUse、SessionStart 等）不同，直接照抄大寫開頭的事件名貼進 Copilot 的 hooks 設定會抓不到。

設定檔位置：.github/hooks/<NAME>.json，須含 version: 1 欄位與 hooks 物件。

(料源：official，Use hooks、Hooks reference、Hooks 概念)

本章小結

這份附錄把全書查證過的指令濃縮成八張速查表：安裝方式（含解除安裝的誠實推論標註）、五組主要旗標（會話控制、非互動模式、權限控制、MCP、模型指定）、子命令總表、依用途分組的常用 slash 指令、鍵盤快捷鍵、環境變數、~/.copilot 設定目錄結構、hooks 六事件。查證過程中發現的幾處落差——--cloud 旗標、copilot skill 子命令、Ctrl+T／Ctrl+R／! 前綴快捷鍵、COPILOT_SUBAGENT_MAX_CONCURRENT／XDG_CONFIG_HOME 兩個環境變數——都老實標成待查，沒有在其他章節被二次核對到，別當成鐵律背下來。

把它當隨身小抄——但永遠記得最上面那句 ⚠️：GitHub Copilot CLI 改版很快，逐字旗標與 slash 指令永遠以你電腦上的 copilot --help、互動畫面裡的 /help 為最終真相。

動手試試

1. 打 copilot --help，看看你這一版實際支援哪些旗標，跟 A.2、A.3 兩張表對一次，圈出哪些跟本書寫的不一樣。
2. 在互動畫面打 /，感受一下超過 80 個 slash 指令的選單長什麼樣，再對照 A.4 的分組表，確認你常用的那幾個都還在。
3. 打 ? 看看快捷鍵的官方說明畫面，親自確認一次 A.5 裡標「待查」的 Ctrl+T／Ctrl+R 在你這一版是否存在。
4. 跑 copilot help environment（若你這一版支援），對照 A.6 的環境變數表，確認 COPILOT_SUBAGENT_MAX_CONCURRENT 是否真的存在。
5. 打開 ~/.copilot/ 資料夾，對照 A.7 的兩張表，看看哪些檔案已經生成、哪些還沒——記得只看，別手動改 config.json。

本章官方文件參考

• 安裝：docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli
• CLI 指令參考：docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference
• CLI 程式化參考：docs.github.com/en/copilot/reference/copilot-cli-reference/cli-programmatic-reference
• CLI 設定目錄參考：docs.github.com/en/copilot/reference/copilot-cli-reference/cli-config-dir-reference
• 工具核准與允許機制：docs.github.com/en/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools
• 新增 MCP 伺服器：docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers
• Hooks：docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/use-hooks、docs.github.com/en/copilot/reference/hooks-reference
• 排定 prompt 執行時間：docs.github.com/en/copilot/how-tos/copilot-cli/automate-copilot-cli/schedule-prompts
• 網路疑難排解：docs.github.com/en/copilot/troubleshooting-github-copilot/troubleshooting-network-errors-for-github-copilot
• GitHub（版本號真相在 releases）：github.com/github/copilot-cli/releases