Claude Code でデータ分析：クエリ、CSV、毎週のダイジェスト

データ分析で Claude Code ができること

• 読み取り専用のロールやレプリカに対して SQL で質問に答え、答えと一緒にクエリを示します。
• CSV のエクスポートを Python で整えて分析し、グラフを描きます。
• 毎週の指標ダイジェストを書きます：何が動いたか、どれだけ動いたか、考えられる理由。
• 登録数の落ち込みやエラーの急増などの異常を、誰かが気づく前に知らせます。

データ分析に使える Claude Code の機能

データ分析向けに Claude Code を設定する方法

1. ツールをつなぐ

   読み取り専用のデータベースロールを作って Claude Code にその接続を渡すか、読み取り専用ユーザーでサインインしたウェアハウスの CLI を渡します。単発の分析なら、CSV エクスポートを作業フォルダに置きます。

   -- Postgres：エージェント用の読み取り専用ロール
   CREATE ROLE analyst LOGIN PASSWORD '<password>';
   GRANT pg_read_all_data TO analyst;

2. CLAUDE.md にルールを書く

   Claude Code は、claude -p での実行も含め、すべてのセッションの開始時に CLAUDE.md を読みます。仕事のルールはそこに書くか、長くなるなら .claude/skills/ 以下のスキルにします。CLAUDE.md ガイドをご覧ください。

   ## データのルール
   - 読み取り専用：分析用のロールを使い、アプリのデータベース
     ユーザーは決して使わない。INSERT、UPDATE、DELETE、
     スキーマの変更はしない。
   - すべての数字について、その裏にあるクエリかスクリプトを示す。
   - 前の期間と比べ、変化が通常の揺れの範囲内ならそう書く。
   - 個人データはエクスポートしない。何かを書き出す前に集計する。
   - 毎週のダイジェスト：大事な 5 つの数字、何が動いたか、
     来週問うべき質問を 1 つ。

3. 対話型の画面なしで実行する

   claude -p は 1 つのタスクを実行して終了するので、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 のドキュメント

限界と安全性

• 読み取り専用のロールを与えましょう。データベースへの書き込み権限を持つエージェントは、データベースを変更できてしまいます。
• 列の意味を読み違えることがあります。短いデータ辞書を書き、最初のいくつかの答えは確認しましょう。
• 大きな結果はコンテキストと利用量を消費します。行を読む前に、クエリで集計しましょう。
• Claude Code v2.1.302 以降、claude -p は Manual モードで始まります。承認が必要な操作は、ルールで許可されていない限り拒否されます。許可するツールは、その仕事に必要なものだけにしましょう。

データ分析に使うなら Claude Code と Codex のどちら？

ルールはそのまま使い回せます。AGENTS.md に一度書き、CLAUDE.md に @AGENTS.md と書いておけば、両方のエージェントが同じファイルを読みます。

もう一方のエージェントでの手順：データ分析を Codex で行う方法。

データ分析を誰かの仕事にする

コマンドは、誰かが実行を思い出したときにしか動きません。Crewmark は、あなたの Claude Code を、職種、数字の目標、勤務時間、ハートビートを持つ AI 社員に変えます。仕事はスケジュールどおりに進み、ボードに表示されます。

1. 職種から始める

   AI 社員の職種から 1 つを選び、ブリーフにこのページのルールを加えます。

2. 仕事をボードに載せる

   この仕事を定期 issue として追加します。社員はハートビートで起きて仕事をこなし、結果をコメントで報告します。

3. 関連ページ

   毎日の SEO 日報は、定期的なアナリティクスの仕事の実例です。

よくある質問