第一次使用

第一次接觸 SubLane？建議按分章教程逐步操作，每章會檢查結果。這一頁保留為熟悉流程後的速查清單。

這篇適合負責搭建實例的管理員。準備一個支援的訂閱帳號和客戶端即可，以下以 Codex 為例。

如果你已經拿到成員登入帳號，直接看個人金鑰，從那裡開始。

1. 啟動並登入

已安裝 Docker、Compose、Bash、curl 和 jq 後，執行：

curl -fsSL https://raw.githubusercontent.com/murongg/SubLane/main/scripts/install.sh | bash -s -- --runtime docker --proxy none

腳本會創建 ./sublane，不會覆蓋已有目錄。執行前可以先查看腳本。

打開 127.0.0.1:8080，按引導建立管理員並為第一個工作空間命名。已有實例就使用它的位址，跳過安裝。在遠端伺服器部署時，先透過 SSH 隧道存取初始化頁面；向團隊開放前，再按部署文件設定網路和 HTTPS。

**完成標誌：**能登錄，並開啟「訂閱帳號」頁面。

2. 接入一個訂閱帳號

在「訂閱帳號」新增 Codex 帳號，選擇瀏覽器授權。授權後，將瀏覽器網址列中完整的 localhost 回呼位址複製回 SubLane。此時瀏覽器顯示 localhost 連線失敗是正常的，仍然複製該位址即可。

點選「驗證連線」，再開啟「模型」確認可用模型 ID。如果使用憑證文件，按帳號接入中的導入步驟操作。

**完成標誌：**帳號已啟用、連線驗證成功，模型清單中有你準備使用的模型。

3. 把帳號放進資源群組

開啟「資源群組」，建立一個容易辨認的池，勾選剛接取的訂閱帳號並儲存。這個池就是金鑰可以使用的訂閱帳號集合。

新帳號最初是“未分配”，需要這一步驟才能用於金鑰；系統不會自動建立預設池。首次接入先保持模型權限不限。

你目前以管理員登錄，可以直接使用這個啟用的池，不必先新增成員授權。稍後分享給成員時，再按成員與授權操作。

**完成標誌：**池中包含剛接入的已啟用帳號。

4. 建立個人金鑰

開啟「API 金鑰」，建立金鑰、填寫名稱、選擇剛建置的資源群組，再複製金鑰。沒有特別的有效期限要求時，保留預設值即可。

這是 SubLane 的網關金鑰，與訂閱帳號的憑證不同。這裡不需要創建用量分配，也不需要填寫比例或模型價格。

**完成標誌：**你已拿到個人金鑰，以及該池中一個可用的模型 ID。

5. 連接客戶端，發送訊息

開啟金鑰的配置指南，按 Codex 使用者端配置操作：填寫以 /v1 結尾的實例位址、個人金鑰和池中可用的模型 ID。本地實例的位址是 http://127.0.0.1:8080/v1。

在客戶端發送一條簡單訊息，確認收到回复，再到 SubLane“請求記錄”中找到這次調用。僅登入成功或看到模型列表，還不能說明產生請求已跑通。

**完成標誌：**客戶端收到模型回复，請求記錄中能看到這次調用。現在就可以正常使用了。

哪一步沒成功，就查哪一步

用起來後，再按需繼續

要讓同事一起用，再看成員與授權；要看調用和消耗，再看日常使用。額度分配和其他高階控制都不是開始使用的前提。

點擊頁面右上角的 存取引導，可隨時開啟或重新查看浮層引導，完成首次呼叫後該入口仍保留。尚未完成存取時，概覽也會顯示 開始分步引導。它會在訂閱帳號、資源群組和金鑰頁面高亮真實操作入口，後台確認完成後才解鎖 下一步。支援 上一步 和 跳過引導（也可按 Escape）；重新開啟時從目前工作空間的實際進度繼續。同一瀏覽器標籤頁刷新後可恢復進行中的引導，狀態依登入使用者和工作空間隔離。

開啟授權、資源群組、金鑰或使用者端設定彈跳窗時，浮層會暫時隱藏，避免遮擋表單或提前關閉新金鑰的複製介面。每個個人金鑰都有設定指南，可選擇該金鑰允許的模型。只有當前工作空間記錄到你的一次成功生成，最後一步才會完成；檢視模型或建立金鑰不會取代實際呼叫。