Claude Media
Claude CSV分析の使い方 — 集計とグラフ化の手順

Claude CSV分析の使い方 — 集計とグラフ化の手順

ClaudeにCSVをアップロードして集計・グラフ化・欠損値処理までを任せる手順です。Excelとの使い分けと、Claude Codeで手元のCSVを直接処理する方法も扱います。

このTipsでできること

ClaudeにCSVファイルをアップロードすると、集計・グラフ化・欠損値の洗い出しをチャットの指示だけで進められます。Claudeがサンドボックス(隔離された実行環境)でPythonのコードを書いて動かし、結果の表やグラフ画像を返す仕組みです。

「この売上データを月別に集計して、前月比のグラフにして」のような依頼で、コードを書く工程を省いたまま結果を受け取れます。Free・Pro・Max・Team・Enterpriseの全プランが対象で、Web、Claude Desktop、モバイルのどこからでも添付できます。ただしTeamとEnterpriseは、組織の管理者が機能ごと止めている場合があります(後述)。

やり方 — CSVを添付して分析を依頼する

チャット画面にCSVを添付し、やりたいことを具体的に書きます。列名や欲しい出力形式を明示するほど、手戻りが減ります。2つのCSVを突き合わせる例はADの休眠アカウント棚卸しにあります。

プロンプト例(基本の集計)
添付したCSV(2026年上半期の注文データ)について、
以下を行ってください。
 
- 月ごとの合計金額を集計する
- 上位5商品の売上構成比を円グラフにする
- 欠損値がある列があれば、列名と件数を報告する

進め方は、1回で全部頼まず、結果を見ながら段階を踏む形が基本です。実験の測定値を因子ごとに分析する例はClaudeで実験計画法の直交表を組み分散分析まで進める手順にあります。

流れ

CSV分析を依頼するときの流れ

  1. 1

    何を比較したいかを決める

    時系列の推移なのか、カテゴリ別の構成比なのかで、適したグラフが変わります。依頼の前に一言で言える状態にします。

  2. 2

    CSVを添付して、列名と出力形式を指定する

    「月ごとの合計」「上位5件」のように、欲しい出力の形で書きます。

  3. 3

    対象の行数と欠損を先に報告させる

    集計に入る前に、全何行を読み込んだかと欠損のある列を答えさせます。想定と食い違えば、この時点で気づけます。

  4. 4

    気になった点を掘り下げる

    突出した値や不自然な値が見つかったら、その行だけを抜き出して確認します。

  5. 5

    必要な形式でダウンロードする

    加工後のCSVや、集計結果をまとめたExcelファイルとして出力させます。生成したファイルは、ダウンロードするほか、Google Driveに直接保存できます。

手順4の追加依頼は、たとえば次のように書きます。

プロンプト例(深掘りの追加依頼)
先ほどの月別集計で、3月だけ突出して高い数値でした。
3月のデータだけを抜き出して、
どの商品・どの顧客が牽引しているかを確認してください。

合計や平均だけでは見えない要因は、この掘り下げで特定できます。異常値らしき行は、その行だけを表示させて元データの入力ミスかを確かめると精度が上がります。商品レビューの書き出しCSVを分類する具体例は、商品レビューCSVの分析手順で解説しています。

できる分析の種類

分析の種類依頼の例出力
集計・統計依頼の例平均・合計・分布を出す出力数値・表
グラフ化依頼の例時系列推移・構成比を可視化する出力PNGなどの画像
データクリーニング依頼の例欠損値・重複行・型の不整合を洗い出す出力報告 + 修正済みCSV
変換依頼の例CSVをExcel形式にまとめ直す出力.xlsxファイル

グラフはPNGなどの画像ファイルとして出力され、コードの結果として返ってきます。種類の指定や作り直しの頼み方はClaudeにグラフを作らせる基本の頼み方にまとめています。

CSVを渡して機械学習モデルを作らせることもできます。この場合、Claudeは手元のデータでPythonのモデルを学習し、モデルの品質と結果の説明まで返します。CSVから財務モデル、要約メモ、PowerPointまでを順に作らせる使い方もあります。

毎回同じCSVを使う分析なら、プロジェクトにファイルを置く手もあります。プロジェクトのファイルはClaudeの実行環境から参照でき、会話のたびに添付し直す手間が省けます。売上明細を週次で回す具体例はPOS売上CSVの週次振り返りにあります。顧客リストを購入日・回数・金額で区分する手順はClaudeでRFM分析する手順にまとめています。

ExcelでなくCSVが向く場面

数式や複数シートを保ったまま渡したいならExcel、単一の表を渡して分析だけさせたいならCSVで十分です。自由記述まで含むアンケートの集計は研修後アンケートの集計手順で扱っています。

