【2026 最新】Corgi 教學：兩個 Agent 怎麼切換？SSH 貼圖與 Detach 五步練習

你同時開著兩個 AI 工作視窗：一個還在忙，另一個早就停下來等你回答。切回去時，又忘了剛才那張圖片貼進哪一個對話。這篇 Corgi 教學要解決的，就是這種「工作不難，顧視窗很累」的時刻。

Corgi 是把多個終端與 Agent 放進同一個畫面的管理工具。本文專為剛接觸終端的新手寫；你需要已有一個能登入使用的 Agent 工具，接著用兩個小任務練習狀態切換、圖片核對與離開後重連。以下依 2026 年 10 月 25 日的官方文件與程式碼整理，SSH 圖片交付採驗收練習，未在本文執行端到端測試。

先說結論：看狀態、對收件人、再確認工作還活著

• F1 是「找需要你注意的人」：在 Corgi 快捷鍵預設中，優先跳到等待回答的 Agent，再處理已完成但未讀的結果。
• SSH 貼圖要核對整條路：本機剪貼簿、外層終端、遠端 Corgi、目標 Agent，各有一關。官網為這項功能標註 Ghostty Nightly 前提。
• Detach 是離開觀看介面：runtime 留在執行它的主機。主機重開機後的恢復，是另一種流程，不能當作原程序始終持續運作。

一句話把手：Corgi＝工作櫃台＋注意力佇列＋可離開的觀看視窗。Agent 才是做事的人；Corgi 幫你看誰在忙、誰舉手，以及回到哪張桌子。想先補上 Agent 與執行層的分工，可搭配 Agent Harness 白話入門。

一、Corgi 教學先拆四個零件

先認四個英文：workspace 是放工作用的資料夾與分頁集合；tab／pane 是分頁與其中的分割區；Agent session 是某個工具的對話；runtime 是背景維持這些工作的執行環境。觀看介面像監視螢幕，關掉螢幕與停止機器，是不同動作。

依 官方活動說明，Working 指正在跑一輪工作；Needs input 指等待答案或核准；Unread 指已有一輪完成，但你還沒確認讀過。這些是分開的觀察，一個 Agent 開始新一輪，也可能仍留著前一輪的未讀結果。完成一輪，不等於整個 Agent 程序已結束。

把滑鼠停在 Agent 上，可以看活動、用量與背景命令。看見 ≥ 代表用量覆蓋不完整；這些數字幫你找方向，並非完整帳單。官方也說 Clever Corgi 的摘要、工作樹簡介與 Smart Links 會使用供應商登入並消耗模型用量。先把「介面觀察」與「模型消耗」分開，你才知道省下的是注意力還是費用。

二、Corgi 教學五步練習：先在兩張練習桌上開工

①「先認門」：核對平台、版本與快捷鍵

截至查核日，官方 README列出的安裝目標是 macOS Apple Silicon 與 Linux amd64；官網另列 WSL。新手先從這兩種預編譯架構確認自己的環境，不要把作業系統名稱直接當成所有晶片都適用。已有安裝者，先記下 corgi --version，再用 corgi update status 比較已安裝與正在執行的版本。

新安裝可先下載並閱讀官方腳本，再決定執行。下面與 README 的腳本來源相同，只把下載與執行拆開；這一步會在你的環境安裝程式。

curl -fsSL https://corgi.computer/install.sh -o /tmp/corgi-install.sh
less /tmp/corgi-install.sh
bash /tmp/corgi-install.sh

安裝完成後開一個新終端，先跑 corgi --version 確認 PATH 已生效。第一次啟動選 Corgi 快捷鍵預設，prefix 選 Ctrl+B。prefix 的按法是先按 Ctrl+B、放開，再按下一鍵。接著按 prefix ? 看實際鍵位；本篇 F1、prefix c 與 prefix q 都依這組設定。若 F1 被筆電拿來控制亮度，先用 prefix f。

②「分兩張桌」：建立資料夾，再各開一個 Agent

在一般終端輸入下面三行。家目錄符號 ~ 代表你自己的使用者資料夾；這裡只建立空的練習位置。

