Lantide Data
← 返回部落格
與 Lantide 整合

使用 Claude Code 與 Codex 做數據分析時，為什麼還需要 Lantide？

Claude Code 與 Codex 擅長在終端機調度長任務與 MCP 工具；若分析必須留下可審閱 SQL、Plan 與 Report，可把 Lantide 當本機 MCP host，用 Access Mode 與 Approve & Execute 守住執行邊界。

你已經能用 Claude Code 或 OpenAI Codex 在終端機跑長任務、呼叫 MCP、草擬 SQL。卡住的通常不是「Agent 夠不夠聰明」，而是結論要進週會、被追問口徑或三週後重跑時，聊天紀錄裡找不到可審閱的 Plan、SQL 與 Report。把 Lantide 設成本機 MCP host，外部 Agent 繼續負責推理與調度，正式執行權、工作區邊界與交付物則留在可回看的 GUI。

怎麼分工

你用它做 Claude Code / Codex Lantide
長任務拆解、程式與 SQL 草擬 擅長 不是定位
透過 MCP 呼叫工具 擅長 作為被連入的本機 host
本機 DuckDB 查詢與分頁快取 需另接執行環境 內建
Plan → Approve & Execute → Report 對話裡難留下完整契約 內建
Activity／audit 回看 依 client 而定 內建

一句話：外部 Agent 當大腦與調度器；Lantide 當數據執行與審閱面。 連線步驟見 External Agent Integration 與 USER_GUIDE §13。

只在 Terminal 做正式分析，容易碰到什麼

1. 中間過程捲走了

分析交付物是一組可交接的 artifacts，不是一次文字回答。CLI 裡的暫存表、過濾條件與臨時數字，常隨輸出往上滾。當業務問「23% 有沒有排除退款？」你需要能重開的 SQL、Plan 口徑與 Report limitations。見 可重現的 AI 分析。

2. Schema 一次塞太多

把上百張表的完整 DDL 灌進對話，會擠壓 context，也讓每輪重複帶多餘結構。實務上較省事的做法是：先給表名與摘要，需要時再按表讀 schema。Lantide 作為 MCP server 時，外部 Agent 可以用工具與資源按需探索。

3. Host 側權限之外，還要管工作區能力上限

Codex 提供 sandbox mode 與 approval policy；Claude Code 可用 HTTP／streamable-http 連到帶 header 的 MCP server。這些管的是 Agent host 側行為。分析還需要另一層：這條連線在資料工作區裡最多能做什麼。MCP 標準化連線方式，本身不會幫你設好最小權限。見 MCP 五層防線。

接到 Lantide 之後多了什麼

Access Mode 與工作區範圍

在 Lantide 右上角開啟 Agent Integration，啟用 Enable MCP server，再建立 Quick 或 Persistent connection。Access mode 是這條 connection 的能力上限：

Mode 可以做什麼 適合情境
Observe 唯讀工作區脈絡與 artifacts 第一次評估、陪同檢視
Execute 建立分析 artifacts；正式執行仍受 Plan review 與 evidence 約束 單一工作區的正式分析
Admin Execute 加上高信任的工作區／專案／知識整理 已信任 Agent、需要它協助整理環境

Access mode 不會因 Plan 進入 Executing 而自動升級；Approve & Execute 只核准該份 Plan 的執行範圍。見 USER_GUIDE §13.5。

Plan 核准與可回看證據

採 Execute 雙開時，外部 Agent 可起草 Plan 與 SQL，你在 Lantide GUI 審閱後按 Approve & Execute。之後可回看 SQL 分頁、Steps、Report、External MCP Activity 與 audit。

複雜 SQL 會提示你拆步

對過複雜的查詢，Lantide 會發出拆步與優化提示，方便把多表 JOIN 落成可審閱分頁與 Source Run 鏈。這是查詢治理，用來提高可讀性與可重跑性；越權動作仍靠 Access Mode、工具政策、Plan 核准與本機 loopback credential 管理。

怎麼接到 Claude Code 與 Codex

以 Lantide Agent Integration 畫面複製的 connection kit 為準，不要手寫 port、path 或 token。MCP host 綁定本機 127.0.0.1，credential 只貼到你信任的本機 client。

Claude Code（HTTP／streamable-http）：

claude mcp add --transport http lantide-data <從 Lantide 複製的 URL> \
  --header "Authorization: Bearer <從 Lantide 複製的 token>"

也可把 GUI 複製出的 JSON 寫入專案或使用者設定；官方說明 type: "http"，並接受 streamable-http 作為別名。Claude Code MCP 文件

Codex（config.toml 或 CLI）：

[mcp_servers.lantide-data]
url = "<從 Lantide 複製的 URL>"
# 依 connection kit 填入 bearer / headers；勿把 token 提交進 git

也可用 codex mcp add 新增 streamable HTTP server。依任務收緊 sandbox 與 approval；見 Codex MCP 與 Codex best practices。

維度 只用 CLI Agent 加上 Lantide MCP host
權限邊界 主要靠 client sandbox／approval 再加上 Observe／Execute／Admin 與 workspace scope
Schema 載入 容易一次灌入大量 DDL 可按需探索表與 schema
中間過程 多留在終端機日誌 可沉澱為 SQL 分頁、Steps 與 Activity
正式交付 複製貼上文字 Plan／Report 與可重跑 evidence

結語

Agent 能在 Terminal 跑 SQL，不代表分析已經可驗收。Claude Code 與 Codex 適合當高能力調度器；當你需要口徑審閱、本機資料邊界與可重跑證據時，把 Lantide 接成 MCP host，外部 Agent 的產出就能進入受控工作流。

建議下一步

參考資料