官方文件與版本驗證連結地圖

把這份附錄想成一本旅遊書最後那幾頁的「實用資訊」：招式都學完了，但 GitHub Copilot CLI 更新很快——本書查核當下（2026-07-18）對照的版本是 v1.0.71（2026-07-16 才剛釋出），等你讀到這裡，說不定又跳了好幾版。總有一天你會想確認「這個旗標現在還在嗎？」「最新版幾號？」「官方到底怎麼說？」，這時候與其相信網路上一篇搜尋排名很前面、但早就過時的舊教學，不如直接回官方源頭自己查一眼。

這附錄幫你做四件事：

• 講清楚 GitHub 官方生態裡四個資訊來源各管什麼，別找錯地方；
• 教你一個新手最容易搞混的觀念：版本號的真相在 GitHub releases，不是文件站、也不是全站 changelog；
• 把本書所有官方依據依主題分類整理成一張連結總表，需要時直接點；
• 老實列一張「本書寫作時還沒被官方逐字坐實、建議你實機再核對」的清單。

C.1 官方來源在哪裡：四個地方，各管各的

Copilot CLI 的官方資訊比較特別，散在四個地方，比本書其他三套 CLI（各自大多集中在「一個開發者文件站＋一個 GitHub repo」兩處）多一處。先搞懂這四個各管什麼，之後查資料就不會迷路。

四個都是官方、都可信，只是分工不同——尤其第三項「全站 Changelog」，很容易被誤會成「CLI 專屬更新日誌」，但它其實混雜了 Copilot Chat、agent mode、IDE 擴充等整條產品線的公告，CLI 只是其中一小塊。

C.2 版本號真相：GitHub releases，不是 Changelog

這一節是整個附錄最重要的觀念，新手很容易在這裡被誤導，所以單獨講。

你可能會直覺以為：「想知道 Copilot CLI 最新版本，去 github.blog/changelog 或文件站看看就好？」——不完全對。

問題出在這：

• github.blog/changelog 是跨整條 Copilot 產品線的公告牆，GA、政策異動這種大事件會在這裡發，但它不是逐版列出「CLI vX.Y.Z 改了什麼」的地方。
• 真正帶版本號的 CLI 逐版釋出紀錄，在 GitHub releases：github.com/github/copilot-cli/releases，每一版的 tag 長得像 vX.Y.Z。

版本史背景，順便一次講清楚：Copilot CLI 2025-09 公開預覽（Public Preview）上線，2026-02-25 正式 GA（官方原文「GitHub Copilot CLI is now generally available」）——GA 公告當時對應的版本是 v0.0.418，之後大版號直接跳到 1.0 來慶祝 GA 這個里程碑，不是照 semver 慣例一路 0.x 累加上去的。查核當下（2026-07-18）最新版是 v1.0.71（2026-07-16 釋出）。

# official — 官方逐字指令
copilot --version

# official — 官方逐字指令
copilot update

C.3 官方文件全頁清單（依主題分類）

這是本書所有官方依據的總連結清單，照「你想學什麼」分好類，每一塊也標了「本書對應第幾章」，方便你回頭複習。

入門 / 安裝 / 登入（對應第 0～3 章）

• 認識 Copilot CLI 是什麼（概念頁）：docs.github.com/en/copilot/concepts/agents/about-copilot-cli
• 安裝 Copilot CLI：docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli
• 認證疑難排解：docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/troubleshoot-copilot-cli-auth

指令與旗標逐字參考（對應第 4、8 章與附錄 A）

• CLI 指令總表：docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference
• 程式化 / 非互動參考：docs.github.com/en/copilot/reference/copilot-cli-reference/cli-programmatic-reference
• 設定目錄結構參考：docs.github.com/en/copilot/reference/copilot-cli-reference/cli-config-dir-reference

自訂 Copilot CLI（對應第 5、9、12 章）

• 自訂指示檔案（copilot-instructions.md／AGENTS.md／CLAUDE.md／GEMINI.md）：add-custom-instructions
• 建立自訂代理（Custom Agents）：create-custom-agents-for-cli
• 新增 Skills：add-skills
• 新增 MCP servers：add-mcp-servers
• 使用 Hooks：use-hooks
• Hooks 逐字參考：hooks-reference
• 工具權限模型：allowing-tools
• Copilot Memory（跨 session 自動記憶，非人工維護的指示檔案）：copilot-memory

企業管理 / 政策（對應第 3、15 章）

• 企業管理 Copilot CLI：administer-copilot-cli-for-your-enterprise
• 政策階層概念：docs.github.com/en/copilot/concepts/policies

自動化 / GitHub Actions（對應第 11 章）

• 用 GitHub Actions 自動化 Copilot CLI：automate-with-actions

網路 / 憑證 / Proxy（對應第 16 章）

