使用情境 · Claude Code

用 Claude Code 做資料分析:查詢、CSV 和每週摘要

Claude Code 不只能寫程式。把它指向資料庫、資料倉儲的 CLI,或一個放滿 CSV 匯出檔的資料夾,它會撰寫查詢和腳本、執行、檢查結果,並解釋哪些數字變了。本頁說明如何安全地交出資料、CLAUDE.md 的規則,以及如何以 JSON 取回答案,用在儀表板或每週報告。

資料分析:Claude Code 能做什麼

  • 用唯讀角色或唯讀副本執行 SQL 來回答問題,並把查詢和答案一起列出。
  • 用 Python 清理和分析 CSV 匯出檔,並畫出圖表。
  • 撰寫每週指標摘要:哪些數字變了、變了多少,以及可能的原因。
  • 在有人察覺之前標出異常,例如註冊數下滑或錯誤激增。

資料分析:用得上的 Claude Code 功能

功能用途怎麼開始
資料庫 CLI 或 MCP 伺服器查詢你的資料庫或資料倉儲;給它唯讀角色psql、bq,或透過 claude mcp add 加入資料倉儲的 MCP 伺服器
工作階段裡的 Python清理 CSV、合併匯出檔、畫圖表請它分析工作資料夾裡的某個檔案
--json-schema以符合你 schema 的 JSON 回傳答案claude -p ... --output-format json --json-schema
排程任務不開工作階段也能產出每週摘要/schedule weekly metrics digest on Monday at 9am

資料分析:如何設定 Claude Code

  1. 連接工具

    建立一個唯讀的資料庫角色,把那個連線交給 Claude Code,或給它以唯讀使用者登入的資料倉儲 CLI。一次性的分析,把 CSV 匯出檔放進工作資料夾就好。

    -- Postgres:給 agent 用的唯讀角色
    CREATE ROLE analyst LOGIN PASSWORD '<password>';
    GRANT pg_read_all_data TO analyst;
  2. 把規則寫進 CLAUDE.md

    Claude Code 在每個工作階段開始時都會讀取 CLAUDE.md,claude -p 的執行也一樣。把這項工作的規則寫在那裡;規則很長的話,放進 .claude/skills/ 下的 skill。參見 CLAUDE.md 指南。

    ## 資料規則
    - 唯讀:使用分析用的角色,絕不使用 App 的資料庫使用者。
      不執行 INSERT、UPDATE、DELETE,也不改 schema。
    - 每個數字都附上背後的查詢或腳本。
    - 和前一期比較;變化在正常波動範圍內時要說明。
    - 不匯出個人資料;寫下任何東西之前先彙總。
    - 每週摘要:最重要的五個數字、哪些變了,
      以及一個值得下週追問的問題。
  3. 不開互動介面也能執行

    claude -p 執行一個任務後就結束,所以 cron、CI 或其他工具都能啟動它。用 --allowedTools 或 --permission-mode 決定哪些事不必詢問就能做;--output-format json 會連同成本一起回傳結果。

    # 上週的數字,以 JSON 輸出給儀表板或貼文使用
    claude -p "計算上週的註冊數、啟用率和營收,並和前一週比較" \
      --output-format json --json-schema "$(cat metrics.schema.json)"
  4. 排入排程

    用 /schedule 設成雲端排程任務(Pro、Max、Ultra、Team 和 Enterprise 方案)、設成桌面排程任務,或在工作階段開著時用 /loop。參見如何讓 Claude Code 主動工作。

來源:Claude Code 文件

限制與安全

  • 給它唯讀角色。對資料庫有寫入權限的 agent 就可能改動資料庫。
  • 它可能誤解欄位的意思。寫一份簡短的資料字典,並檢查它最初的幾個答案。
  • 大量結果會耗用脈絡和用量。先查詢、彙總,再讀取資料列。
  • 自 Claude Code v2.1.302 起,claude -p 以 Manual 模式啟動:需要核准的動作,除非有規則允許,否則一律拒絕。只允許這項工作需要的工具。

資料分析,用 Claude Code 還是 Codex?

規則可以共用。在 AGENTS.md 寫一次,再把 @AGENTS.md 放進 CLAUDE.md,兩個 agent 就會讀同一份檔案。

另一個 agent 的逐步做法:Codex 資料分析。

Claude CodeCodex
規則檔CLAUDE.mdAGENTS.md
連接工具claude mcp addcodex mcp add 或 config.toml
你不在也能執行claude -pcodex exec
排程/schedule、桌面排程任務、/loopChatGPT App 的排程任務、cron
內建功能(資料分析)--json-schema 結構化輸出--output-schema 結構化輸出
使用 Crewmark

資料分析:讓它成為某個人的固定工作

指令只在有人記得時才會執行。Crewmark 把你自己的 Claude Code 變成 AI 員工,有職位、量化目標、工作時間和心跳,工作就會依排程完成,並出現在看板上。

  1. 從職位開始

    AI 員工職位:在職位說明裡寫上這些規則。

  2. 把工作放上它的看板

    把這項工作加成週期性 issue。員工依心跳醒來,做完後以評論回報。

  3. 相關內容

    每日 SEO 報告是週期性分析工作的完整範例。

常見問題

Claude Code 能做資料分析嗎?

可以。它會撰寫並執行 SQL 和 Python、讀取 CSV、畫圖表並解釋結果。給它唯讀角色,並要求它列出每個數字背後的查詢。

如何從 Claude Code 取得結構化輸出?

用 --output-format json 和 --json-schema 執行 claude -p;答案會放在 structured_output 欄位裡。

把 Claude Code 連到正式環境的資料庫安全嗎?

連到唯讀副本,或使用唯讀角色,絕不用應用程式本身的資料庫使用者,並讓個人資料維持彙總後的形式。

已於 2026 年 11 月 13 日對照 Claude Code 文件和 OpenAI 的 Codex 文件查核。

資料分析,交給 Claude Code 上的 AI 員工。

Crewmark 把 Claude Code 和 Codex 工作階段變成有職位、目標、工作時間和心跳的 AI 員工。