mkdir -p ~/corgi-practice/agent-a ~/corgi-practice/agent-b
cd ~/corgi-practice
corgi

按 prefix c 開啟選擇器，選 New terminal。第一個 shell 輸入 cd ~/corgi-practice/agent-a，再執行你原本已裝好、已登入的 Agent 命令。再開第二個 terminal，切到 ~/corgi-practice/agent-b，啟動同一種工具即可。官方支援的整合包含 Claude Code、Codex、Pi 與 OpenCode；不需要為這次練習同時註冊四種服務。

依 官方啟動說明，選擇器也能直接啟動 Agent。先用 shell 明確切目錄，是為了讓新手看清兩張桌子的地址。保留 YOLO 關閉；Corgi 會接入各工具的整合設定，Codex hooks 另需在該工具的 /hooks 信任一次，新裝 hooks 要開新 session。這些都應先讀清畫面再核准。

③「一人舉手、一人交卷」：練習三種狀態

給 A 這段話：這是 CORGI-A 練習。先確認目前資料夾，然後只問我一個問題：要整理哪一類筆記？問完等待回答，不要修改檔案。給 B：這是 CORGI-B 練習。先確認目前資料夾，再列出整理讀書筆記的三個步驟；只回文字，不修改檔案。

觀察 B 產生回覆時的 Working；讓 A 停在問題上，暫時切到 B。再按 F1，核對它帶你去哪裡。驗收要看對話內容，不能只看圓點顏色。A 仍應顯示那個待回答問題；B 的已完成回覆應能讀到。官方定義等待答案或核准都可成為 Needs input，但不同工具的事件與整合狀況會影響觀察，這段提示詞不是強制狀態的測試 API。

若等不到預期標記，先用 corgi integration status 看整合；查看安裝位置可用 corgi which codex 或對應工具名稱。不要為了讓燈號變漂亮，讓 Agent 執行刪檔或繞過權限。F1 會確認你已看過注意力項目，不會代替你回答 Agent。

④「貼圖對收件人」：SSH 要同時驗證路徑與內容

先做本機版本：自己建立一張無私人資訊的圖片，畫上紅色三角形與識別字 CORGI-731。只複製圖片內容，不是複製檔案路徑。把焦點放到 A 的輸入區後貼上，再請 A「說出圖片中的識別字、顏色與形狀」。核對三項答案，同時確認 B 的對話沒有收到這張圖。

接著才把同一張圖片用在 SSH。官方網站為 SSH 圖片貼上標註 Ghostty Nightly；目前 程式的能力診斷也將遠端圖片剪貼簿的可用條件限定到 macOS 上的 Ghostty Nightly。本篇這一段以該本機組合為起點，遠端主機另需具備可用的 Corgi 與 Agent。

用 ssh -t your-host corgi 連線，其中 your-host 換成你原本有權登入的主機。此時鍵盤前的 Mac 負責剪貼簿，遠端主機執行 Corgi 與 Agent。在遠端重新準備 A／B 練習對話，明確點到 A，再按 ⌘V、提交問題並核對三個答案。看到圖片縮圖或一段路徑，只證明走到其中一站；正確 Agent 能讀出內容，才是這次交付的驗收。

失敗時開 Corgi setup → Terminal capabilities，依提示分別查終端能力、tmux 干擾與剪貼簿權限。先在未經額外 tmux 包裝的連線縮小問題，再加回既有工作流。記下本機終端版本、遠端 Corgi 版本、是否經過 tmux、目標 pane 與實際回答，才能分清「沒送到」和「送到了但看不懂」。

⑤「先離席再回來」：Detach 後核對同一主機

先在另一個 shell 分頁跑一個不使用模型的短工作。它會印出識別字與 PID（作業系統給程序的編號），等待 60 秒，再印完成字樣：

sh -c 'echo "CORGI-PROBE-731"; echo "PID=$$"; sleep 60; echo "CORGI-PROBE-DONE"'

