用 Claude Code 做数据分析：查询、CSV 和每周汇总

数据分析：Claude Code 能做什么

• 用只读角色或只读副本跑 SQL 回答问题，并把查询和答案一起给出。
• 用 Python 清洗和分析导出的 CSV，并画图。
• 写每周指标汇总：哪些变了、变了多少、可能的原因。
• 在有人注意到之前标出异常，比如注册量下降或报错激增。

数据分析：Claude Code 的相关功能

数据分析：怎么设置 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 指南。

   ## 数据规则
   - 只读：用 analytics 角色，绝不用应用的数据库用户。
     不做 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 里写一次，再在 CLAUDE.md 里放一行 @AGENTS.md，两个 agent 读的就是同一个文件。

另一个 agent 的分步做法：Codex 数据分析。

数据分析，交给专人负责

命令只在有人记得时才会运行。Crewmark 把你自己的 Claude Code 变成一个 AI 员工，有岗位、量化目标、工作时间和心跳，工作就会按时完成，并出现在看板上。

1. 从岗位开始

   AI 员工岗位，岗位说明里写上这些规则。

2. 把工作放到它的看板上

   把这项工作加成周期 issue。员工按心跳醒来，做完后在评论里汇报。

3. 相关内容

   每日 SEO 日报是一个周期性分析工作的完整示例。

常见问题