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