メインコンテンツへスキップ
このページでは、日常的な開発のための短いレシピを集めています。プロンプティングとコンテキスト管理に関する高度なガイダンスについては、ベストプラクティスを参照してください。 このページでは以下をカバーしています:

プロンプトレシピ

これらは、未知のコード探索、デバッグ、リファクタリング、テスト作成、PR 作成などの日常的なタスク用のプロンプトパターンです。各パターンは任意の Claude Code サーフェスで機能します。プロジェクトに合わせて表現を調整してください。

新しいコードベースを理解する

モノレポまたは大規模なコードベースで Claude Code を設定する場合は、モノレポと大規模リポジトリを参照してください。

コードベースの概要を素早く把握する

新しいプロジェクトに参加したばかりで、その構造を素早く理解する必要があるとします。
1

プロジェクトルートディレクトリに移動する

cd /path/to/project 
2

Claude Code を起動する

claude 
3

高レベルの概要をリクエストする

give me an overview of this codebase
4

特定のコンポーネントについてさらに詳しく調べる

explain the main architecture patterns used here
what are the key data models?
how is authentication handled?
ヒント:
  • 広い質問から始めて、特定の領域に絞り込んでいく
  • プロジェクトで使用されているコーディング規約とパターンについて質問する
  • プロジェクト固有の用語の用語集をリクエストする

関連するコードを見つける

特定の機能または機能に関連するコードを見つける必要があるとします。
1

Claude に関連ファイルを見つけるよう依頼する

find the files that handle user authentication
2

コンポーネントがどのように相互作用するかについてのコンテキストを取得する

how do these authentication files work together?
3

実行フローを理解する

trace the login process from front-end to database
ヒント:
  • 探しているものについて具体的に説明する
  • プロジェクトのドメイン言語を使用する
  • 言語のコード インテリジェンス プラグインをインストールして、Claude に正確な’定義に移動’と’参照を検索’のナビゲーションを提供する

バグを効率的に修正する

エラーメッセージが表示され、そのソースを見つけて修正する必要があるとします。
1

Claude とエラーを共有する

I'm seeing an error when I run npm test
2

修正の推奨事項をリクエストする

suggest a few ways to fix the @ts-ignore in user.ts
3

修正を適用する

update user.ts to add the null check you suggested
ヒント:
  • Claude に問題を再現するコマンドとスタックトレースを伝える
  • エラーを再現するための手順を記載する
  • エラーが断続的か一貫しているかを Claude に知らせる

コードをリファクタリングする

古いコードを最新のパターンとプラクティスを使用するように更新する必要があるとします。
1

リファクタリング対象のレガシーコードを特定する

find deprecated API usage in our codebase
2

リファクタリングの推奨事項を取得する

suggest how to refactor utils.js to use modern JavaScript features
3

変更を安全に適用する

refactor utils.js to use ES2024 features while maintaining the same behavior
4

リファクタリングを検証する

run tests for the refactored code
ヒント:
  • Claude に最新のアプローチの利点を説明するよう依頼する
  • 必要に応じて変更が後方互換性を維持することをリクエストする
  • リファクタリングを小さくテスト可能な増分で実行する

テストを使用する

カバーされていないコードのテストを追加する必要があるとします。
1

テストされていないコードを特定する

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

テストスキャフォルディングを生成する

add tests for the notification service
3

意味のあるテストケースを追加する

add test cases for edge conditions in the notification service
4

テストを実行して検証する

run the new tests and fix any failures
Claude は、プロジェクトの既存のパターンと規約に従うテストを生成できます。テストをリクエストするときは、検証したい動作について具体的に説明してください。Claude は既存のテストファイルを調べて、既に使用されているスタイル、フレームワーク、アサーションパターンに一致させます。 包括的なカバレッジのために、Claude に見落とした可能性のあるエッジケースを特定するよう依頼してください。Claude はコードパスを分析し、エラー条件、境界値、見落としやすい予期しない入力のテストを提案できます。

プルリクエストを作成する

Claude に直接プルリクエストを作成するよう依頼するか(「create a pr for my changes」)、ステップバイステップで Claude をガイドできます:
1

変更内容を要約する

summarize the changes I've made to the authentication module
2

プルリクエストを生成する

create a pr
3

レビューと改善

