Claude Codeでファイルを添付するには？@メンションやドラッグ操作を徹底解説！

2026年5月10日

ターミナルで爆速開発ができるClaude Codeを使ってみたけど、ファイルの渡し方で迷っている人はいませんか。従来のブラウザ版みたいにクリップアイコンがないから、どうやってソースコードを読み込ませればいいのか悩みますよね。Claude Codeでのファイル添付は、実はコマンド一つで完結するめちゃくちゃ便利な仕組みになっています。この記事では、初心者の方でも迷わないように、メンション機能の使い方や画像、PDFの読み込み、さらには便利な初期設定まで、ファイル参照にまつわる疑問をまるっと解決していきますね。

Claude Codeで特定のファイルを指定する@メンションの具体的な使い方
画像やPDFなど、マルチメディアファイルをエージェントに共有する手順
大規模プロジェクトでも迷わないフォルダ参照やディレクトリ管理のコツ
セキュリティを守りつつ効率的にファイルを読み込ませる設定方法

Claude Codeでファイル添付を行う基本操作

まずは基本中の基本、Claude Codeの対話画面からファイルを認識させる方法について解説します。ブラウザ版の「アップロード」とは感覚が少し違いますが、慣れるとこちらの方が圧倒的にスムーズですよ。ターミナル上で操作しているからといって、難しく考える必要はありません。むしろ、キーボードから手を離さずにファイルを指定できる快感は、一度味わうと戻れなくなるかもしれませんね。

使い方とメンション機能の活用

Claude Codeを起動して対話している最中、特定のファイルについて質問したい時は「@（アットマーク）」を入力してみてください。これが、Claude Codeにおける最も標準的なファイル添付のやり方です。チャット中に「@」を打ち込むと、現在のプロジェクト内にあるファイルパスが候補としてリストアップされます。このサジェスト機能が優秀で、曖昧な記憶でも目的のファイルをパッと見つけられるのが嬉しいポイントですね。

単に「あのファイルを見て」と指示するよりも、@メンションを使って直接パスを指定することで、Claudeはそのファイルの最新状態を確実にコンテキスト（記憶）に読み込みます。これにより、古い情報を元にした回答を防ぎ、精度の高いコードレビューやリファクタリングの提案を受けることが可能になります。複数のファイルを同時にメンションすれば、ファイル間の依存関係を考慮した高度な分析も朝飯前ですよ。

@メンションのメリット

ファイルパスの入力ミスを防げる自動補完機能
複数のファイルを同時に指定して、ファイル間の関係性を分析させることが可能
大規模なリポジトリでも、エージェントが迷わず正確なコードを参照できる
ファイルの最新の状態を瞬時にコンテキストへロードできる

さらに深掘りすると、このメンション機能は単なるファイルパスの指定に留まりません。例えば、特定のディレクトリを指定して「このフォルダ内の全ファイルを要約して」といった指示も可能です。ただし、一度に大量のファイルを読み込ませるとコンテキストがパンパンになってしまうので、関連性の高いファイルに絞ってメンションするのが、スマートに使いこなすコツかなと思います。

画像やPDFのアップロード手順

Claude Codeはテキストベースのツールだと思われがちですが、実は画像やPDFの解析も非常に得意なマルチモーダル対応なんです。開発現場では、デザインカンプ（画像）を見ながらCSSを書いたり、数法書（PDF）を読み込ませてロジックを組んだりする場面が多いですよね。そんな時も、Claude Codeならスムーズに対応できます。

VS Codeのターミナルやデスクトップアプリ版を使っている場合、チャット欄にファイルを直接ドラッグ＆ドロップするだけでOK。すると内部的にファイルパスが処理され、Claudeがその視覚情報を解析できる状態になります。例えば、エラーが出ている画面のスクリーンショットをポイッと放り込んで「これ、どこを直せばいい？」と聞くだけで、画像内のテキストや構成を読み取って具体的な修正案を出してくれます。これはブラウザ版の利便性をそのままCLIに持ち込んだ、かなり強力な機能だと言えますね。

