Claude Code、つまずきポイントを先に知っておく

Claude Codeを使い始めた実践者のあいだで、初期段階でのつまずきが話題になっています。ツールの機能以前に、前提となる概念を知らないまま触り始めるケースが多いようです。

押さえておくべきは次の4つです。

CLAUDE.md：Claudeに毎回読ませる指示メモ。プロジェクトのルールや作業スタイルをここに書いておくと、セッションをまたいでも一貫した動きを引き出せます。いわば「この現場の作法書」です。

コンテキスト：Claudeが一度に覚えていられる情報量の上限。これを超えると、会話の冒頭で伝えた指示を忘れます。長いセッションで「なぜか指示を無視される」と感じたら、コンテキスト枯れを疑うのが先決です。

ハルシネーション：AIがそれらしい嘘を書く現象。コードの場合、存在しないメソッドを自信満々に書いてくることがあります。動作確認を挟まずに信用するのは禁物です。

権限モード：Claudeにどこまで自律的に動かせるかの設定。ファイルの読み書き・コマンド実行など、許可する範囲を最初に決めておかないと、意図しない操作が走ることがあります。AIに作業ごと渡す時代、セキュリティだけ自分で守れで触れた権限管理の話と重なる部分です。

4つの概念の中で、即効性が高いのがCLAUDE.mdの活用です。多くの初心者はまずClaude Codeを起動して、チャット欄に指示を打ち込み始めますが、その順番が非効率につながります。

CLAUDE.mdはプロジェクトルートに置くマークダウンファイルで、Claudeはセッション開始時に自動で読み込みます。ここに「コードには必ずコメントを入れる」「変数名は英語スネークケース」「確認なしにファイルを削除しない」といった作業ルールを書いておくことで、毎回同じ指示をチャットで繰り返す手間が省けます。

もう一つの効果がコンテキスト節約です。チャット内で繰り返し書く指示はコンテキストを消費しますが、CLAUDE.mdに逃がすことで、長いセッションでもコンテキストを消耗しにくくなります。「中盤から急に挙動がおかしくなる」という経験は、多くの場合コンテキスト枯れです。CLAUDE.mdを事前に整備しておくと、それを緩和できます。

「プロンプトは終わった」—現場が示す次の一手でも取り上げたように、一発のプロンプトより「環境ごと設計する」発想が今の実践では重要になっています。CLAUDE.mdはその最初の一歩です。