Claude Codeの/initコマンドで最初の設定ファイルを作る

Claude Codeに新しいプロジェクトを触らせる時、最初の1〜2分は決まって戸惑います。「このフォルダ、何のプロジェクトなんだろう」とClaude側が探りを入れてくる時間です。

ここを一気にショートカットできるのが、/init という最初のコマンドです。

はじめてのプロジェクトで「Claudeに迷子になる」

Claude Codeをはじめて触る人が、よくつまずく場面があります。プロジェクトのフォルダに移動して claude と起動した直後、「で、何を頼めばいい?」と固まる瞬間です。

Claude側も、フォルダの中身をちらっと見るだけでは、何を期待されているか分かりません。指示があいまいだと回答もあいまいになる。初日の私もここで30分溶かしました。

この立ち上がりの摩擦を、ぐっと減らすのが /init の役目です。

/init をClaude Codeのプロンプトで打つと、Claudeがフォルダの中を勝手に走査し、プロジェクトの性格を把握したうえで、CLAUDE.md という設定ファイルを書いてくれます。

CLAUDE.mdは、Claude Codeに「このプロジェクトの前提」を伝えるファイル。何の言語で書かれたプロジェクトか、どのコマンドで動かすか、避けてほしいことは何か、といった内容を書く約束の場所です。

Claude Code overview - Claude Code Docs

Claude Code is an agentic coding tool that reads your codebase, edits files, runs commands, and inte

通常はゼロから人間が書きますが、/init は「とりあえずのたたき台」を自動で生成してくれます。下書きが手に入る、という気軽さです。CLAUDE.md自体の書き方は別記事に整理してあります。

CLAUDE.mdの書き方テンプレート

私が新しいプロジェクトでやっている手順です。

特に5番が大事です。/init の結果はあくまで初稿。プロジェクトの細かい流儀(コミットメッセージの規約、業務固有の用語、避けるべき書き方)までは推測できないので、人間が足します。

/init で出てきたCLAUDE.mdを、私はだいたい次の方針で直します。

不要な部分を削る — 自動生成は丁寧すぎて、ありきたりな注意書きが長くなりがちです。読むのに時間がかかるCLAUDE.mdは、結局誰も読まなくなる。半分くらいに圧縮するつもりで削る。

業務固有の前提を足す — 顧客名の表記ゆれ、社内の略語、過去にやらかしたミス。これらは自動では出てきません。書き足す価値が大きい部分です。

参考リンクを差す — 公式ドキュメントや、関連する社内文書のURLを足しておく。Claudeが迷った時にそこを読んで自己解決してくれます。

/init がよく効くのは、ある程度ファイルが揃っているプロジェクトです。コードや設定ファイルから、Claudeが性格を読み取る材料があるからです。

逆に、立ち上げたばかりで中身が空っぽに近いフォルダだと、/init してもClaudeが書けることが少なく、結果は薄くなります。この場合は素直に人間が初稿を書いたほうが早い。

私の感覚では、ファイルが20個以上ある既存プロジェクトには /init を、新規の真っ白なフォルダには手書きを、という使い分けに落ち着いています。

最後に、安心材料を。

/init は一度きりのコマンドではありません。プロジェクトが育って性格が変わった時に、もう一度走らせて、新しい初稿との差分を見るのは有効です。書き直すというより「現状をClaudeから見直してもらう」感覚で使えます。

完璧なCLAUDE.mdを最初から目指す必要はありません。/init で叩き台を作り、使いながら育てる。これがいちばん肩の力が抜ける付き合い方です。