Kav-FastwebAgent開始使用

從第一個
常做的查詢開始。

準備好環境後，把需求交給 Claude Code。你要做的是看結果對不對。

先認識幾個名詞

這個專案會一直提到下面幾個名字，先用一句話說清楚它們各自是什麼、誰做什麼事。

名詞是什麼
Kav就是這個專案（全名 Kav-FastwebAgent）：裝在你 Mac 上的工具。它把你常做的網頁查詢存成一份「流程」，之後用專屬的 Chrome 自動做完，結果由程式核對過才交給你。它不會登入、不會付款、不會幫你過驗證碼。
Claude CodeAnthropic 的 AI 助手（在終端機裡用的版本）。你用平常說話的方式跟它溝通；它負責把你的需求寫成流程、網站改版時修流程，以及回答需要判斷的題目。Kav 是給它用的工具。
流程Kav 存下來的一份固定做法：哪個網站、填什麼、按哪裡、怎樣才算真的查到。建立時由 Claude 寫、試跑給你確認；之後說一句話就能重跑。內部是一個 JSON 檔，你不需要看它。
Kev選配的本機小模型（約 40 億參數，跑在你的 Mac 上、不連網）。只在「從一串列表裡挑哪一筆」這種簡單判斷題時派上用場；沒有安裝也能用 Kav，判斷題會交給 Claude 處理。
JevKev 的同系列、放在雲端、比較大的模型。這個專案的評測拿它當對照基準，看 Kev 在本機能做到幾成；Kav 本身執行時用不到它。

先確認適不適合

目前已實測的環境是 Mac、Google Chrome 與 Claude Code。高鐵、匯率抓資料由本機程式完成，不需要模型。判斷題把抓好的文字交給 Claude；Kev 是選配。

原始碼在 GitHub。github.com/kaiwutech-TW/kav-fastwebagent（MIT 授權）。先 git clone 下來，再依下方步驟啟動；安裝細節與三種語言的說明在 repo 的 README。

本機啟動方式

  1. 先安裝 Chrome 與 uv。
  2. 在 Kav 專案目錄執行 uv sync。
  3. 在同一個目錄開啟 Claude Code，核准專案的 kav-fastweb MCP 設定。
  4. 說「kav 的狀態」，確認工具可用。Chrome 會使用 Kav 的專屬設定檔。

Kev 是選用元件；現有比價實測使用 Apple Silicon、36GB 記憶體與 Kev-4B。Kev 的安裝與啟動方式見本機專案 README。

把這段貼給 Claude Code

先選擇一個公開、可重複查詢的網站。用「會換什麼」與「怎樣才算對」說明，比只說「幫我查一下」更清楚。

幫我做一個流程：
網站：台灣高鐵時刻表
每次會換的：出發站、到達站、日期、時間
我要看到的結果：車次、出發時間、抵達時間
怎樣算對：站名和日期正確，每一欄都能對回官網。

Claude 試跑後會給你看結果。對了就說「對」，存成流程；不對就指出少了什麼或哪裡讀錯。

不容易用說的？示範一次

先對 Claude 說「我示範給你看」。這特別適合不容易描述操作的網站；如果 Claude 已能直接寫好流程，就不必每次都錄製。

  1. 在 Kav 開好的 Chrome 分頁，照平常方式完成一組真實查詢。
  2. 按「標記結果」，點選你要的整塊資料，再按「完成」。
  3. Claude 把示範整理成流程，在乾淨環境重播，核對結果與你標記的內容是否一致。
  4. 核對通過後，確認結果才儲存；以後再用新條件執行。

目前高鐵單頁示範已通過真人驗收；多步驟與用示範修流程仍待真人驗收，已於 2026/10/07 暫停；591 示範發現的轉換缺口尚未修復。錄製限同一個分頁，不支援新分頁、iframe 內操作或敏感資料輸入。查看實際驗收過程。

之後，像平常一樣說話

想做什麼可以這樣說
換條件查詢查 10/20 新竹到台南，早上九點以後的高鐵。
修正結果結果不對，我要看的是抵達時間。
查看流程我有哪些流程？
移除流程刪掉這個流程。

你可能也想知道

一定要有高階電腦嗎？

不需要 Kev 的高鐵、匯率流程，只需能執行 Chrome 與 Claude Code 的 Mac。判斷題可以交給 Claude，不必為此安裝 Kev。既有比價流程使用 Kev；若選用本機模型，才需要考慮它的硬體需求。

Windows 或 Codex 可以用嗎？

Kav 是 MCP 工具，專案已有相關設定說明，但 Windows 與 Codex 的使用路徑還沒完整實測。這裡不把它們列為已驗證安裝方式。

網站需要登入怎麼辦？

你可以在 Kav 專屬 Chrome 自己登入。Kav 不會代填密碼、不會解驗證碼，也不會為了網站擋自動化而嘗試繞過。

資料全部都在本機嗎？

Chrome 操作、流程執行與程式驗證在本機，Kev 也在本機。Claude 仍可能在雲端處理需求和工具結果，因此「本機執行」不等於「資料完全不離開電腦」。