PDFについても同様で、ドキュメントを添付すれば、その中の表組みやフローチャートを理解した上でコードに落とし込んでくれます。ただし、PDFに含まれる画像があまりに高精細だったり、ページ数が数百枚に及ぶ場合は、処理に時間がかかったりテキスト抽出が優先されたりすることもあります。公式の技術仕様（出典：Anthropic『Claude 3 Model Family』）でも、マルチモーダル機能による視覚情報の処理能力は強調されていますが、効率的に使いたいなら、必要なページだけを抽出して渡すなどの工夫をすると、より快適に作業が進むはずです。

フォルダごと参照する方法

特定の1ファイルだけでなく、プロジェクトの特定の「機能単位」や「モジュール全体」をClaudeに把握させたいこともありますよね。そんな時は、ディレクトリ単位での参照が役立ちます。基本的には @path/to/folder/ のようにフォルダを指定すれば、Claudeはその中身の構造をスキャンしてくれます。これにより、「このコンポーネントディレクトリ全体の設計思想に矛盾がないか確認して」といった広範囲な指示が可能になります。

ただし、ここで一つ注意したいのが「情報過多」です。大規模なディレクトリを丸ごと読み込ませると、Claudeの処理能力（トークン）を無駄に消費してしまい、肝心の修正案が短くなってしまうことも。賢いやり方としては、まず `/ls` コマンドなどでディレクトリ構造だけを把握させ、その後に「必要なファイルだけ」をピンポイントでメンションしていくスタイルがおすすめ。Claudeに「全体像」を伝えつつ、作業は「各個撃破」で進めるイメージですね。

また、フォルダ参照をする際は、後述する .claudeignore の設定も重要になってきます。不要なキャッシュフォルダや node_modules まで読み込んでしまうと効率が落ちるので、あらかじめ除外設定をしておくことで、フォルダ参照の真価が発揮されます。「必要な場所だけを、深く見せる」のが、エンジニアらしいスマートな使い方ではないでしょうか。

ドラッグアンドドロップによる簡単な共有

「コマンドラインツールだから、すべてキーボードで操作しなきゃいけない」なんて、自分を追い込む必要はありませんよ。Claude Codeは、モダンな開発環境との親和性を重視して設計されています。特にVS Codeなどのエディタ一体型ターミナルを使っているなら、エクスプローラーからファイルを掴んで、ターミナルの入力行にドラッグ＆ドロップするだけで、瞬時にファイルパスが展開されます。

この機能の素晴らしいところは、長いパスを手打ちする手間が省けるだけでなく、タイポ（入力ミス）による「ファイルが見つかりません」というエラーをゼロにできる点です。特にネストが深いプロジェクトでは、パスを手で打つのは苦行ですよね。マウスで直感的に「これ！」と指し示す感覚でファイルを共有できるのは、CLIとGUIの良いとこ取りと言えるでしょう。

さらに、画像をドラッグ＆ドロップした際には、それが単なるパスとしてではなく「添付画像」として認識される仕組みになっています。ターミナル上にはテキストしか表示されなくても、バックエンドではしっかりと画像データがClaudeに送信されているので安心してください。エンジニアとしての効率を求めるなら、時にはマウスの機動力に頼るのも、立派なテクニックの一つかなと思います。

ローカル環境との連携と初期設定

Claude Codeを本当の意味で「自分のプロジェクトの一員」にするためには、最初のセットアップが肝心です。まず試してほしいのが /init コマンド。これを実行すると、Claudeがあなたのリポジトリをぐるっと見渡して、そのプロジェクトの言語、フレームワーク、ディレクトリ構造を自動で学習し、最適な設定ファイルを作成してくれます。これによって、ファイル参照の精度が飛躍的に向上します。

CLAUDE.mdを作ろう
プロジェクトのルートディレクトリに「CLAUDE.md」というファイルを用意しておくのが、Claude Codeマスターへの近道です。ここに「このプロジェクトではこの命名規則を使う」「テストコードはこのコマンドで走らせる」といった、いわば『プロジェクトの憲法』を書いておきましょう。Claude Codeは起動時に必ずこのファイルを読み込むので、毎回「このプロジェクトのルールはね……」と説明する手間が省け、指示の通りが格段に良くなりますよ。

