@kotaro_ai_lab

Are you sure you want to delete the question?

If your question is resolved, you may close it.

Leaving a resolved question undeleted may help others!

We hope you find it useful!

【Claude Code】CLAUDE.mdの設定、みんなどうしてる？おすすめの書き方を教えてください

Q&A

開発環境AI生成AIClaudeClaudeCode

背景

最近Claude Code（Anthropic公式CLI）を使い始めました。
プロジェクトルートに CLAUDE.md を配置することで、Claudeにプロジェクト固有のコンテキストを伝えられることを知りました。

質問

皆さんは CLAUDE.md にどのような内容を書いていますか？

例えば：

  • プロジェクト構成の説明
  • コーディング規約・スタイルガイド
  • 使用している技術スタック
  • よく使うコマンド
  • 禁止事項・注意点
  • その他

実際に効果があった設定や工夫があれば教えていただきたいです。

知りたいこと

  1. どんな項目を書くと効果的か
  2. ファイルサイズや記述量の目安
  3. チーム開発での運用方法（.gitignoreに入れるか等）
  4. 複数プロジェクトでの使い分け

ぜひ皆さんの CLAUDE.md の書き方を共有してください！

0 likes

1Answer

kenimo49
@kenimo49

一番効果があったのは「使わない技術」を書くことです。

技術

  • Python 3.12 + FastAPI + SQLite
  • ORM: SQLAlchemy 2.0（asyncは使わない）
  • 認証: セッションベース（JWTは使わない）

書かないとClaude Codeが勝手にJWTやasyncを提案してきて、毎回「それ使わないんだけど」のやり取りが発生します。「やらないこと」を明記するだけで指示の精度がかなり変わりました。

あとファイルサイズは500行以下がおすすめです。CLAUDE.mdは毎回読み込まれるので、長いとトークンの無駄遣いになります。詳細は別ファイルに分けて：
設計判断で迷ったら docs/ARCHITECTURE.md を読んでから提案すること
これだけで、必要な時だけ深い情報を参照してくれるようになります。

1Like

Comments

  1. @kotaro_ai_lab

    Questioner

    まず返答ありがとうございます。

    「使わない技術」を明記するアプローチ、非常に参考になりました。AIは選択肢が多いと「一般的にベターとされる方法」を提案しがちなので、明示的に除外することで意図しない提案を防げるのは納得です。多くの人が実践すべきだと感じします。

    また、CLAUDE.mdを500行以下に抑えて、詳細はdocs/ARCHITECTURE.mdに分離する運用も理にかなっていると感じます。トークン効率と情報の深さを両立できる良い設計だと思いました。

    改めて、貴重な知見の共有ありがとうございました。

Your answer might help someone💌

LoginSign Up