enhance the PR description with more context about the security improvements
gh pr create を使用して PR を作成すると、セッションはその PR に自動的にリンクされます。後で claude --from-pr <number> で再開するか、/resume ピッカーの検索に PR URL を貼り付けることで再開できます。
Claude が生成した PR を送信する前にレビューし、Claude に潜在的なリスクや考慮事項を強調するよう依頼してください。

ドキュメントを処理する

コードのドキュメントを追加または更新する必要があるとします。
1

ドキュメント化されていないコードを特定する

find functions without proper JSDoc comments in the auth module
2

ドキュメントを生成する

add JSDoc comments to the undocumented functions in auth.js
3

レビューと改善

improve the generated documentation with more context and examples
4

ドキュメントを検証する

check if the documentation follows our project standards
ヒント:
  • 必要なドキュメントスタイル(JSDoc、docstring など)を指定する
  • ドキュメント内の例をリクエストする
  • パブリック API、インターフェース、複雑なロジックのドキュメントをリクエストする

ノートと非コードフォルダで作業する

Claude Code はどのディレクトリでも機能します。ノートボルト、ドキュメントフォルダ、またはマークダウンファイルの任意のコレクション内で実行して、コードと同じ方法でコンテンツを検索、編集、再編成します。 .claude/ ディレクトリと CLAUDE.md は他のツールの設定ディレクトリと並んで競合なく存在します。Claude は各ツール呼び出しで新しくファイルを読み込むため、別のアプリケーションで行った編集は次回そのファイルを読み込むときに表示されます。

画像を使用する

コードベース内の画像を使用する必要があり、Claude の画像コンテンツ分析を支援したいとします。
1

会話に画像を追加する

次のいずれかの方法を使用できます:
  1. Claude Code ウィンドウに画像をドラッグアンドドロップする
  2. 画像をコピーして、CLI に ctrl+v で貼り付ける(cmd+v は使用しないでください)
  3. Claude に画像パスを提供する。例:「Analyze this image: /path/to/your/image.png」
2

Claude に画像を分析するよう依頼する

What does this image show?
Describe the UI elements in this screenshot
Are there any problematic elements in this diagram?
3

コンテキストに画像を使用する

Here's a screenshot of the error. What's causing it?
This is our current database schema. How should we modify it for the new feature?
4

ビジュアルコンテンツからコード提案を取得する