初期設定を済ませておけば、ファイルを1枚添付しただけでも、Claudeはその背景にある「プロジェクト全体の文脈」を考慮して回答を生成してくれるようになります。例えば、「@index.ts を修正して」という一言だけで、共通ライブラリの書き方や既存の型定義を壊さないように配慮したコードを出してくれるようになるんです。最初の手間を惜しまないことで、その後の開発体験が何倍も快適になりますよ。

Claude Codeのファイル添付を使いこなすコツ

基本がわかったところで、次は一歩進んだテクニックを紹介します。AIエージェントには「記憶の限界」があるので、それを上手く管理するのが使いこなしのコツです。限られたリソースの中で、いかにClaudeに質の高い仕事をしてもらうか。ここからは、プロの道具としてClaude Codeを乗りこなすための知恵を詰め込みました。

コンテキスト制限とトークンの仕組み

Claude Codeでファイルを添付しまくる際に、避けて通れないのが「トークン」と「コンテキストウィンドウ」の話です。Claudeには一度に処理できる情報量（記憶容量）が決まっています。ファイルを添付するということは、その中身のテキストや画像データをすべてこの記憶容量に詰め込むということです。大きなファイルを大量に読ませると、あっという間に容量が一杯になり、古い情報を忘れてしまったり、回答が不安定になったりすることがあります。

要素	消費の目安	注意点
テキストファイル	文字数に比例	数万行を超えると動作が重くなる可能性あり。分割して渡すのが吉。
標準的な画像	約1,600トークン〜	解像度が高いほど消費が激しい。要件に無関係な背景などはカットして。
PDF（視覚解析）	ページ数に比例	100ページを超えるとテキストのみになる場合も。重要なページを絞る。
履歴データ	会話の累積	やり取りが長くなると、新しい添付ファイルが読み込めなくなる。

特に画像は要注意です。文字で説明すれば数トークンで済む内容も、画像1枚で1,000トークン以上消費してしまうことがあります。「トークンの節約は、AIの集中力の節約」だと思ってください。必要な部分だけを抽出し、不要になったファイル情報は後述する `/compact` で整理する。この「情報の取捨選択」ができるようになると、Claude Codeとの共同作業はさらに円滑になりますよ。

無視設定とセキュリティの注意点

エンジニアとして絶対に忘れてはいけないのが、セキュリティとプライバシーです。Claude Codeは強力なエージェントであり、指示されればプロジェクト内のあらゆるファイルを読みに行こうとします。しかし、APIキーが書かれた `.env` ファイルや、顧客情報が含まれるデータベースのダンプファイルなどをAIに読み込ませるのは、セキュリティリスクになり得ます。意図しない情報流出を防ぐために、必ず .claudeignore を活用しましょう。

`.claudeignore` は `.gitignore` と同じ書き方で、Claudeに「このファイルには触るな」と指示できる仕組みです。 #### 具体的な設定例 * `.env` や `secrets.json` などの秘匿情報 * `node_modules` や `dist` などのビルド・依存関係ファイル * `.git` フォルダなどの管理用メタデータこれらを除外しておくことで、セキュリティを守るだけでなく、Claudeが余計なファイルをスキャンするのを防ぎ、レスポンス速度を上げる効果もあります。

セキュリティの落とし穴
`.claudeignore` で設定していても、エージェントが自ら bash コマンド（`cat` や `grep` など）を駆使してファイルを開こうとするケースが稀にあります。これを完全に防ぐには、Claude Code自体の実行権限を制限するか、OSレベルで機密ファイルへのアクセス権を絞るのが最も確実です。AIは「万能なツール」であると同時に「好奇心旺盛なエージェント」でもあることを忘れずに、境界線は人間がしっかり引いてあげましょう。

履歴の要約による作業の効率化

