こんにちは、ヒロです。
入門編でClaude Codeの基本操作に慣れたら、次に覚えたいのが中級者向けの機能です。この記事では、作業の効率をぐっと上げる使いこなし方を、私の失敗談もまじえて解説します。
結論から言うと、中級機能の核心は「単発の質問と回答」を超えて、「継続的な作業をまかせる」ことにあります。ファイルをまたいだリファクタリング、テストの自動生成、プロジェクト固有のルール設定が、その中心です。
結論：CLAUDE.mdで「プロジェクト専用のAI」に育てる
とくに効くのがCLAUDE.mdです。プロジェクトのルールを書いておくと、毎回同じ説明をしなくても、そのルールに沿って動いてくれます。
私も最初は、毎回「コミットメッセージは日本語で」と頼んでいました。CLAUDE.mdに1行書いてからは、その一言すら要らなくなりました。
中級機能が大事な理由：入門から一歩進む3つの理由
| 入門のころ | 中級機能を使うと | |
|---|---|---|
| 作業の単位 | 1つのファイルの修正 | 複数ファイルにまたがる変更 |
| ルールの伝え方 | 毎回、口頭で説明する | CLAUDE.mdに書いて、自動で読み込ませる |
| テスト | 自分で書いて、自分で実行する | 生成・実行・修正までを任せる |
| 確認の方法 | 出力を目で追う | 差分を見ながら、段階的に承認する |
一覧にすると、「頼める範囲が広がる」ことが中級機能の本質だと分かります。その分、確認の仕方も一段上げる必要があります。
理由①：複数ファイルにまたがる作業が一括で終わる
入門のうちは「このファイルのこの部分を直して」という単ファイルの操作が中心です。でも実際の開発では、1つの変更が10個のファイルに響くことも珍しくありません。
中級機能を使うと、「認証の仕組みをセッションからJWTに変えて、関連するファイルもすべて直して」といった指示で、プロジェクト全体にまたがる変更を進められます。変更内容を確認しながら進めれば、手作業で数時間かかる作業が短くなります。
理由②：テストの自動化でコードの品質が上がる
「テストを書くのが面倒」という悩みも、Claude Codeが肩代わりしてくれます。「このファイルのユニットテストを書いて、境界値も含めて」と頼めば、網羅的なテストが生成されます。
さらに「テストを実行して、失敗したものを直して」と続けると、実行から修正までを繰り返してくれます。
理由③：ルールを覚えさせると毎回の説明が要らなくなる
CLAUDE.mdは、プロジェクトのルート(一番上のフォルダ)に置くマークダウンのファイルです。Claude Codeがセッションのはじめに読み込む、プロジェクト専用の指示書だと考えてください。
中級機能の実践ガイド：主な7つの機能
機能①：CLAUDE.mdでプロジェクトをカスタマイズする
作り方は簡単です。プロジェクトのルートに「CLAUDE.md」というファイルを置き、次のような内容を書きます。
- 使っている技術(言語・フレームワーク・ライブラリ)
- コーディングの約束事(名前の付け方・インデント・コメントの書き方)
- テストの方針(使うフレームワーク・目標カバレッジ)
- コミットやブランチの命名ルール
- このプロジェクト固有の注意点や禁止事項
# プロジェクトのルール
- 言語はTypeScript。エラー処理はtry-catchで行う
- コミットメッセージは日本語で書く
- テストはVitestを使い、新しい関数には必ずテストを追加する
- 本番用の設定ファイル(.env)は編集しない書き方の例です。このくらいの短さから始めて十分です。
最初から完璧に書く必要はありません。「毎回同じことを伝えているな」と気づいたら、1行ずつ足していくのが続けるコツです。チームで使うなら、CLAUDE.mdをGitに入れて全員で共有しておくと、同じ設定でAIを使えます。
雛形が欲しいときは、プロジェクトで「/init」を実行すると、コードを読んで下書きを作ってくれます。
機能②：複数ファイルの編集とリファクタリング
Claude Codeは、起動したフォルダの中のファイルを読み取り、全体の流れを理解したうえで作業します。大きなリファクタリングの前には、「作業の前にgitでコミットしておいて」と伝えておくと安全です。
万が一、意図と違う変更になっても、git revertで元に戻せます。はじめは「このプロジェクトのコードを読んで、改善点を3つ提案して」と聞くところから入るのがおすすめです。
機能③：テストの生成と自動実行
テスト駆動開発(TDD)との相性もいいです。「先にテストを書いて、それが通る実装を書いて」と頼むと、TDDのサイクルを回してくれます。
「いまのテストカバレッジを確認して、カバーされていない重要な部分にテストを追加して」と頼めば、テストの穴も埋めてもらえます。
機能④：コードレビューとセキュリティチェック
優秀なレビュアーとしても使えます。「セキュリティ上の問題点を指摘して」「パフォーマンスのボトルネックを探して」と頼めば、改善案つきで返ってくれます。
専門知識が浅くても、一定の水準を保ちやすくなります。ただし最終判断は自分で行い、重要なコードは人の目でも確認してください。
機能⑤：ドキュメントの自動生成
「READMEを日本語で作って」「各関数に説明コメントを追加して」といった指示で、ドキュメントも短時間で形になります。書く手間がなくなると、将来の自分やチームメンバーがとても助かります。
機能⑥：サブエージェントで作業を分担させる
公式ドキュメントでは、複数のエージェントに作業を分担させる「サブエージェント」の仕組みが紹介されています。たとえば「調査担当」と「実装担当」を分けると、長い作業でも指示が混ざりにくくなります。
まずは1つのタスクで、小さく試すのがおすすめです。
機能⑦：フックとMCPで、自分の道具につなぐ
「フック」は、Claude Codeの動作の前後にシェルコマンドを自動で実行する仕組みです。ファイルを編集するたびに自動で整形する、といった使い方ができます。
「MCP」は、外部のサービスやデータにつなぐための標準的な規格です。設計書やチケット管理など、普段使う道具とつなげると、できることが一気に広がります。
中級者向けコマンド・設定の一覧
| コマンド・設定 | 役割 | 使いどころ |
|---|---|---|
| /init | CLAUDE.mdの下書きを作る | 新しいプロジェクトを始めたとき |
| /compact | 会話を要約してコンテキストを節約する | 長い作業セッションの途中 |
| /clear | 会話をリセットする | 別のタスクに切り替えるとき |
| /memory | 保存されたメモリの確認・編集 | ルールを見直したいとき |
| /doctor | 設定や環境の診断 | 動作がおかしいと感じたとき |
| --dangerously-skip-permissions | 確認なしで実行する自律モード | 信頼できる自動化だけに限定(本番環境では使わない) |
最後の「--dangerously-skip-permissions」は名前のとおり、確認をすべて飛ばします。便利ですが、取り返しのつかない操作も止められなくなるので、私は安全な検証用の環境でしか使いません。
私の使い方と失敗談：小さく頼んで、確認してから進める
以前、「このプロジェクト全体をTypeScriptに書き換えて」と一度に頼んで、確認が追いつかなくなったことがあります。変更が膨大で、どこが正しいのか判断できませんでした。
それ以来、「まず設計を提案して」「確認してから実装して」と段階を分けるようにしました。あわせて、作業前のコミットを必ず入れています。小さく頼んで、確認して、次へ進む。これが一番早い近道でした。
| 手順 | 私の頼み方 | ねらい |
|---|---|---|
| ① | 作業の前に、gitでコミットしておいて | 失敗しても元に戻せるようにする |
| ② | まず設計を提案して。実装はまだしないで | 方向性のずれを早めに見つける |
| ③ | その設計で実装して。変更したファイルを一覧にして | どこが変わったかを把握する |
| ④ | テストを実行して、失敗したものを直して | 品質をその場で確認する |
| ⑤ | 変更点をレビューして、気になる点を指摘して | 見落としを減らす |
1日の作業は、この5ステップの繰り返しです。毎回同じ流れにしておくと、頼み方で迷わなくなります。
よくある質問（FAQ）
CLAUDE.mdは、どのくらい詳しく書けばいいですか？
最初はシンプルで大丈夫です。使いながら「毎回同じことを伝えているな」と気づいた内容を足していきましょう。長くなりすぎると読み込みの負担も増えるので、数十行〜100行ほどを目安に整理するのがおすすめです。
大規模なリファクタリングで失敗しないコツはありますか？
作業の前に必ずgitでコミットしておくことが鉄則です。一度に大きく変えず、「設計を提案→確認→実装」と段階的に進めると安全です。
テスト生成の精度はどのくらいですか？
基本的なケースは高い精度で作れます。外部APIやデータベースに依存するテストは、モックの設定が必要になることがあります。「モックが必要な部分を指摘して設定して」と頼むと対応してくれます。
Claude Codeを使うには何が必要ですか？
公式ドキュメントでは、Claudeの有料プランのサブスクリプション、またはAnthropic Consoleのアカウントが必要と案内されています。最新の条件は公式ドキュメント(英語)で確認してください。
まとめ：中級機能でClaude Codeは「プロジェクトの相棒」になる
- CLAUDE.mdでプロジェクト専用のルールを設定できる
- 複数ファイルにまたがるリファクタリングも一括で進められる
- テストの生成から実行・修正までを任せられる
- サブエージェント・フック・MCPで、さらに作業範囲を広げられる
中級機能を使いこなすと、Claude Codeは「コードを書くツール」から「プロジェクトを一緒に進める相棒」に変わります。
次の一歩として、ビジネスや副業に直結させる実践テクニックをClaude Code上級編(副業・実践)でまとめています。あわせて読んでみてください。