• Copilot 網路錯誤疑難排解：troubleshooting-network-errors-for-github-copilot
• Copilot 網路個人化設定：configuring-network-settings-for-github-copilot
• Copilot 常見問題疑難排解（通用，非 CLI 專屬）：troubleshooting-common-issues-with-github-copilot

定價 / 用量（對應第 3、15 章）

• 方案與定價比較：github.com/features/copilot/plans
• Premium requests 計費說明：github-copilot-premium-requests
• GA 移動到用量計費公告：GitHub Copilot is moving to usage-based billing

GitHub（原始碼、版本號、issue）

• 主 repo：github.com/github/copilot-cli
• 版本號真相（releases，tag vX.Y.Z）：github.com/github/copilot-cli/releases
• Issue 回報：github.com/github/copilot-cli/issues
• npm 套件頁：npmjs.com/package/@github/copilot

C.4 遇到問題、想回報 bug，去哪裡

如果你不是要查功能，而是踩到雷想找解法、或想回報問題，路線不太一樣：

本書第 16 章引用過幾個真實的 GitHub issue 當佐證（這些是社群回報、非官方逐字承認的行為，標記為 community 來源），也是你搜尋同類問題的好起點：

• /usage 顯示的用量疑似低估實際消耗：issue #1582 🌐社群
• quota_exceeded（HTTP 402）誤判，即使開了超額付費仍被擋：issue #3431 🌐社群
• HTTP_PROXY / HTTPS_PROXY 指向無效本地 proxy 時靜默退出、無清楚錯誤訊息：issue #2225 🌐社群
• Context 用量計算異常，觸發持續自動壓縮迴圈：issue #2496 🌐社群

# official — 官方逐字指令
copilot --version

C.5 本書寫作時「建議你實機再核對」的清單

這一節很誠實，也很重要。

Copilot CLI 更新極快，本書寫作時（2026-07-18，對照 v1.0.71 版），有些細節官方還沒逐字寫死、或還在演進中。本書遇到這類情況，都用了保守寫法並提醒你「以實機為準」。這裡把它們集中列成一張清單，讓你心裡有底：看到這些，別當成鐵板釘釘，自己動手再確認一次。

copilot help              # official — 全域指令與旗標
copilot help [TOPIC]      # official — 特定主題的詳細說明
copilot --version         # official — 本機實際版本

C.6 一分鐘「我該查哪裡」速查

把整個附錄濃縮成一張「遇到問題、直覺反應該翻哪」的速查表，釘在心裡就夠：

本章小結

這篇附錄幫你建立一張「上哪查最準」的地圖：GitHub 官方資訊散在四個地方——開發者文件站（docs.github.com/en/copilot，學功能）、GitHub 原始碼 repo（github.com/github/copilot-cli，查版本號與 issue）、全站 Changelog（github.blog/changelog，跨整條產品線的大事件公告）、npm 套件頁（確認套件實際版本）。全篇最重要的一條觀念是：版本號的真相在 GitHub releases，不是文件站，也不是全站 Changelog——查核當下最新版是 v1.0.71（2026-07-16），GA 是 2026-02-25（當時版本 v0.0.418，之後大版號跳到 1.0 慶祝）。你也拿到了一張依主題分類的官方文件總連結清單、一份回報問題的路線圖，以及一張老實列出「還沒被官方逐字坐實、建議你自己再核對一次」的清單——包括 Free 方案能不能用 CLI、Business/Enterprise 確切額度、幾個還在演進中的社群回報 issue，以及 Copilot Memory、Windows 原生 PowerShell 模式目前的狀態。

動手試試

1. 打開終端機依序跑 copilot --version 和 copilot help，跟本附錄寫的版本號（v1.0.71）比對一下，看看你手上的是不是更新的版本。
2. 到 GitHub releases 頁面找到目前最新的 release，讀一下它的 release note，跟 github.blog/changelog 上同一時間的公告比較看看，體會一下「兩者分工不同」是什麼感覺。
3. 打開互動模式（copilot），打 /usage 看看目前的用量，再打 /instructions 看這次 session 讀到了哪些指示檔。
4. 搜尋 GitHub issues，用「proxy」或「usage」當關鍵字，找一下本附錄提到的那幾個 issue，看看查核之後有沒有新進度、是不是已經修好了。
5. 如果你在公司網路環境使用 Copilot CLI，去查一下你的 proxy 網址是不是 https:// 開頭——官方明講這種 proxy 目前不支援，先確認自己會不會踩到這個坑。

本章官方文件參考

• GitHub Copilot CLI 開發者文件站
• GitHub github/copilot-cli repo
• GitHub releases（版本號真相）
• GitHub 官方 Changelog（跨產品線公告）
• npm 套件頁 @github/copilot
• Copilot CLI GA 公告（2026-02-25）
• 方案與定價比較