一つのプロジェクトで数時間、あるいは数日にわたってClaudeとやり取りを続けていると、会話の履歴が膨大になっていきます。そうなると、Claudeの頭の中がいっぱいになり、「さっき送ったあのファイルの内容、もう一度教えて？」といったトンチンカンなやり取りが発生しやすくなります。これを防ぐための特効薬が /compact コマンドです。

このコマンドを打つと、これまでの長いやり取りをClaude自身が「要約」し、重要な結論や現在のコンテキストだけを抽出して、古い詳細データを破棄してくれます。これにより、コンテキストウィンドウに余裕が生まれ、新しいファイルを添付したり、複雑な指示を出したりするためのスペースが確保されるわけです。いわば、作業の節目で「黒板をきれいに拭き直す」ような作業ですね。

「そろそろ動作が重くなってきたな」「Claudeの反応が少し鈍いかも」と感じたら、迷わず `/compact` を実行してみてください。添付したファイルの重要なポイントだけを記憶に残しつつ、システム全体をリフレッシュすることで、プロジェクトの終盤まで高いパフォーマンスを維持できます。長時間のコーディングセッションには欠かせない、プロ御用達のコマンドですよ。

料金プランごとの制限値と選び方

Claude Codeのパワーを最大限に引き出すためには、自分がどのプランを使っているかを把握しておくのも大切です。2026年現在、無料枠でも基本的なファイル添付や対話は可能ですが、大きなプロジェクトで大量のファイルを読み込ませたり、高頻度でマルチモーダル解析を行ったりすると、すぐに「レートリミット（利用制限）」に達してしまいます。

ProプランやTeamプランにアップグレードすると、このリミットが大幅に引き上げられます。例えば、一日に送信できるトークン数や画像枚数が数倍〜数十倍になるため、業務でガシガシ使いたいなら有料プランへの移行は必須と言えるでしょう。また、上位プランでは最新のモデル（例えば Claude 3.5 Sonnet や Claude 4 シリーズなど）を優先的に、より高速なレスポンスで利用できるメリットもあります。

自分の開発スタイルが「たまにコードの相談をする程度」なのか、「設計から実装までべったり一緒にやりたい」のかによって、最適なプランは変わります。まずは無料枠でファイル添付の使い勝手を試し、物足りなさを感じたら Proプランを検討する、というステップが一番無駄がないかなと思います。投資した分以上の生産性は、Claudeがきっと返してくれますよ。

モデルの切り替えによるコスト管理

実は Claude Codeでは、裏側で動いているAIの「モデル」を自由に変更できることを知っていましたか？ /model コマンドを使うことで、その時の作業内容に合わせて最適な頭脳を選べるんです。これは、トークンの節約だけでなく、回答の質をコントロールする上でも非常に重要なテクニックです。

#### 賢いモデルの使い分け方 * Sonnet系モデル: バランス型。日常的なコーディング、テストの作成、小規模なファイルの修正に最適です。レスポンスが速く、トークン消費も抑えめ。 * Opus系モデル: 最強・知能優先型。複雑なアルゴリズムの設計、プロジェクト全体の構造改革、大量のPDFやドキュメントを読み込ませる重たいタスクに。 * Haiku系モデル: 超高速・軽量型。単純なスクリプトの作成や、ログファイルの高速検索などに。例えば、画像ファイルを何枚も読み込ませて複雑なUIを実装させるなら、多少コストがかかっても Opus を選んだほうが、結果的に手直しが少なくて済みます。逆に、ちょっとしたタイポ修正を依頼するだけなら、軽量モデルで十分。このように状況に応じてモデルを切り替えることで、Claude Codeをより「スマートに、安く、速く」使い倒すことができるようになります。

便利なClaude Codeのファイル添付まとめ

Claude Codeにおけるファイル添付は、単なるデータの受け渡しではなく、AIと「同じ視点」を持つための重要なプロセスです。@メンションでスマートに指定し、CLAUDE.mdでプロジェクトのルールを共有し、不要な情報は .claudeignore でシャットアウトする。この3つを押さえるだけで、あなたの開発体験は劇的に変わるはずです。まずは小さなファイルから、Claudeに「これ見て！」と話しかけてみてくださいね。

今回のまとめ