Generate CSS to match this design mockup
What HTML structure would recreate this component?
ヒント:
  • テキスト説明が不明確または面倒な場合は画像を使用する
  • より良いコンテキストのために、エラー、UI デザイン、図のスクリーンショットを含める
  • 会話で複数の画像を使用できます
  • 画像分析は図、スクリーンショット、モックアップなどで機能します
  • Claude が画像を参照する場合(例:[Image #1])、Cmd+Click(Mac)または Ctrl+Click(Windows/Linux)リンクをクリックして、デフォルトビューアで画像を開きます

ファイルとディレクトリを参照する

@ を使用して、Claude に読み込まれるのを待たずにファイルまたはディレクトリをすばやく含めます。
1

単一ファイルを参照する

Explain the logic in @src/utils/auth.js
これにより、ファイルの完全な内容が会話に含まれます。
2

ディレクトリを参照する

What's the structure of @src/components?
これにより、ファイル情報を含むディレクトリリストが提供されます。
3

MCP リソースを参照する

Show me the data from @github:repos/owner/repo/issues
これにより、@server:resource 形式を使用して接続された MCP サーバーからデータを取得します。詳細については、MCP リソースを参照してください。
ヒント:
  • ファイルパスは相対パスまたは絶対パスにできます
  • @ ファイル参照は、ファイルのディレクトリと親ディレクトリに CLAUDE.md を追加してコンテキストに含めます
  • ディレクトリ参照はコンテンツではなくファイルリストを表示します
  • 単一のメッセージで複数のファイルを参照できます(例:「@file1.js and @file2.js」)

スケジュールで Claude を実行する

Claude に長時間実行されるタスクを自動的に定期的に処理させたいとします。例えば、毎朝オープン PR をレビューしたり、毎週依存関係を監査したり、夜間に CI の失敗をチェックしたりします。 実行場所に基づいてスケジューリングオプションを選択します:
オプション実行場所最適な用途
ルーチンAnthropic 管理インフラストラクチャコンピュータがオフの場合でも実行する必要があるタスク。claude.ai/code/routinesで設定します。API 呼び出しまたは GitHub イベントに加えてスケジュールでトリガーすることもできます。
デスクトップスケジュール済みタスクデスクトップアプリ経由のマシンローカルファイル、ツール、またはコミットされていない変更への直接アクセスが必要なタスク。
GitHub ActionsCI パイプラインオープン PR などのリポジトリイベント、またはワークフロー設定と一緒に存在する必要がある cron スケジュールに関連するタスク。
/loop現在の CLI セッションセッションが開いている間のクイックポーリング。タスクは新しい会話を開始すると停止します。--resume--continue は期限切れでないものを復元します。
スケジュール済みタスク用のプロンプトを作成するときは、成功がどのように見えるか、および結果をどうするかについて明示的に説明してください。タスクは自律的に実行されるため、質問を明確にすることはできません。例えば:「needs-review ラベルが付いたオープン PR をレビューし、問題に関するインラインコメントを残し、#eng-reviews Slack チャネルに要約を投稿します。」

Claude にその機能について質問する

Claude は自分のドキュメントへの組み込みアクセスを持っており、自分の機能と制限について質問に答えることができます。

質問例

can Claude Code create pull requests?
how does Claude Code handle permissions?
what skills are available?
how do I use MCP with Claude Code?
how do I configure Claude Code for Amazon Bedrock?
what are the limitations of Claude Code?
Claude はこれらの質問に対してドキュメントベースの回答を提供します。実行可能な例と実践的なデモンストレーションについては、/powerup を実行してアニメーション化されたデモを含むインタラクティブレッスンを受けるか、上記の特定のワークフローセクションを参照してください。
ヒント:
  • Claude は使用しているバージョンに関係なく、常に最新の Claude Code ドキュメントにアクセスできます
  • 詳細な回答を得るために具体的な質問をする
  • Claude は MCP 統合、エンタープライズ設定、高度なワークフローなどの複雑な機能を説明できます

以前の会話を再開する

タスクが複数回に分けて実行される場合は、コンテキストを再度説明するのではなく、中断したところから再開してください。Claude Code はすべての会話をローカルに保存します。
claude --continue
これにより、現在のディレクトリで最新のセッションが再開されます。まだセッションがない場合は、No conversation found to continue と出力して終了します。claude --resume を使用してリストから選択するか、実行中のセッション内から /resume を使用してください。セッションを管理するを参照して、名前付け、ブランチ、および完全なピッカーリファレンスを確認してください。

worktree を使用して並列セッションを実行する

1 つのターミナルで機能に取り組みながら、別のターミナルで Claude がバグを修正するようにします。編集が衝突しないようにしてください。各 worktree は独自のブランチ上の個別のチェックアウトです。
claude --worktree feature-auth
別の名前で 2 番目のターミナルで同じコマンドを実行して、分離された並列セッションを開始します。Worktreesを参照して、クリーンアップ、.worktreeinclude、および非 git VCS サポートを確認してください。1 つの画面から並列セッションを監視するには、バックグラウンドエージェントを参照してください。

編集前に計画する

ディスクに変更を加える前に確認したい変更については、計画モードに切り替えてください。Claude はファイルを読み込んで計画を提案しますが、承認されるまで編集は行いません。
claude --permission-mode plan
セッション中に Shift+Tab を押して計画モードに切り替えることもできます。計画モードを参照して、承認フローとテキストエディタで計画を編集することを確認してください。

研究を subagent に委譲する

大規模なコードベースの探索はコンテキストをファイル読み込みで満たします。探索を委譲して、結果のみが戻るようにしてください。
use a subagent to investigate how our auth system handles token refresh
subagent は独自のコンテキストウィンドウでファイルを読み込み、要約を報告します。Subagentsを参照して、独自のツールとプロンプトを持つカスタムエージェントを定義することを確認してください。

Claude をスクリプトにパイプする

CI、プリコミットフック、またはバッチ処理用に Claude を非対話的に実行します。stdin と stdout は任意の Unix ツールのように機能します。
git log --oneline -20 | claude -p "summarize these recent commits"
非対話モードを参照して、出力形式、許可フラグ、およびファンアウトパターンを確認してください。

次のステップ

ベストプラクティス

Claude Code から最大限の価値を得るためのパターン

セッションを管理する

会話を再開、名前付け、ブランチする

Worktrees

分離された並列セッションを実行する

Claude Code を拡張する

skill、フック、MCP、subagent、プラグインを追加する