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

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

今日アップデートされました

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

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

1. 発見

2. 設計

3. 構築

4. デプロイ

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

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

プロジェクトを計画する

コードを実装する

CI/CDを自動化する

エラーをデバッグする

ドキュメントを検索する

技術仕様を開発する

テストを作成して実行する

環境を構成する

大規模なリファクタリング

オンボードして学習する

アーキテクチャを定義する

コミットとPRを作成する

デプロイメントを管理する

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

このガイドの使い方

以下の各ユースケースには、使用時期、プロンプト例、および予想される結果が含まれています。§9(イシュートラッカー統合)を除き、設定は不要です。これには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回実行)。

プロンプト例:

<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>&gt; /pr-comments
https://github.com/acme/api/pull/4471<br /> &gt; is the error handling
solid?</td> </tr> </tbody> </table>

期待される結果: 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 command 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/commands/にマークダウンファイルを作成します。/shipコマンドは再起動なしで即座に利用可能になり、リポジトリをクローンした誰とでも共有されます。

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

#

ユースケース

サンプルプロンプト

1

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

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

2

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

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

3

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

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

4

エラーをトリアージする

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

5

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

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

6

テストを作成する

@[file]のテストを追加 — [dir]のスタイルに合わせる

7

PRをレビューする

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

8

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

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

9

問題を最初から最後まで解決する

私の最優先の問題は何ですか?先に進んでそれを修正してください

10

スラッシュコマンドを作成する

私に /[name] コマンドを作成してください [steps]

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

リソース

リンク

クイックスタート

一般的なワークフロー

権限

メモリと CLAUDE.md

MCPコネクタ

スラッシュコマンド

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

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