メインコンテンツにスキップ

Claude Code: 開発者の一般的なユースケース

Claude Codeは、リポジトリを読み込み、ファイルを編集し、コマンドを実行し、破壊的な可能性のあるアクションを実行する前に確認を求めるコーディングエージェントです。Claude Desktopに組み込まれており、ターミナルとサポートされているIDEでも実行できます。未知のコードベースの探索から本番コードの出荷と保守まで、ソフトウェア開発ライフサイクルのあらゆる段階でサポートするように設計されています。

以下の表は、Claude Codeが開発ライフサイクル全体でどのように適合するかをまとめています。この記事の残りの部分では、開発者が最も頻繁に使用する10のタスクについて説明し、それぞれのサンプルプロンプトと予想される結果を示します。

1. 発見

2. 設計

3. ビルド

4. デプロイ

5. サポートとスケーリング

コードベースと履歴を探索

プロジェクトを計画

コードを実装

CI/CDを自動化

エラーをデバッグ

ドキュメントを検索

技術仕様を開発

テストを作成して実行

環境を構成

大規模リファクタリング

オンボードして学習

アーキテクチャを定義

コミットとPRを作成

デプロイメントを管理

使用状況とパフォーマンスを監視

このガイドの使い方

以下の各ユースケースには、使用時期、プロンプト例、および予想される結果が含まれています。§9(issue-tracker統合)を除き、設定は不要です。これには1回限りのMCPコネクタセットアップが必要です。

ユースケースは、ほとんどの開発者が遭遇する時期の順にほぼ並べられています。現在のタスクに一致するものを選択してください。


ユースケース

1. 失敗したテストを修正

使用時期: テストが失敗し、原因がすぐに明らかでない場合。Claude Codeを使用して、ソースファイルを最初に特定する必要なく、根本原因を特定し、修正を提案させます。

プロンプト例:

> the tests in tests/auth.test.ts are failing, can you figure out why and fix them

予想される結果: Claude Codeはテストファイルを読み込み、テスト対象のモジュール全体のコードパスをトレースし、不一致を特定し、編集を提案します。変更を承認すると、テストスイートを再実行して修正を確認します。

2. 不慣れなコードを理解

使用時期: 変更を加える前にモジュール、関数、またはサブシステムの動作を理解する必要がある場合。たとえば、コードを引き継ぐときや、不慣れな領域をレビューするときです。

プロンプト例:

> walk me through how the payment retry logic works

予想される結果: Claude Codeは関連ファイルを特定し、実装を読み込み、制御フローを平易な言語で説明します。エントリーポイント、決定分岐、エッジケース、およびコードがシステムの残りの部分とどのように接続されているかです。フォローアップの質問(例:「Xはどこで設定されるのか」)をして、さらに詳しく調べてください。

3. 何かが起こる場所を見つける

使用時期: 動作がコードベースに存在することはわかっているが、ファイル名または単純なテキスト検索では見つけられない場合。

プロンプト例:

> where do we validate email addresses in this codebase? I want to add a new rule

予想される結果: Claude Codeはリポジトリを検索し、候補ファイルを開き、正しい一致を特定するのに十分な周囲のコンテキストを含むファイルパスと行番号を返します。複数の場所が存在する場合、どれが信頼できるソースであるかを示します。

4. エラーまたはスタックトレースをトリアージ

使用時期: ランタイムエラー、スタックトレース、またはログ出力があり、それを責任のあるコードにマップバックする必要がある場合。

プロンプト例:

<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>&gt; getting this in production:<br />
TypeError: Cannot read properties of undefined (reading 'sessionId')<br />
at validateSession (src/auth/session.ts:47)<br /> at middleware
(src/auth/middleware.ts:12)<br /> what's going on?</td> </tr> </tbody>
</table>

予想される結果: Claude Codeはトレースで参照されているファイルを読み込み、何が未定義であり、その理由を説明し、修正を提案します。クリーンなスタックトレースのないエラーの場合は、利用可能なログ出力を貼り付けると、Claude Codeはコンテキストから障害を再構築します。

5. 計画を立てたリファクタリング

使用時期: 変更が複数のファイルにまたがり、編集が行われる前に完全なスコープを確認したい場合。

前提条件: Shift+Tabを押して、モード表示が「plan.」と表示されるまで続けます。

プロンプト例:

> refactor the auth module to use the new session store instead of SessionCache

予想される結果: Claude Codeはコードを分析し、変更するすべてのファイルと各ファイルの変更をリストする番号付きプランを作成します。プランをそのまま承認することも、修正することもできます(例:「ログアウトルートに触れないでください」)。承認されるまでファイルは編集されません。

参照: 権限

