GitHub Copilot

GitHub Copilot 是 OAR 一開始就有的供應商：它永遠可用，並使用中繼主機上已登入的 Copilot CLI。中繼會以兩種引擎之一執行它。SDK 引擎是預設，提供導正、背景任務面板和多選提問。擴充功能引擎則在你可以觀看的終端機中執行真正的 Copilot CLI。

使用你自己金鑰的 OpenAI 也在這兩種引擎上執行，所以本頁的引擎章節同樣適用於它。它的金鑰和模型請見 OpenAI 頁面。

你需要什麼 #

• 中繼主機上已登入的 Copilot CLI。 用 npm install -g @github/copilot 安裝，執行一次 copilot 並登入。你的 GitHub 帳戶需要有包含 Copilot CLI 的 Copilot 方案。
• 安裝或升級 CLI 後重新啟動中繼。 中繼在啟動時尋找 CLI 的 runtime，看不到之後才安裝的版本。
• 已登入的 GitHub CLI（gh），供 oar copilot、Windows 上的 擴充功能引擎 session，以及 Check Usage（檢查用量）中的 Copilot 卡片使用。
• tmux（選用，Linux 和 macOS），如果你想用 🖥️ Inspect tmux console（檢視 tmux 主控台）觀看 session 的終端機。

中繼不會安裝或更新 Copilot CLI。在 Settings → Providers → Copilot（設定 → 供應商 → Copilot）中，頂端的 GitHub Copilot CLI 列只會回報它的狀態。

OAR 如何找到 CLI #

SDK 引擎驅動的是 Copilot CLI 隨附的 runtime。啟動時，中繼會在 CLI 的套件快取中尋找，並採用其中最新的版本：

在 Linux 上，如果你設定了 XDG_CACHE_HOME 和 XDG_DATA_HOME，這兩個資料夾會隨之改變。設定 COPILOT_PKG_DIR 可以增加一個要搜尋的資料夾，設定 COPILOT_SDK_PATH 則可以直接指定 runtime 的 copilot-sdk 目錄。如果什麼都找不到，就無法使用 SDK 引擎（見選擇引擎）。

使用 oar copilot #

如果中繼的連接埠上沒有任何回應，oar copilot 會先在背景啟動中繼，然後在你的 shell 中開啟 Copilot CLI（gh copilot）。由它啟動的中繼會在 session 結束時再次停止。-- 之後的引數會傳給 gh copilot。

oar copilot
oar copilot --port 3400 -- --help

每次執行時，它也會在 ~/.copilot/extensions/web-relay/ 中寫入或更新一個小型包裝程式；這是使用者層級的全域擴充功能，負責把 OAR 的擴充功能載入 Copilot CLI。oar copilot --install-extension 只做這件事就結束（不需要 gh）；--no-install-extension 則在單次執行中略過這一步。如果缺少 gh，oar copilot 會告訴你並停止；請安裝 GitHub CLI，或用 oar start 只執行中繼。

兩種引擎 #

兩種引擎顯示相同的對話紀錄、提問卡片、計畫看板、模型清單和每則回覆的用量行。Steer、Queue（加入佇列）和卡住回合的時間窗見回合與佇列；那幾列的說明見中繼模式和壓縮；提問卡片見 ask_user。

在 SDK 引擎上，Stop 只會結束回覆。回合啟動的背景 agent 會繼續執行，並在任務面板中各有自己的 Stop。

選擇引擎 #

這是整個中繼共用的一個設定：Settings → Providers → Copilot → Copilot engine（設定 → 供應商 → Copilot → Copilot 引擎），選項有 Extension（擴充功能）和 SDK — default（SDK — 預設）。變更後請按 Save Copilot settings（儲存 Copilot 設定）。

• 設定會套用到之後才啟動 worker 的對話。已在執行的 session 會保留原本的引擎，直到它的 worker 重新啟動。
• 如果沒有人儲存過選擇，中繼能用 SDK 時就用 SDK，不能時就用 Extension。你儲存的選擇永遠優先。儲存 SDK 也是如此：如果之後重新啟動時找不到 CLI，中繼不會自行切換回去，新對話的 worker 也無法啟動，直到再次找到 CLI 或你儲存 Extension 為止。
• 面板會說明目前設定的是哪種引擎：New Copilot conversations run on the headless SDK worker. No tmux inspector for these sessions. 或 New Copilot conversations run on the Copilot CLI with the web-relay extension.