離開前在另一個 shell 執行 corgi list，記下 workspace 與 pane ID，再用 prefix q Detach。稍後在同一主機、同一使用者與同一 runtime 設定執行 corgi；SSH 情況則重新使用剛才那條 SSH 命令。核對 ID、舊輸出與完成字樣。你在 60 秒內重連可能看見工作還在等；更晚回來則看見完成，兩者都要與時間對照。

依 官方重連與恢復說明，Detach 或連線中斷會把 runtime 留在該主機。一般由 pane 啟動的程序，關閉分頁或 pane 會結束；若連接的是供應商既有背景 session，生命週期另依該工具處理。要保留這次練習，使用 Detach。若你其實連到另一台機器、換帳號或指定另一個 socket，就不是同一個觀看位置。主機崩潰或重開機後，官方描述的是恢復已存版面、輸出與休眠的已記錄 Agent，聚焦後再續接；其他 pane 會開新 shell。任意程序的記憶體不會因此原封不動回來。

三、何時保留 tmux／Herdr？先用自己的任務決定

如果你已經熟悉 tmux，而且主要跑 shell、伺服器與簡單命令，先用 Corgi 的小練習確認活動提示是否真能減少切換。若你常同時顧多個 Agent，尤其容易漏掉待回答問題，Corgi 的注意力佇列與整合用量更值得試。本文不替兩者排速度或穩定性名次。

也不要把「匯入」一律理解成搬走正在跑的工作。官方說 tmux 匯入主要帶入資料夾、名稱、版面與最近輸出，原程序留在 tmux；Herdr 的 copy 與 handoff 則是兩條不同路，後者需相容支援並移轉 session 所有權。第一次先跳過匯入，用空練習區熟悉後再看預覽。工作區隔離可以延伸讀 Proliferate 與 Worktree 教學；Corgi 的狀態燈不能替代檔案隔離。

用量與資源也要分開讀。CPU／記憶體回答本機忙在哪裡；模型用量回答供應商回報了多少。遠端或容器程序可能不完整歸入工作區，不能把沒顯示讀成零。若電腦越跑越慢，可接著用 Mac 多 Agent 記憶體排查檢查程序與測試 Worker，先減少同時開工再談加硬體。

四、常見問題：八個直接答案

1. Corgi 會替我提供模型嗎？

它是管理工具。Agent 仍用自己的安裝與登入；摘要等模型功能也會消耗供應商用量。

2. F1 就是依序切下一個分頁嗎？

不是這個用途。在 Corgi 預設中是 Jump to attention，優先處理等待項目，再到完成項目；其他預設請用 prefix ? 核對。

3. Finished／Unread 代表程序已退出嗎？

不代表。完成的是一輪對話，Unread 還涉及你是否已讀；程序退出是另一個事件。

4. 文字貼上成功，圖片就一定成功嗎？

要分開驗。圖片涉及終端能力與剪貼簿權限；讓目標 Agent 讀出測試字、顏色與形狀再驗收。

5. SSH 貼圖成功，等於跨機同步嗎？

這次只驗證圖片從本機交給指定遠端對話。跨主機搬移或同步 session 是另一個命題，這份測試不替它作證。

6. Detach 後筆電關機，工作會一直跑嗎？

先問工作在哪台。若 runtime 在遠端主機，查看端離線與遠端關機不同；若執行主機本身重開機，就要按恢復流程核對，不能期待原程序記憶體持續存在。

7. 我可以先把所有舊 tmux session 匯入嗎？

先看預覽並做一個小工作區。匯入版面與轉移活程序有不同條件，第一次練習選 Skip import 更容易確認每個動作。

8. 用量看起來少了，就算省錢成功嗎？

還要對帳。局部覆蓋、快取與回報延遲都會影響畫面；同時記錄完成任務與供應商用量，才有可比較的結果。

給新手的三個重點

• 先看人：A 在等什麼、B 完成什麼，回到對話內容確認。
• 再看路：圖片貼到哪個 pane，哪個 Agent 讀出了什麼。
• 最後看主機：Detach 留下哪個 runtime，重連核對哪個工作。