# 從 Host 準備完成走到一個有用的 Session。

開始使用

依照手機優先的單一路徑操作，同時明確辨識 Host identity、瀏覽器路徑、選定資料夾與完成回覆。

Oysterun 是 Beta 軟體。提供者、作業系統與 Host 是否支援，取決於目前設定；這條路徑只證明你現在實際確認的選項，不構成路線圖承諾。

1. 準備必要條件 在將要擁有 Host 的電腦上，使用目前支援的 macOS 或 Linux 環境，並準備 Node.js 20 以上版本與 `npm`。開始前先確定明確由任務擁有的非正式環境 Host，以及精確的專案資料夾。若目標是共用或正式環境、Host identity 出乎預期、瀏覽器顯示安全警告，或資料夾仍有歧義，立即停止。
1. 安裝並確認 Oysterun 使用 `npm install -g oysterun@latest --prefer-online` 安裝目前公開 Beta，再執行 `oysterun --version`，並在設定前記錄回報版本。只有在指令與版本正是你預期使用的 release 時才繼續；不要把未發布 build 或未來日期當成已提供的產品。
1. 確認提供者就緒 替將要執行 Host 的同一位作業系統使用者，安裝並登入目前 Host 支援的提供者。這條路徑使用 Codex：先在 Host 上開啟 Codex，確認它能針對精確的專案資料夾回覆，再進入 Oysterun。若出現登入、信任、model 或 readiness 警告，請停止處理，不要假設所有提供者或設定都能運作。
1. 完成 Host 引導設定 在精確、由任務擁有的非正式環境 Host 上執行 `oysterun`，或以 `oysterun setup` 重新開啟設定精靈。依序完成七項引導選擇：Host 名稱、Default Browse Root、Host 密碼、Managed connectivity、telemetry 與隱私、手機 App，以及 Start Host。若設定流程提供 restart，先保護進行中的工作、再次確認該任務 Host，並依其已接受的非正式環境任務 lifecycle 執行。若目標為共用、正式環境或身份不明，立即停止。
1. 對照新的 QR 與 Host URL 等到設定流程回報 Host 已啟動，再把 Host 名稱及目前 URL，與同一個 Host 當下顯示的新 QR 相互核對。把 QR 或 bootstrap token 視為暫時密碼：不要公開或保存、不要重用舊截圖；舊 QR 過期時，以 `oysterun show-qr` 產生新的 QR。即使 URL 已保存，仍須通過目前的 Host 登入路徑並使用目前 Host 密碼；不要假設舊 QR 或已存密碼仍然有效。
1. 從手機與瀏覽器開啟同一個 Host 在手機上掃描該張新 QR，或輸入畫面顯示的精確 Host URL 與目前 Host 密碼；再於一般瀏覽器開啟完全相同的 Host URL。手機與瀏覽器只是連到同一 Host identity 與相同 Session 狀態的兩個 Client，不是兩個 Host。若任一 Client 顯示不同 identity、非預期網址或安全警告，立即停止。
1. 從目前登入路徑進入 使用 Host 目前只有密碼欄位的登入畫面；裝置配對與通知權限都不能取代 Host 驗證。可見的成功檢查點，是抵達剛才已核對 Host 的 **Sessions** 頁面。頁面可連線只證明路徑可達，不代表提供者 Session 已經能完成工作。
1. 建立一個範圍受限的 Codex Session 從 **Sessions** 開啟新的 **Session Setup**；只有在 Codex readiness 狀態仍為目前資訊時才選擇 Codex，填入容易辨識的 Agent ID 與 Session Name，並選定精確的 **Start Folder**，作為這個 Session 使用的 Agent Folder。啟動 Session 後，傳送這段已審查 prompt：只讀取目前資料夾。回覆資料夾名稱，並用一句話說明其中內容。不要編輯、建立、刪除、移動、重新命名或執行任何檔案。若選定的提供者或資料夾與先前審查內容不同，立即停止。
1. 等待完成回覆 **Connected**、可連線的 Chat，或 **Working** 指示都不是完成答案。等到工作中狀態消失，且提供者的 final response 已清楚顯示。這個有限檢查點，是回覆能說出選定資料夾名稱，並描述其中目前內容，而不要求修改；登入、核准、tool 或 readiness 警告，以及仍在工作的 turn，都是尚未終止、應先停下處理的狀態。
1. 辨識並回到 Session 記錄 Oysterun 顯示的 Session Name 與穩定 identity。離開 Chat、回到 **Sessions**，再開啟同一列；繼續前先確認 Agent ID、精確資料夾與先前回覆都相同。這是返回既有 Session 的路徑；已能辨識該 Session 時，不要另外建立重複 Session。