6. 既存コードのテストを作成

使用する場合: ソースファイルがカバレッジ不足の場合、またはプロジェクトの既存のテスト規約に合わせた追加のエッジケーステストが必要な場合。

プロンプト例:

> add tests for @src/billing/invoice.ts — cover the edge cases around partial refunds. match the style of the existing tests in tests/billing/

期待される結果: Claude Codeはソースファイルと参照テストディレクトリの両方を読み込み、既存のスタイルで新しいテストファイルを生成し、テストが成功することを確認するために実行します。明らかなカバレッジギャップが残っている場合は、それらにフラグを立てて対処するかどうかを尋ねます。

7. プルリクエストをレビューする

使用する場合: PRをレビューまたは要約する必要がある場合、特にコードベースの領域をよく知らない場合。

前提条件: GitHub CLIが認証されている(gh auth loginを1回実行)。

プロンプト例:

> /pr https://github.com/example/api/pull/4471
> is the error handling solid?

期待される結果: Claude Codeはdiff、レビューコメント、CIステータスを取得し、変更されたファイルをリポジトリ全体のコンテキストで読み込みます。フォーカスされたレビュー、レビューコメント案の作成、特定の懸念事項の検証、またはPRの要約を生成できます。

8. 新しいリポジトリにオンボードする

使用する場合: リポジトリで初めて作業を行い、アーキテクチャ、ビルドコマンド、規約の構造化された概要が必要な場合。

プロンプト例:

<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>&gt; /init<br /> &gt; give me a tour of this
codebase — where's the entry point, how is it structured, what should I
read first</td> </tr> </tbody> </table>

期待される結果: /initはプロジェクトをスキャンし、ビルドコマンド、アーキテクチャ、規約をまとめたCLAUDE.mdファイルを作成します。フォローアップツアープロンプトはプロジェクト構造のガイド付きウォークスルーを生成します。プロジェクトコンテキストはセッションの残りの間ロードされたままになります。

9. 問題をエンドツーエンドで処理する

使用する場合: チケットを読み、修正を実装し、ツールを切り替えずに1つの会話で検証したい場合。

前提条件: MCPを介して接続されたイシュートラッカー(1回限りの.mcp.json設定)。

プロンプト例:

<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>&gt; what's the top-priority issue assigned
to me?<br /> &gt; go ahead and fix it</td> </tr> </tbody> </table>

期待される結果: Claude Codeはイシュートラッカーをクエリし、チケットを読み込み、関連するコードを見つけ、修正を提案し、テストを実行します。セッションはレビュー可能なdiffとチケットをクローズするために必要なコンテキストで終了します。

参照: MCP

10. 定期的なタスクをスキルに変える

使用する場合: 同じ複数ステップのプロンプトを定期的に繰り返す(コミット前チェック、スタンドアップサマリー、PR説明、リリースノート)場合、チーム全体で再利用可能にしたい場合。

プロンプト例:

> make me a /ship skill that runs the tests, runs the linter, looks at git diff, and drafts a conventional-commit message — then shows me the message without committing

期待される結果: Claude Codeは.claude/skills/ship/にSKILL.mdファイルを作成します。/shipコマンドはすぐに利用可能になり、再起動は不要で、リポジトリをクローンした誰とでも共有されます。(レガシーの.claude/commands/パスはまだサポートされていますが、スキルが推奨される形式です。)

参照: スキル

付録: クイックリファレンス

#

ユースケース

サンプルプロンプト

1

失敗したテストを修正する

[file]のテストが失敗しています — 理由を特定して修正してください

2

不慣れなコードを理解する

[module]がどのように機能するかを説明してください

3

何かが起こる場所を見つける

このコードベースで[action]はどこで行われていますか?

4

エラーをトリアージする

スタックトレースを貼り付けて、次のように尋ねます: 何が起こっていますか?

5

計画を立ててリファクタリングする

Shift+Tab → プランモード → リファクタリングを説明

6

テストを書く

@[file]のテストを追加 — [dir]のスタイルに合わせてください

7

PRをレビューする

/pr [URL]を実行してから質問してください

8

リポジトリにオンボードする

/initその後「ツアーをしてくれ」

9

問題を最初から最後まで対応する

私の最優先の問題は何か? → さあ、それを修正してくれ

10

スキルを作成する

私に/[name]スキルを作成してくれ、[steps]を実行してくれ

付録:リソースディレクトリ

/init、@参照、権限モード、スキル、MCP、フックの詳細については、code.claude.com/docsを参照してください。Claude Codeは頻繁に更新されるため、内部配布前にcode.claude.com/docsでバージョン固有の詳細を確認してください。

こちらの回答で解決しましたか?