Claude Code活用のコツ8選｜CLAUDE.md

Claude Code、動かせてはいますよね。コードも生成されるし、便利だし。

でも現場を見ていると、同じツールで成果が数倍違う人たちがいます。差は課金額ではなく、いくつかの「仕組みの理解」なんです。今回は、「使えている」と「任せられている」の分かれ目になる8つを集めました。1つでも知らなかったら儲けものです。

① CLAUDE.mdは、「AIに渡すルールブック」です

まず、いちばん効く1枚から。

プロジェクトの置き場所にCLAUDE.mdというファイルを置くと、Claude Codeはセッションの開始時にそれを読み込み、作業の前提にします。

つまりここに「このプロジェクトの命名規則」「使うライブラリ」「やってはいけないこと」を書いておけば、毎回のプロンプトで同じ説明を繰り返す必要がなくなるんです。

新しいメンバーに渡す開発ルールのドキュメント、あれのAI版。書いた人から、AIの出力が安定し始めます。

② /compact の正体は、「会話の要約圧縮」です

打ったことはあっても、中で何が起きているか知っていますか。

AIが覚えていられる会話量には上限があります。/compactは、ここまでの会話を要約して、容量を空けるコマンドです。

大事なのは、要約＝細部が落ちるということ。だから打ちどきは「タスクの区切り」が正解です。作業の途中で圧縮すると、直前の細かい文脈が薄まって、急に噛み合わなくなる。

上限が来て自動で圧縮されるのを待つのではなく、区切りで自分から打つ。会話の管理も、操作のうちなんです。

③ 毎回書くプロンプトは、Skillにできます

「テストも書いて。命名はこの規則で。終わったら差分をまとめて」——毎回同じことを打っていませんか。

繰り返し使う依頼は、Skillという形でファイル（SKILL.md）に保存できます。一度書けば、呼び出すだけで同じ品質の依頼が再現される。

これ、実は仕事の資産化そのものなんですよね。上手い人のプロンプトが、個人の技からチームの共有物になる。

「良い頼み方」を、書き捨てずに貯める。差が開く仕組みの正体は、これです。

④ 補完AIとエージェント型は、別の生き物です

AIコーディング支援——ひとくくりにすると、本質を見失います。

最近は補完が中心だったツールにもエージェント機能が入り、境目は道具ではなく「使い方」になってきました。そして「任せ方の設計」を誰にも教わっていない人が、いま一番多いんです。

⑤ 差分を見ない運用は、いつか破綻します

AIが「修正しました」と言ってきたとき、そのまま受け入れていませんか。

エージェント型は有能ですが、ときどき頼んでいない場所まで「良かれと思って」変えます。差分（diff）を見ずに積み重ねると、ある日「なぜか動かない、しかも原因の変更がどれか分からない」状態になります。

定石はシンプルで、変更のたびに差分を確認してから確定する。小さく任せて、小さく確かめる。

信頼は、確認の習慣の上に成り立つ——人間のチームと同じなんです。

⑥ いきなり書かせず、「計画」を先に出させます

任せ方が上手い人の共通点が、これです。

大きめのタスクを頼むとき、いきなり実装させません。「まず、どう進めるかの計画を出して」と頼み、その計画を人間がレビューしてから、実行させる。Claude Codeには、この進め方専用のプランモードも用意されています。

計画の段階なら、方向違いの修正は一言で済みます。実装後の手戻りは、その何十倍のコストです。

これ、部下への仕事の任せ方と完全に同じなんですよね。レビューは成果物より、方針に対して早く入れる。AIにも効くんです。

⑦ 長い会話ほど賢い、は半分誤解です

「文脈をたくさん共有しているほど、AIは分かってくれる」——実は、落とし穴があります。

会話が長くなると、過去の誤解や失敗した提案も、文脈として引きずり続けます。さらに長い文脈は、真ん中の情報が読み落とされやすいことも知られています。

だから上級者は、こじれたら新しいセッションで仕切り直します（/clear）。そのとき効くのが①のCLAUDE.md。前提はファイルが覚えているので、会話を捨てても文脈は再現できる。

会話は使い捨て、前提はファイルに。この分担が分かると、運用が一気に安定します。

⑧ 失敗した指示は、「やらないことリスト」になります

最後は、一番「ほぉー」かもしれません。

AIへの指示がうまくいかなかったとき、それで終わりにしない。「この方法は使わない」「このライブラリは入れない」とCLAUDE.mdに書き足すんです。すると次から、AIは同じ失敗をしなくなります。

つまりCLAUDE.mdは、成功の記録であると同時に失敗の学習帳でもある。使い込むほどAIが自分のチームに馴染んでいく——「育てる」という感覚の正体は、これなんです。

番外編：小さいけれど効く3つ

途中で止めていい
AIが変な方向に走り始めたら、完了を待たずに止めて指示し直す方が速いです。止めるのも操作のうちです。

「なぜそう直した？」と聞ける
修正の理由を説明させると、AIの誤解が早めに見つかります。無言で受け入れない、が定石です。

最初の一歩は、小さいタスクから
いきなり本体を任せず、テスト追加やリファクタリングのような「壊れても戻せる仕事」から。信頼の積み方も、人と同じなんですよね。

RJCでは、ここまでを90分のセミナーにしています

RJCは研修の最終レベルがAI駆動開発で、人材業界向けの25名規模のプロジェクトや金融業界向けのJava 21のプロジェクトでも、AI駆動開発を取り入れて開発しています。

そして今日の8つの先——CLAUDE.mdとSkillsの実物、信頼を失わない「任せ方」の習慣——を、無料のオンラインセミナー（Zoom 90分・営業なし）でお話ししています。日程はLINEでご案内しています。

▶ LINE登録（セミナー日程のご案内）はこちら：https://lin.ee/UBDbsEf
友だち追加のあと、トークで「特典ください」と送っていただくと、RJCで実際に使っているプロンプト集とSKILL.mdの実物もお渡ししています。

よくいただくご質問

Q. CLAUDE.mdには、まず何を書けばいいですか？
A. 3つで十分です。「プロジェクトの概要」「使う技術と規則」「やらないこと」。⑧のとおり、あとは運用しながら書き足していくものなんですよね。

Q. Claude Codeをまだ触ったことがないのですが…
A. 大丈夫です。④の「補完型との違い」から分かれば、初日から迷いません。セミナーでも、その違いの説明から始めています。

Q. チームに広めるには、どこから始めるべきですか？
A. ①と③です。CLAUDE.mdとSkillは個人の技をチームの資産に変える仕組みなので、ここが共有の土台になるんですよね。

Q. 未経験からでも、使いこなせるようになりますか？
A. なります。RJCの研修では、まず自分の手で設計・実装・テストを回してから、同じサイクルをAIと組む順番です。土台がある人ほど、AIは強い道具になるんです。

「使う」と「任せる」の間に、この8つがあります

今日の8つに共通していたのは、これでした。

ツールの操作を覚えることと、仕事を任せられることは、別のスキルです。ルールを書き、区切りを管理し、計画に先にレビューを入れ、失敗を学習帳に変える。

全部、人間のチームでやってきたことなんですよね。マネジメントの経験がAIに効く時代が、もう来ています。