一般的なワークフロー

Claude Code を使用してコードベースの探索、バグ修正、リファクタリング、テスト、その他の日常的なタスクを実行するためのステップバイステップガイド。

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

このページでは以下をカバーしています：

• プロンプトレシピ：コード探索、バグ修正、リファクタリング、テスト、PR、ドキュメント用
• 以前の会話を再開する：タスクを複数回に分けて実行できるようにする
• worktree を使用して並列セッションを実行する：同時編集が衝突しないようにする
• 編集前に計画する：ディスクに変更を加える前に確認する
• 研究を subagent に委譲する：メインコンテキストをクリーンに保つ
• Claude をスクリプトにパイプする：CI とバッチ処理用

プロンプトレシピ

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

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

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

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

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

cd /path/to/project 

claude 

give me an overview of this codebase

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

バグを効率的に修正する

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

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

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

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

find deprecated API usage in our codebase

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

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

run tests for the refactored code

テストを使用する

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

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 は、プロジェクトの既存のパターンと規約に従うテストを生成できます。テストをリクエストするときは、検証したい動作について具体的に説明してください。Claude は既存のテストファイルを調べて、既に使用されているスタイル、フレームワーク、アサーションパターンに一致させます。

包括的なカバレッジのために、Claude に見落とした可能性のあるエッジケースを特定するよう依頼してください。Claude はコードパスを分析し、エラー条件、境界値、見落としやすい予期しない入力のテストを提案できます。

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

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

summarize the changes I've made to the authentication module

create a pr

enhance the PR description with more context about the security improvements

gh pr create を使用して PR を作成すると、セッションはその PR に自動的にリンクされます。後で claude --from-pr 123 で再開するか（123 を PR 番号に置き換えます）、/resume ピッカーの検索に PR URL を貼り付けることで再開できます。

ドキュメントを処理する

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

find functions without proper JSDoc comments in the auth module

add JSDoc comments to the undocumented functions in auth.js

improve the generated documentation with more context and examples

check if the documentation follows our project standards

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

Claude Code はどのディレクトリでも機能します。ノートボルト、ドキュメントフォルダ、またはマークダウンファイルの任意のコレクション内で実行して、コードと同じ方法でコンテンツを検索、編集、再編成します。

.claude/ ディレクトリと CLAUDE.md は他のツールの設定ディレクトリと並んで競合なく存在します。Claude は各ツール呼び出しで新しくファイルを読み込むため、別のアプリケーションで行った編集は次回そのファイルを読み込むときに表示されます。

画像を使用する

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

What does this image show?

Describe the UI elements in this screenshot

Are there any problematic elements in this diagram?

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?

Generate CSS to match this design mockup

What HTML structure would recreate this component?

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

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

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

What's the structure of @src/components?

Show me the data from @github:repos/owner/repo/issues

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

Claude に長時間実行されるタスクを自動的に定期的に処理させたいとします。例えば、毎朝オープン PR をレビューしたり、毎週依存関係を監査したり、夜間に CI の失敗をチェックしたりします。

実行場所に基づいてスケジューリングオプションを選択します：

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 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"

非対話モードを参照して、出力形式、許可フラグ、およびファンアウトパターンを確認してください。

次のステップ