背景

この連載では、Claude Codeの公式ドキュメントを1ページずつ読み解いていきます。公式ドキュメントは情報が網羅されている分、「結局どの機能を、どんな場面で使えばいいのか」は自分で考える必要があり、読むのに意外と時間がかかります。そこで、私が実務で使うために読み込んだ内容を「使う場面→実例コード」の順に整理して残していくことにしました。専門家の解説というより、一次情報を読んだ記録です。推測や動作を確認していない部分には、その都度そう書きます。

1. これは一言でいうと何か

このページは、日常的な開発のための短いレシピ集です。コードベースの探索、バグ修正、リファクタリング、テスト、PR 作成、ドキュメント整備といったタスクごとに、プロンプトのパターンが並んでいます。

ここまでの連載が機能を1つずつ扱ってきたのに対し、今回はそれらを実際の作業手順に落とす回です。プロンプティングとコンテキスト管理の高度なガイダンスは別途「ベストプラクティス」ページに委ねられています。

2. どういう場面で役立つか

• 新しいプロジェクトに参加した直後：広い質問から始めて特定の領域に絞り込みます。コーディング規約やパターン、プロジェクト固有の用語の用語集も聞けます。
• エラーの原因を追いたい：再現コマンドとスタックトレース、再現手順、そして断続的か一貫しているかを伝えるのがコツとして挙げられています。
• 並行作業したい：1つのターミナルで機能開発、別のターミナルでバグ修正を、編集を衝突させずに進めます。
• CI やプリコミットフックに組み込みたい：非対話モードで stdin / stdout を通常の Unix ツールのように扱えます。

あまり効かないケース・注意点。

1. ノートやドキュメントのフォルダでも動きます。 Claude Code はどのディレクトリでも機能し、マークダウンの集まりをコードと同じように検索・編集・再編成できます。「コード専用」と思って使わないのは機会損失です。
2. スケジュール実行では曖昧なプロンプトが致命的になります。 自律実行のため質問して確認できないので、成功の定義と結果の扱いを明示する必要があります。
3. PR は送信前に必ずレビューしてください。 ページも Claude に潜在的なリスクや考慮事項を強調させることを勧めています。

3. コード・コマンドの実例と解説

前提条件

• レシピの各パターンは任意の Claude Code サーフェスで機能します。プロジェクトに合わせて表現を調整することが前提です。
• モノレポや大規模コードベースでの設定は別ページ（「モノレポと大規模リポジトリ」）に分かれています。

コードベースを把握する

give me an overview of this codebase

プロジェクトルートで claude を起動してから投げます。ここから explain the main architecture patterns used here、what are the key data models?、how is authentication handled? のように絞り込んでいくのが基本形です。

関連コードを探すなら find the files that handle user authentication から始め、how do these authentication files work together? で関係を把握し、trace the login process from front-end to database で実行フローを追います。プロジェクトのドメイン言語を使うのがコツです。言語のコードインテリジェンスプラグインを入れておくと、「定義に移動」「参照を検索」の正確なナビゲーションを Claude に与えられます。

バグを修正する

I'm seeing an error when I run npm test

エラーを共有し、suggest a few ways to fix the @ts-ignore in user.ts で修正案を複数出させ、update user.ts to add the null check you suggested で適用する、という3段階です。いきなり直させるのではなく案を並べさせてから選ぶ構成になっている点に注目してください。

テストを追加する

find functions in NotificationsService.swift that are not covered by tests

未カバー箇所の特定 → add tests for the notification service でスキャフォールディング → add test cases for edge conditions in the notification service でエッジケース追加 → run the new tests and fix any failures で検証、という流れです。

Claude は既存のテストファイルを調べて、使われているスタイル・フレームワーク・アサーションパターンに合わせます。 網羅性を上げたいなら、見落としたエッジケースを特定するよう明示的に依頼すると、エラー条件・境界値・想定外の入力を提案してくれます。

ファイルを @ で参照する

Explain the logic in @src/utils/auth.js

読み込みを待たずにファイル内容を会話に含めます。ディレクトリを指定するとファイル一覧（内容ではなく）が得られ、@github:repos/owner/repo/issues のような @server:resource 形式で MCP リソースも参照できます。

見落としやすい挙動が1つあります。@ によるファイル参照は、そのファイルのディレクトリと親ディレクトリの CLAUDE.md もコンテキストに追加します。 1つのメッセージで複数ファイルを参照することも可能です。

並列セッションを走らせる

claude --worktree feature-auth

各 worktree は独自ブランチ上の個別チェックアウトなので、編集が衝突しません。別のターミナルで別名を指定すれば、分離された並列セッションになります。

編集前に計画する

claude --permission-mode plan

ファイルを読んで計画を提案し、承認されるまで編集しません。セッション中なら Shift+Tab でも切り替えられます（第15回参照）。

調査をサブエージェントに逃がす

use a subagent to investigate how our auth system handles token refresh

大規模コードベースの探索はファイル読み込みでコンテキストを埋めます。サブエージェントは独自のコンテキストウィンドウで読み、要約だけを報告します（第9回参照）。

スクリプトにパイプする

git log --oneline -20 | claude -p "summarize these recent commits"

CI、プリコミットフック、バッチ処理向けです。stdin と stdout が通常の Unix ツールと同じように機能するため、既存のパイプラインに素直に載ります。

その他（画像の3つの渡し方と分析プロンプト、リファクタリングとドキュメントの各レシピ、/powerup のインタラクティブレッスン、claude --continue / --from-pr の詳細）は公式ドキュメントを参照してください。

4. まとめと次回予告

• レシピの骨格は共通です。特定 → 提案 → 適用 → 検証の4段階に分けると、どのタスクでも安定します。
• 探索はサブエージェント、変更前は計画モード、並行作業は worktree。機能の使い分けが手順に落ちています。
• @ 参照、画像、パイプなど、入力の渡し方の選択肢を知っておくと手数が減ります。

スケジュール実行の選択肢は、実行場所で選びます。 コンピュータがオフでも走らせたいならルーチン（Anthropic 管理インフラ）、ローカルファイルやコミットされていない変更への直接アクセスが要るならデスクトップのスケジュール済みタスク、リポジトリイベントや設定と同居させたい cron なら GitHub Actions、セッションが開いている間のクイックポーリングなら /loop です。最後のものは新しい会話を始めると停止する点に注意してください。

Claude 自身に機能を尋ねられることも覚えておくと便利です。how does Claude Code handle permissions? や what are the limitations of Claude Code? のような質問に、ドキュメントベースで答えます。使用しているバージョンに関係なく、常に最新のドキュメントにアクセスできるとされています。この連載で扱いきれなかった細部を確認する手段としても使えます。

次回予告：連載の締めくくりとして「ベストプラクティス」を取り上げる予定です。

関連ページ（本記事で触れた概念の詳細）：プロンプティングとコンテキスト管理 →「ベストプラクティス」、再開・命名・分岐 →「セッションを管理する」、クリーンアップと .worktreeinclude →「worktree」、カスタムエージェントの定義 →「サブエージェント」、出力形式と許可フラグ →「非対話モード」、大規模構成 →「モノレポと大規模リポジトリ」、並列セッションの監視 →「バックグラウンドエージェント」。

---

本記事は執筆時点の公式ドキュメント（一般的なワークフロー）に基づきます。最新は公式ドキュメントをご確認ください。