Codex でデータ分析：クエリ、CSV、構造化された結果

データ分析で Codex ができること

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

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

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

1. ツールをつなぐ

   Codex には読み取り専用のロールを与え、データがワークスペースにない場合だけネットワークアクセスをオンにします。プロジェクトフォルダにある CSV エクスポートなら、追加の準備は要りません。

   # ~/.codex/config.toml：コマンドがウェアハウスに届くようにする
   [sandbox_workspace_write]
   network_access = true

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

   Codex は作業の前に AGENTS.md を読みます。まず ~/.codex/AGENTS.md、次にリポジトリのルートから作業中のフォルダまでのファイルです。仕事のルールはそこに書くか、長くなるなら .agents/skills/ 以下のスキルにします。AGENTS.md ガイドをご覧ください。

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

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

   codex exec は 1 つのタスクを実行して終了します。進捗は stderr に、最終メッセージは stdout に出力されます。-o を付けるとファイルにも書き出し、--json を付けるとイベントをストリームします。--sandbox workspace-write を渡さない限り、サンドボックスは読み取り専用です。

   # 先週の数字を、スキーマに合った JSON で
   codex exec --sandbox workspace-write --output-schema metrics.schema.json \
     -o metrics.json "先週の登録数、アクティベーション、売上を計算し、前の週と比べて"

4. スケジュールに載せる

   ChatGPT のデスクトップアプリか Web でスケジュールタスクを作るか（CLI では管理できません）、cron から codex exec を実行します。Codex を自律的に動かす方法をご覧ください。

出典：Codex のドキュメント

限界と安全性

• 読み取り専用のロールを与えましょう。データベースへの書き込み権限を持つエージェントは、データベースを変更できてしまいます。
• 列の意味を読み違えることがあります。短いデータ辞書を書き、最初のいくつかの答えは確認しましょう。
• 大きな結果はコンテキストと利用量を消費します。行を読む前に、クエリで集計しましょう。
• Codex はデフォルトでコマンドをサンドボックスの中で実行します。書き込みはワークスペース内に限られ、ネットワークはオフです。danger-full-access は、隔離されたランナーやコンテナでだけ使いましょう。

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

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

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

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

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

1. 職種から始める

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

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

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

3. 関連ページ

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

よくある質問