CSVはプレーンテキストで、同じ行数ならExcelより軽くなります。元データに数式や書式を持たせる必要が無いなら、変換せずCSVのまま渡すのが最短です。VLOOKUPやSUMIFSのような関数そのものを書かせたい場合はClaude Excel関数の書き方が参考になります。ATSの書き出しCSVで転換率を出す例は採用の歩留まり分析にあります。

データクリーニングを頼むときの具体例

欠損値・重複行・型の不整合は、集計結果を歪める代表的な原因です。集計の前に確認させておくと、後工程の手戻りが減ります。

プロンプト例(クリーニングの依頼)
このCSVについて、次を確認してから集計に進んでください。
 
- 欠損値がある列名と件数
- 完全に同じ内容の重複行があれば件数
- 数値のはずの列に文字列が混ざっていないか
問題があれば、修正方針を提案してから直したCSVを出力してください。

修正方針を先に提案させると、欠損値を勝手に0で埋めるような補完が黙って入り込むのを防げます。重複行を消す場合も、何をもって重複と判定したかを報告させておけば、後から根拠をたどれます。

大きいCSVを扱うときの注意点

アップロードもダウンロードも、上限は1ファイル30MBです。数百万行のログなどはこの上限に触れやすいので、必要な期間と列だけに絞ったCSVを先に作っておくと通ります。

絞った後の行数も、手順3の報告で確かめておきます。集計が全件なのか一部なのかは、結果を見ただけでは区別できないためです。

処理時間にも枠があります。Claudeが1回に実行できるタスクの長さと、1つのサンドボックスを使い続けられる時間には上限が設けられています。巨大なCSVを一気に処理させるより、期間や列で分けて依頼するほうが、途中で打ち切られる事態を避けやすくなります。また、コード実行とファイル作成は通常のチャットより使用量を多く消費するため、大きなCSVを繰り返し分析すると、プランの上限にも早く近づきます。

動かないときはプランと組織の設定を見る

アップロードしても集計に進まない場合、依頼の書き方より先に、実行機能そのものがオンかどうかを確かめます。CSV分析は「コード実行とファイル作成」の機能に乗っており、設定がプランごとに違います。

設定

プラン別の初期設定

  • Free・Pro・Max

    「Settings > Capabilities」の「Code execution and file creation」で、利用者自身がオン・オフを切り替えます。ネットワークは有効で、承認されたソースからパッケージを追加できます。

  • Team

    組織の管理者が「Organization settings > Capabilities」で機能ごと無効にできます。無効なら、メンバー側では何をしても動きません。

  • Enterprise

    こちらも管理者が同じ画面で切り替えます。新規の組織ではネットワーク出力(network egress)が既定でオフです。

Teamのネットワーク設定は、サポート記事のAvailability節では既定で無効、設定の節では既定でパッケージマネージャーのみ許可と書かれています。どちらの既定でも、管理者がオフにすれば事前にインストール済みのパッケージだけで動く状態になります。分析が途中で止まる場合は、不足しているパッケージを追加できない設定かもしれません。

管理者が選べるネットワーク設定は4段階です。

  • オフ: 事前にインストール済みのパッケージだけで動き、インターネットには出ません
  • パッケージマネージャーのみ(Teamの設定節で既定とされる設定): npmやPyPIなどの承認済みソースからパッケージを入れられます
  • パッケージマネージャーと指定ドメイン: 組織が許可したドメインを追加します
  • すべてのドメイン: 法的なブロックリスト以外の全域に出られます。サポート記事自身が最もリスクの高い選択肢としています

CSVの分析だけなら、外部に出る必要はほとんどありません。管理者がオフを選んでいる組織でも、添付したCSVの集計とグラフ化は進められます。pandasのように事前導入に含まれないパッケージを足したいときは、パッケージマネージャーを許可する2段目以降の設定が要ります。

Claude CodeでCSVを分析する場合の違い

Claude Codeでは、手元のCSVをチャットにアップロードせずに扱えます。Readツールはファイルを行番号付きで返し、全体がトークン上限を超えると先頭の1ページだけをPARTIAL viewの通知付きで返します。続きはoffsetとlimitで読み進める仕組みです。

くらべる

チャットとClaude Codeの使い分け

単発の確認向き

チャットにアップロード

コードを意識せず、その場で表やグラフを受け取れます。実行環境はあらかじめ用意され、結果は会話の中に残ります。

繰り返す集計向き

Claude Codeで処理

処理をスクリプトとして保存して再実行できます。上限は手元のディスクと実行環境に左右されます。

