AI 供應商與金鑰
安裝 AI 工具、連結帳號、測試回答,並管理更新。
選擇供應商
「設定 > 供應商」支援 Anthropic、OpenAI、OpenAI-compatible 端點,以及 Claude Code、Codex 和 Antigravity 本機工具。VStudy 不附帶 AI 訂閱。可在設定畫面展開工具選擇說明,比較帳號需求。
Claude Code 需要具有使用權的 Anthropic 帳號。Codex 使用 ChatGPT 帳號,免費與付費方案額度不同,API 另外計費。Antigravity 使用符合資格的 Google 帳號與供應商提供的免費或付費額度。優惠與資格可能變更,付款前請確認供應商規則。
本機工具預設關閉。同意前只檢查已安裝檔案,不會啟動。執行檔變更後需要重新確認。可保留現有安裝,或選擇由應用程式管理的版本。
安裝、登入與測試
從側邊欄的「AI 工具」、首次導覽、閱讀器或「設定 > 供應商」開啟設定。醒目的步驟會顯示目前位置與接下來的結果。只需允許你想用的工具。
內建安裝必須在執行前獨立驗證下載來源。Claude 使用發行者簽章;macOS Codex 0.166.0 使用應用程式內固定的檔案驗證值。Antigravity 會顯示「其他安裝方式」與原因。請在自己的終端機執行官方指令,再到「設定 > 供應商 > 變更」選擇程式。
內嵌終端機只執行你已確認的操作。在 macOS 上,依照畫面中的連結或裝置代碼登入,再回到 VStudy。開啟外部連結前會要求確認。無法使用內嵌登入時,可選擇「在自己的終端機開啟」或複製指令。外部終端機選項只會複製指令,請自行貼上並執行。
- 安裝。確認官方下載與專用目的地後,選擇「執行此計畫」。VStudy 會驗證下載,不需要管理員密碼,也不修改 PATH。
- 登入。確認操作後選擇「執行此操作」,再依帳號指示完成。已登入時可使用「查看帳號狀態檢查」。
- 測試。選擇「測試看看」。VStudy 會透過真實供應商傳送一小段問題並顯示回答。不包含文件文字,但可能計入用量。
更新不中斷聊天
側邊欄的「AI 工具」顯示版本與更新狀態。「立即檢查更新」會進行一次網路檢查。「設定 > 隱私權」中的背景檢查與「閒置時自動更新」預設關閉。背景檢查會快取結果,通常每四小時最多進行一次。
無法獨立驗證的版本會顯示「有新版本,請自行安裝」與供應商連結,不會自動下載執行。關閉任一更新選項或取消允許供應商,會中止尚未完成的自動更新。
選擇可用更新並確認計畫。VStudy 會另外下載、驗證新版本。進行中的聊天繼續使用目前程式,新聊天才使用更新版。畫面會說明更新適用於新聊天,也可確認還原至保留的前一版。
VStudy 只更新自己管理的版本。若偏好既有安裝,可在「設定 > 供應商 > 變更」選擇。其他安裝方式提供只供複製的官方指令;供應商安裝程式使用自己的資料夾。版本資料檢查與下載會列在隱私權的網路活動中。
步驟需要協助時
先閱讀目前步驟的提示。離線時可重新連線再試。若學校政策、防毒軟體或權限阻擋安裝,可複製「需要老師或資訊人員協助嗎?」中的求助文字。內建安裝不需要管理員權限。
瀏覽器未開啟時,可使用顯示的登入連結與代碼。登入過期後需重新執行登入。「查看帳號狀態檢查」可確認既有帳號,不會傳送聊天。不支援的 Codex 版本需要改用已驗證的內建安裝版本。
關閉設定或重新載入視窗會停止該設定操作,仍可繼續閱讀。「進階」的一般 shell 為選用功能,預設關閉,因為它能以你的帳號權限執行程式,需要額外確認。一般設定不需要它。
儲存金鑰或僅供本次使用
只有明確儲存或解鎖時,API 金鑰才會透過 macOS 鑰匙圈加密。此時可能出現鑰匙圈提示,包含重新建立臨時簽署組建後。開啟視窗不會等待金鑰解密。
重新啟動後,需先解鎖已儲存的金鑰,才能探索模型。若拒絕存取,可重試或選擇不儲存金鑰,僅於目前程序保留。請勿將金鑰貼入聊天、截圖或問題回報。
供應商會收到什麼
已啟用的供應商會收到你的問題、對話記錄、文件中繼資料與選取文字。未選取時,提示包含大綱與開頭節錄。先前選取的文字可能留在對話背景中。
本機工具使用自己的登入,也可能連線至自己的模型探索、驗證、額度、聊天或遙測服務。VStudy 會要求 Claude 停用非必要流量與遙測,但不保證 CLI 不會發出其他請求。
Codex 相容性
此版本將已登入的 Codex CLI 限定為 macOS 上的 0.166.0,並使用 /usr/bin/sandbox-exec。內建安裝使用此版本。快取的驗證會確認不使用工具的聊天傳輸。不支援的版本或驗證失敗時會停止傳輸。
此傳輸停用原生工具並禁止建立子程序,但不是針對遭入侵 CLI 的完整檔案系統或限定端點網路沙盒。修改指定版本前,請先閱讀儲存庫中的 Codex 傳輸文件。