CLAUDE.mdを使ってClaude AIセッション間でプロジェクト規約を維持する

あるRedditユーザーによると、プロジェクトルートにCLAUDE.mdファイルを追加することは、Claude Codeで行った中で最も効果の高い変更だそうです。Claudeはセッション開始時にこのファイルを自動的に読み込むため、TypeScriptの使用、Tailwind vs CSSモジュール、テストフォルダ構造、データモデルの関係などの規約を毎回説明し直す必要がなくなります。
重要な詳細
- 配置場所: プロジェクトディレクトリのルートに
CLAUDE.mdという名前のファイルを作成します。 - 記入内容: コーディング規約(例:「TypeScriptを使用、常に。デフォルトエクスポート禁止。Tailwind、CSSモジュールは使わない。テストはtestsフォルダに。」)に加えて、プロジェクトアーキテクチャのコンテキスト(モジュールの接続方法、データモデル、重要なファイルと足場ファイルの区別など)を含めます。
- 動作: ファイルはClaudeセッション開始時に自動的に読み込まれます。手動での呼び出しは不要です。規約は尋ねられることなく適用されます。
- 結果: ユーザーは「Claudeの編集が、セッション開始時からコンテキストが組み込まれていることで明らかに良くなった」と報告しています。
実践例
# CLAUDE.md規約
- 言語: TypeScript
- エクスポート: 名前付きエクスポートのみ(デフォルトエクスポート禁止)
- スタイリング: Tailwind CSS(CSSモジュールは使わない)
- テスト: テストは専用のtests/フォルダに配置
アーキテクチャ
- フロントエンド: React with React Router
- API層: /api内のExpressルート
- データモデル: /prisma内のPrismaスキーマ
- 重要なファイル: /src/app.ts, /src/config.ts
このファイルを追加した後、ユーザーはセッションごとにそれらのルールを再入力する必要がなくなったと報告しています。
対象者
Claude CodeやClaudeを利用したコーディングエージェントを使用しており、チャットセッション間で一貫した動作を得たいデベロッパー向けです。
📖 出典を読む: r/ClaudeAI
👀 See Also

AIに第一原理から独自の用語を定義させることで、より良い出力と監査可能な推論を実現する
r/ClaudeAIのユーザーが、未定義の用語を原子的な意味に分解してから進めるという指示を1行追加するだけで、より具体的な出力が得られ、トレース可能な推論チェーンによるデバッグが可能になることを発見しました。

Claude Codeワークフローポストの盲点:リカバリ、制約、権限管理
よくある「Claude Codeワークフロー」の投稿はハッピーパスばかりですが、不適切な編集からの復旧、制約の強制、権限管理といった、実運用で重要な要素が欠けています。

Claudeのコードにおける時間の幻覚をフックで修正する
ユーザーが、Claude Codeがリアルタイムクロックにアクセスできないため、不適切なタイミングで「少し休みましょう」などの提案を誤って行う問題を発見しました。修正方法は、~/.claude/settings.jsonに1行のフックを追加し、すべてのメッセージで現在時刻をClaudeのコンテキストに注入することです。

OpenClaw DiscordプロキシのREST APIタイムアウト問題に対する修正
OpenClawのDiscord接続問題で、WebSocketは接続するがREST API呼び出しが「fetch failed UND_ERR_CONNECT_TIMEOUT」エラーで失敗する場合の修正方法が報告されました。解決策には、proxy-preload.cjsファイルの作成とグローバルundiciプロキシ設定の構成が含まれます。