Claude CodeのinitでCLAUDE.mdを作る

入門 | 11分 で読める | 2026.06.17

公式ドキュメント
実演Claude CodeCLAUDE.md初期設定

今回やること

この記事では、Claude Codeの /init を使って、プロジェクト用の CLAUDE.md を作る流れを確認します。

/initは便利ですが、生成されたCLAUDE.mdをそのまま信用せず、人間が必ず確認します。

前提条件

  • Claude Codeを起動できる
  • 学習用または作業用プロジェクトがある
  • Gitで差分を確認できる
  • 既存の重要な指示ファイルがある場合は先にバックアップや差分確認をする

Step 1: プロジェクトルートで起動する

cd your-project
claude

プロジェクトルートで起動する理由は、ビルド設定、テスト設定、ディレクトリ構成を見つけやすくするためです。

Step 2: initを実行する

Claude Codeのセッション内で実行します。

/init

公式ドキュメントでは、/init によりプロジェクトを分析し、CLAUDE.md の開始点を作れることが説明されています。

Step 3: 生成内容を確認する

生成されたら、まず差分を見ます。

git diff -- CLAUDE.md

確認するポイントは次の通りです。

観点確認すること
コマンドbuild/test/lintが正しいか
技術スタック古い情報や誤認がないか
禁止事項危険操作を防ぐ内容があるか
長さ長すぎないか
秘密情報認証情報が入っていないか

Step 4: 足りない情報を追加する

生成内容に足りないルールを追加します。

## 作業ルール

- 変更前に関連ファイルを読む
- 大きな変更では先に計画を出す
- 変更後に `npm run build` を実行する
- 実行できない場合は理由を報告する

曖昧な「いい感じに」ではなく、確認可能な行動にします。

Step 5: AGENTS.mdがある場合

すでに AGENTS.md があるリポジトリでは、CLAUDE.md から取り込む形も考えられます。

@AGENTS.md

## Claude Code固有ルール

- `/init` で生成された内容は人間が確認する
- 危険なコマンドは実行前に確認する

複数のAIツールを使う場合、共通ルールを重複管理しないことが重要です。

よくあるエラー

エラーよくある原因確認すること
生成内容が長すぎる自動検出結果を入れすぎている常時必要な内容だけ残す
コマンドが間違っているプロジェクト固有設定の誤認package.jsonやREADMEで確認
古い情報が混ざる既存ドキュメントが古い人間が整理する
秘密情報が入る設定ファイルを読ませた差分を確認して削除

まとめ

/init は、CLAUDE.md のたたき台を作るのに便利です。ただし、自動生成された内容は必ず人間が確認します。コマンド、技術スタック、禁止事項、秘密情報、長さを見直し、常に必要なルールだけを残します。

参考リソース

おすすめ記事

← 一覧に戻る
PR
PR
PR
PR