要判斷執行中的對話用的是哪種引擎，請看它的輸入區和 tmux 主控台。回合進行中，SDK 引擎的傳送按鈕顯示 Steer（當提問卡片或核准開啟、回合正在壓縮或工具呼叫正在執行時，會顯示 Queue），擴充功能引擎則一律顯示 Queue。只有 擴充功能引擎的 tmux 主控台會顯示 Copilot 畫面。對話本身沒有標示引擎。

儲存 SDK 遭拒時 #

如果中繼無法執行 SDK，就會拒絕儲存它，並在引擎說明的位置顯示原因。已儲存的設定不會改變，下拉選單也會回到中繼實際執行的引擎。

設定 #

在 Settings → Providers → Copilot 下：

其他會影響 Copilot session 的設定在別處：

模型 #

中繼啟動幾秒後，會從已安裝的 Copilot CLI runtime 讀取模型清單。每個模型都會顯示 runtime 回報的 reasoning effort 等級和上下文視窗。清單以 auto 開頭，接著依廠商分組（OpenAI、Anthropic、Google、xAI、Microsoft、Azure OpenAI、Moonshot AI，其餘依字母順序），各組中最新的版本排在前面。

在第一次探索之前，新的中繼會提供 gpt-5.4、gpt-5.4-mini（預設）、gpt-5.3-codex、claude-sonnet-4.6 和 claude-haiku-4.5。

在對話的 ⋯ 選單中用 🤗 Select Models → Copilot（選擇模型 → Copilot）選擇哪些模型要出現在輸入區，然後按 💾 Save enabled models（儲存已啟用的模型）。Refresh（重新整理）會重新讀取清單。如果清單看起來過時了，請按 Refresh。

用量 #

• 在回覆下方，Copilot 回合會顯示它用了多少：+N 是點數，括號中是占你每月方案的比例，另有 month N% left。stale 標記表示該回合的數字無法更新。只有 Copilot 回合有這一行；其他供應商（包括 OpenAI）不使用 Copilot 點數。
• 在標題列中，session 行會加總整個對話的用量，例如 Session: 1.25 AIC used。
• 在 Check Usage 中，從 ⋯ 選單開啟 📊 Check Usage，選擇 Copilot 分頁即可查看即時配額（AI 點數或進階請求、對話和方案）。在 SDK 引擎上，它會加上 Last SDK worker turn：該回合實際花費的點數、token 和模型呼叫次數。這些是單一回合的數字，不是累計總數，這個區塊會在七天後消失。

Copilot 卡片透過 gh 讀取你的帳戶。如果你不使用 gh，請在中繼的環境中設定 GH_TOKEN 或 GITHUB_TOKEN。

匯入你已有的 session #

中繼啟動時，會匯入主機上儲存的 Copilot session，讓它們連同歷史記錄出現在你的清單中。它透過已安裝的 Copilot runtime 讀取這些 session。如果無法使用 runtime，匯入會回報失敗。中繼不會從檔案自行推測。

刪除這類 session 只會把它隱藏起來：Copilot CLI 自己的 session 仍會保留，因為它從來不是由中繼執行的。

環境變數 #

在中繼處理程序的環境中設定這些變數，然後重新啟動中繼。

限制 #

• 中繼啟動後才安裝或升級的 Copilot CLI，必須重新啟動中繼才會被偵測到。
• SDK 引擎沒有可以連接的終端機。
• 在 擴充功能引擎上，回合進行中送出的訊息會排入佇列，無法用來導正。
• 在 SDK 引擎上，中繼會在讓回合失敗之前給予以下的靜默時間：沒有任何東西在執行時 2 分鐘、模型請求期間 5 分鐘、工具執行期間 30 分鐘。正在等待提問卡片的回合絕不會被視為卡住。時間窗請見回合與佇列。
• 使用你自己金鑰的 OpenAI 對話也使用這些引擎，但花的是你的金鑰，所以它的回合沒有 Copilot 用量行。

無法正常運作時 #

agent session、中繼模式和其他與引擎無關的行為，都依 session 和 agent 協作相關頁面的說明運作。