設定 AI 服務

設定 AI 服務

Hyday Agent 需要連上一個你可以使用的 AI 服務，才能協助你搜尋資料、整理筆記或完成其他工作。你可以使用電腦上的 Claude Code CLI、Codex CLI 或 Antigravity CLI，也可以選擇在自己的電腦上執行 Ollama 或 LM Studio。

開始前先準備好

CLI 是可以在終端機執行的工具。選擇 Claude Code、Codex 或 Antigravity 時，請先安裝對應的 CLI 工具並完成登入；選擇 Ollama 或 LM Studio 時，請先啟動本機服務，並準備好要使用的模型。

如果你平常使用 Claude 或 ChatGPT 的網頁版、手機 App，第一次在 Hyday 使用時，只要依照選好的服務完成對應工具的安裝與登入，就能讓 Hyday 順利連線。不同 AI 服務的計費方式不一樣，請以你選用服務的說明為準；Hyday 會在需要時於工作開始前提示可能產生的使用成本，讓你先確認。

在 Hyday 裡完成設定

1. 開啟 Hyday 的「設定」，找到 Hyday 區塊裡的「思考引擎」。
2. 在「來源」選擇想使用的服務。使用 Claude Code、Codex 或 Antigravity 時，請先確認 Hyday 已偵測到工具；使用 Ollama 或 LM Studio 時，請先啟動本機服務。
3. 在「模型（選填）」選擇模型。有模型清單時可以直接選擇；如果暫時讀不到清單，也可以輸入服務裡顯示的模型名稱，再按「測試」。不指定模型時，Hyday 會使用該服務的預設模型。
4. 按「測試對話通道」，確認 Hyday 可以啟動連線並取得模型資訊。這個檢查只是在確認連線，不會送出對話內容，也不會消耗模型用量。
5. 測試通過後，就可以回到對話或其他 AI 功能。Hyday 會在需要時說明要讀取的資料、可以使用的工具、是否會寫入檔案，以及可能產生的費用，讓你確認後再繼續。

如果模型清單暫時沒有出現，可以先確認本機服務已啟動，或手動輸入服務顯示的模型名稱，再按「測試」。

找不到 AI 工具時怎麼辦？

如果「來源」顯示未偵測到，可以先確認工具已安裝並完成登入，再按「重新偵測 AI 來源」。使用 Ollama 或 LM Studio 時，請先開啟本機服務，再回到 Hyday 重新偵測。

如果工具已經安裝，但 Hyday 還是找不到，可以在設定頁展開「自訂 CLI 路徑」，貼上工具的完整路徑後，按下儲存並重新偵測。

macOS 可以在「終端機」輸入下面的指令，查找對應工具的位置：

command -v claude
command -v codex
command -v agy

Windows 可以在 PowerShell 輸入對應指令：

(Get-Command claude).Source
(Get-Command codex).Source
(Get-Command agy).Source

如果指令也找不到工具，請依照該工具的安裝說明完成安裝或登入，再回到 Hyday 重新偵測。

AI 會讀取和修改哪些資料？

Hyday 會在你的電腦上使用你選擇的 AI 服務。完成設定後，AI 不會自動讀完整個筆記資料夾；需要讀取或寫入時，會依照功能設定與畫面上的流程處理。

需要確認的工作開始前，Hyday 會在畫面上說明資料來源、可以使用的工具、寫入範圍或可能產生的費用，讓你看過後決定是否繼續。原始筆記與日誌預設不會在你不知道的情況下被改寫；需要寫回時，會依照該功能的確認流程處理。

設定頁的「略過檔案變更確認」如果開啟，對話頁和側欄會直接套用檔案變更，不會每次再詢問。剛開始使用時，建議先保持關閉，熟悉流程後再決定是否開啟。

想了解資料會放在哪裡，請閱讀資料落點與 AI 邊界；想知道 Hyday Agent 能做什麼，請閱讀Hyday Agent。