Claude Codeの経路には、チャットのサンドボックスと違い、パッケージの用意が自分の環境の責任になる落とし穴があります。Python 3.12.2をインストールしただけの環境で、定番のpandasを読み込んだ結果は次のとおりです。

python3 --version
python3 -c "import pandas as pd"
実際の出力(Python 3.12.2・pandas未導入の環境)
Python 3.12.2
ModuleNotFoundError: No module named 'pandas'

Claude Codeに「pandasで集計して」と頼んでも、実行するのは手元のPythonです。未導入ならまずインストールが要ります。標準ライブラリのcsvモジュールなら追加導入なしで動くので、依頼文に「標準ライブラリだけで」と添える手もあります。

python3 -c "
import csv
rows = list(csv.DictReader(open('orders.csv')))
print(len(rows), 'rows; empty amount:',
      sum(1 for r in rows if not r['amount']))
"
実際の出力(4行のサンプルCSV)
4 rows; empty amount: 1

複数のCSVを横断する集計はDuckDB / MotherDuck MCPサーバーでつなぐ経路もあります。複数のデータソースを分業して検算まで回したい場合は、CoworkのExcel・スプレッドシート分析の進め方が参考になります。装置やPLCの秒単位ログのような大容量データは、Claude CodeでPLCのログを解析する手順が扱っています。

データのプライバシーに関する注意

個人情報や社外秘のデータを含むCSVは、アップロード前に学習への利用設定を確認しておくと安心です。プラン別の既定と設定手順はClaudeを学習させない設定にまとめています。問い合わせCSVを毎週集計する運用はClaudeでVOC分析する手順で扱っています。

コード実行の環境は、利用者ごとに分離されたサンドボックスです。Claudeが行った操作は、わかりやすい要約で確認でき、サンドボックス内の操作を見直して監査することもできます。サンドボックス同士が共有されることはなく、Free・Pro・Maxでは、ファイル成果物を含む会話の公開共有が無効になっています。

リスクが残るのはネットワークです。ネットワークが有効だと、外部のファイルやサイトに仕込まれた指示(プロンプトインジェクション)で、Claudeがデータを外部へ送ってしまう危険があります。外部のCSVや取得データを扱うときは、動作を見ながら進め、想定外の動きがあれば止めます。MCP連携は、ネットワーク出力の設定に関係なく通信が可能です。

社外に出せないデータは、Claude Codeで手元のファイルを直接処理する経路ならチャットへのアップロード自体を避けられます。個人名やメールアドレスの列は、分析に不要なら列ごと削除してから渡すと、渡す範囲を最小限にできます。

よくあるつまずき

アップロードしても集計されずテキストの説明だけ返ってくる

組織の設定でコード実行が無効になっている可能性があります。Team・Enterpriseなら管理者に確認します。

グラフの数値が想定と違う

読み込んだ行数と集計対象の行数がずれている可能性があります。手順3で報告させた行数と、フィルタ条件・ヘッダ行・空行の扱いを突き合わせ、ずれた箇所を特定します。

日本語の列名や値が文字化けする

CSVの文字コードがUTF-8以外だと起きやすい現象です。Excel 2016以降のMac版には「CSV UTF-8(コンマ区切り)」形式で保存する選択肢があり、UTF-8のテキストファイルとして書き出せます(書式や数式は保存されません)。保存し直してから添付します。

集計の桁数や小数点の扱いが想定と違う

桁数や単位を指定していないと、丸め方が意図とずれます。「小数点第1位まで」「円単位で」のように精度を明示します。

よくある質問

CSVとTSVで分析の頼み方は変わりますか

変わりません。CSV、TSV、そのほかのデータファイルがアップロードの対象で、区切り文字が違うだけです。

複数のCSVを一度に比較させることはできますか

同じチャットに複数のCSVを添付して、「両方の顧客IDを突き合わせて重複を確認して」のように結合を伴う依頼を出せます。ファイルごとに列名の表記が微妙に違う場合は、先に「両ファイルの列名を一覧で見せて」と確認させてから結合を頼みます。キーの不一致に気づかないまま進めるのを防げます。

まとめ

チャットのCSV分析が止まったとき、最初に疑うのは依頼文でなくCapabilitiesのオン・オフです。ネットワークが閉じていても集計とグラフ化は進むので、パッケージを足したくなった時点が、設定を見直すか手元のClaude Codeへ移るかの分かれ目になります。Search ConsoleのCSVでの実例はリライト優先度を決める手順にあります。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. support.claude.com/en/articles/12111783-create-and-edit-files-with-claude
  2. code.claude.com/docs/en/tools-reference
この記事を共有:XはてブLinkedIn