開発効率を劇的に向上させるツールとして注目を集めるClaude Codeですが、その真価を発揮させるにはAIへの指示出しを最適化することが欠かせません。コンテキストの消費を抑えつつ、意図通りに動かすための設定方法が公式から提示されました。本記事では、公式が推奨する指示方法と、それらの具体的な使い分けについて詳しく解説します。
いつもAIが見る「取扱説明書」の作り方
一番上のフォルダに置く「CLAUDE.md」というファイルは、AIが作業を始めるときに必ず最初に読む取扱説明書です。ここには、システムを動かす基本の命令や、フォルダの並び順、チーム全員で守るべきプログラムの書き方のルールなど、全体に関わる共通事項を書いておきます。
ただし、何でも書きすぎて説明書が長くなると、AIが読むだけで疲れてしまい、こちらの指示を正しく聞き入れなくなる原因になります。そのため、公式ページでもこのファイルの中身はできるだけ短くシンプルにまとめることが強く勧められています。
- 説明書の長さは200行以内に収めてください。
- 責任者を1人決めて、内容を定期的にチェックしてください。
- 細かい作業手順は、別の専用機能に移行させてください。
また、特定のフォルダの中だけで守らせたい細かいルールがある場合は、そのフォルダの中にだけ専用の説明書を置いておくことで、AIがそのフォルダを触ったときにだけ自動で読ませる賢い使い分けができます。
特定の場所だけで守らせたいルールを決める方法
特定の作業や、一部のファイルにだけ厳しいルールを守らせたいときは「Rules」という機能が便利です。これは全体の取扱説明書と同じくらい強い効力を持ちます。対象となるフォルダやファイルをあらかじめ指定しておけば、AIがそのファイルに触れたときだけルールを思い出す仕組みにできます。
たとえば、外部とデータをやり取りする特別なファイルを触るときには必ずデータの安全チェックを行わせたり、データベースに関わる重要なファイルは上書きせず追記だけに制限したりできます。画面のデザインに関する部品には、専用の見栄えのルールを強制することも可能です。
関係のない作業のときまで関係ないルールをAIに読ませると、頭が混乱して文字数の無駄遣いにもなります。このように、特定の場所だけで守らせたい専門的な約束事は、全体の取扱説明書とは別にして管理するのが一番賢いやり方です。
決まった作業の自動化と、AIの別部屋への隔離
何度も繰り返し行う複雑な作業の手順がある場合は、「Skills（スキル）」という機能として登録しておきます。最初は手順の名前だけをAIが覚えておき、実際にその作業を始めるときだけ詳しい手順書を読み込む仕組みです。そのため、最初の段階でAIの頭を無駄な情報でいっぱいにせずに済みます。
これとは別に、メインの会話履歴に細かな途中経過を残したくない重い作業や、別の場所で同時進行させたい仕事には「Subagents（サブエージェント）」という分身が向いています。これは完全に独立した別部屋で作業を行い、最後の結果だけを報告してくれます。これらは、作業の進み具合をどう確認したいかで使い分ける必要があります。
～スキルは Claude ができることを拡張します。SKILL.md ファイルに指示を記述すると、Claude はそれをツールキットに追加します。Claude は関連する場合にスキルを使用するか、/skill-name で直接呼び出すことができます。同じプレイブック、チェックリスト、または複数ステップの手順をチャットに何度も貼り付けるときや、CLAUDE.md のセクションが事実ではなく手順に成長したときにスキルを作成します。～
人間が途中のプロセスをその都度チェックしながら進めたいお決まりの業務はSkillsに任せ、膨大なログデータの分析やエラーの洗い出しなど、途中の計算や経過が多すぎて画面が埋まってしまうような作業はSubagentsに丸投げして隠しておくのが最も効率的な選択です。
自動で動く仕掛けと、お好みの話し方に変える方法
AIのあいまいな判断に頼らず、決まった動作を100パーセント確実に実行させたいときは「Hooks（フック）」という機能を使います。これは、ファイルの中身を書き換えた瞬間や、特定の命令を出す直前など、あらかじめ決めたタイミングに合わせて自動で発動する仕掛けのことです。
たとえば、ファイルを修正した後に自動で文章の見た目をキレイに整えさせたり、間違えて危険な命令を出そうとしたときに強制的にストップをかけたりできます。言葉で「守ってね」とお願いするよりも、仕組みとして強制できるためうまく指示すれば失敗がほとんどありません。
また、AIの返事の長さや雰囲気を一時的に自分好みに変えたい場合は、追加の注文をつけて話し方のスタイルを調整することも可能です。ここまでにご紹介した各機能の特徴と、どんな場面で使うべきかを下の表にわかりやすく整理しました。
| 設定の名前 | 読み込まれるタイミング | AIの頭の負担 | こんなときにおすすめ |
|---|---|---|---|
| 全体の取扱説明書（CLAUDE.md） | 作業を始めるとき（ずっと覚えている） | 大きいです。 | 基本の命令や全員で守るルールを記述します。 |
| 場所ごとの約束（Rules） | 指定したファイルを触ったとき | 小〜中です。 | 特定のファイルだけに守らせたい制約に向いています。 |
| お決まりの作業手順（Skills） | 作業を呼び出したとき | 小さいです。 | 公開の手順や確認用のチェックリストを登録します。 |
| 別部屋の分身（Subagents） | 個別の重い仕事を頼んだとき | 小さいです。 | 膨大なデータの分析や別の並行作業を任せられます。 |
| 自動の仕掛け（Hooks） | 特定の出来事が起きたときに自動で動く | ほとんどありません。 | 文字の自動修正や危ない命令の遮断に最適です。 |
やってはいけない！公式が注意する3つの失敗例
便利な設定機能がたくさんあるからこそ、公式ページが警告している間違った使い方をしないように気をつけなければなりません。よくある失敗として、取扱説明書に「ファイルを編集したら必ず文字をキレイに並び替えて」と文章でお願いしてしまうケースがあります。
言葉での頼みごとは、会話が長くなったりAIに余裕がなくなったりすると、見落とされてしまう危険があります。どうしても自動で行わせたい作業は、文章で頼むのではなく、先ほどご紹介した「自動の仕掛け（Hooks）」を使って仕組みとして強制させるのが正しいやり方です。
また、絶対にやってはいけない禁止事項を文章だけで縛ろうとすることや、30行を超えるような長い作業手順をすべて最初の取扱説明書に詰め込んでしまうことも避けるべきです。一部のファイルにしか使わない細かいルールを、いつでもAIに読ませる状態にしておくのも頭の無駄遣いになります。
これらの一見便利そうな設定は、AIの頭をパンクさせてお利口度を下げてしまう最大の原因になります。ふさわしい場所に、必要な長さだけ約束事を書いておくことが、AIを最高に賢く動かすための絶対の決まりごとです。
筆者の感想
今回の記事を執筆しながら、AIを使いこなすコツは「魔法の言葉を探すこと」から「仕事の仕組みを整えること」へと完全に変わってきているのだと、私自身も深く納得させられました。AIの力を100パーセント引き出すためには、指示を出す人間側が、あらかじめ仕事の手順をわかりやすく整理しておく力が何よりも大切になります。
ただプロンプトを工夫する段階を超えて、これからは業務の設計そのものを見直す視点が欠かせません。なかでも特に重要だと感じたのは、言葉でおねがいする限界を知り、機械的な自動化と上手に組み合わせる点です。
人間を相手にするときと同じで、あれもこれもと文章で要求を詰め込みすぎると、AIはかえって混乱してしまいます。言葉で縛る部分と、仕組みで強制する部分をきっちり分けることが、実務でのミスや見落としをなくす確実な近道です。また、必要なときに必要な分だけルールを読ませる仕掛けは、たくさんの仕事を同時に進める現場でとても役に立つと感じます。
今回紹介した整理やルール化は、最初は少し手間に思えるかもしれません。しかし、一度しっかりとした「仕組み」を作ってしまえば、その効果はずっと続きます。AIをただの便利な道具で終わらせず、本当に頼れる仕事のパートナーとして長く付き合っていくために、ぜひ今回ご紹介した手法を試してみてください。この記事があなたの仕事や趣味に役立てば幸いです。
まとめ
AIを上手に動かすためには、役割に合わせた設定の使い分けがとても大切です。基本の約束事は取扱説明書（CLAUDE.md）に書き、一部のファイルだけで守るルールはRules、決まった作業の手順はSkillsへと分けておきます。また、確実に行いたい自動化にはHooksを使い、AIの頭をスッキリさせておくことで、最も賢い状態で働いてもらうことができます。
あとがき
設定を整えてAIの精度が安定すれば、雑務やエラー対応から解放され、大切な仕事に集中できます。平日の夜に急な予定変更があっても、作っておいたSkillsやHooksが面倒な確認を代わりに終わらせてくれるため、夜遅くまで無理をする必要がなくなります。まずは、200行以内の短い取扱説明書をひとつ作り、基本の命令を覚えさせましょう。
コメント