.claudeignoreとは
.claudeignoreとは、Claude CodeなどのAnthropic製AIツールにおいて
読み: クロードイグノア
Claude CodeなどのAnthropic製AIツールにおいて、AIに読み込ませたくないファイルやディレクトリを指定する設定ファイル。.gitignoreと同じ書式で、コンテキストウィンドウの節約、秘密情報の保護、推論精度の向上を目的とする。
かんたんに言うと
「この書類はAIに見せなくていい」と指定するリスト。秘密情報やゴミファイルをAIの視界から消すことで、AIの判断力と安全性を同時に高める。
コンテキスト節約とセキュリティ保護
AIが一度に読み取れる情報量（トークン数）には上限がある。node_modulesやビルド成果物を読み込ませると、肝心のソースコードを読む枠がなくなる。
セキュリティ面ではさらに重要。APIキーやパスワードが書かれた.envファイル、秘密鍵をAIに送信しないよう強制的にブロックする。シークレット管理と併用することで、開発環境の安全性を担保する。
.gitignoreとの使い分けと推奨設定
.gitignoreに書かれている内容は.claudeignoreにも当てはまることが多い。違いは「Git管理はしたいけれどAIには見せたくない」ファイルの存在。巨大なテストデータ用CSVや社外秘のドキュメントは.claudeignoreで個別に制御する。
一般的な除外対象: node_modules/, vendor/, dist/, build/, .env, *.pem, secrets.JSON, *.log, tmp/, .cache/, .git/。プロジェクトの初期設定時にこのファイルを整備しておくと、AIの推論精度が目に見えて変わる。ノイズが減ればAIはソースコードの論理構造だけに集中できる。
当社の見解
当社はツール選定において実用性を第一方針にしている（2026年4月現在）。カタログスペックやベンチマークスコアではなく、実務で1週間使い倒して初めて判断する。実際に2026年4月、omega-memory（GitHubスター57）を導入した結果、16個のhookが自動追加されてツール1回あたり181秒のオーバーヘッドが発生し、即日撤去した経験がある。一方、FastEmbed（Qdrant社、2,800スター）やLanceDB（YC支援、9,800スター）は企業バッキングと十分な実績を確認した上で導入し、安定稼働している。GitHubスター数・企業バッキング・pip installの副作用を導入前に必ず検証する方針を確立した。
同じ失敗を二度としないAIエージェント
今のAIは、聞けば何でも答えてくれます。
でも、セッションが切れた瞬間に前回の失敗を忘れます。
当社が開発しているAIは、過去の経緯を念頭に置いて、
聞かれる前に「それは前回うまくいきませんでした」と声をかけます。
人間にも同じ失敗をさせず、AI自身も繰り返しません。
古参の社員が横にいるように、黙っていても気づいてくれる。
それが、当社が考える本当のAI社員です。