このガイドでは、Claude Codeを使用した一般的なワークフローのステップバイステップのチュートリアルを提供します。各チュートリアルには、Claude Codeを最大限に活用するための明確な手順、コマンド例、ベストプラクティスが含まれています。

​
目次

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

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

使用するタイミング: 新しいプロジェクトに参加し、その構造を素早く理解する必要がある場合。

1

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

$ cd /path/to/project
2

Claude Codeを起動

$ claude
3

高レベルの概要を要求

> このコードベースの概要を教えてください
4

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

> ここで使用されている主なアーキテクチャパターンを説明してください
> 主要なデータモデルは何ですか？
> 認証はどのように処理されていますか？

ヒント:

  • 広範な質問から始めて、特定の領域に絞り込む
  • プロジェクトで使用されているコーディング規約とパターンについて質問する
  • プロジェクト固有の用語集を要求する

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

使用するタイミング: 特定の機能や機能に関連するコードを見つける必要がある場合。

1

Claudeに関連ファイルを探してもらう

> ユーザー認証を処理するファイルを見つけてください
2

コンポーネント間の相互作用についてのコンテキストを取得

> これらの認証ファイルはどのように連携していますか？
3

実行フローを理解する

> フロントエンドからデータベースまでのログインプロセスを追跡してください

ヒント:

  • 探しているものについて具体的に説明する
  • プロジェクトのドメイン言語を使用する

​
効率的にバグを修正する

​
エラーメッセージを診断する

使用するタイミング: エラーメッセージに遭遇し、その原因を見つけて修正する必要がある場合。

1

エラーをClaudeと共有

> npm testを実行すると、エラーが表示されます
2

修正の提案を要求

> user.tsの@ts-ignoreを修正する方法をいくつか提案してください
3

修正を適用

> 提案したnullチェックを追加してuser.tsを更新してください

ヒント:

  • エラーを再現するコマンドとスタックトレースをClaudeに伝える
  • エラーを再現するための手順を説明する
  • エラーが断続的か一貫しているかをClaudeに伝える

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

​
レガシーコードを最新化する

使用するタイミング: 古いコードを最新のパターンと実践に更新する必要がある場合。

1

リファクタリングが必要なレガシーコードを特定

> コードベースで非推奨のAPI使用を見つけてください
2

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

> utils.jsを最新のJavaScript機能を使用してリファクタリングする方法を提案してください
3

変更を安全に適用

> 同じ動作を維持しながら、utils.jsをES2024の機能を使用してリファクタリングしてください
4

リファクタリングを検証

> リファクタリングしたコードのテストを実行してください

ヒント:

  • 最新のアプローチのメリットについてClaudeに説明を求める
  • 必要な場合は後方互換性を維持するように変更を要求する
  • リファクタリングは小さく、テスト可能な単位で行う

​
テストを扱う

​
テストカバレッジを追加する

使用するタイミング: テストされていないコードにテストを追加する必要がある場合。

1

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

> NotificationsService.swiftでテストでカバーされていない関数を見つけてください
2

テストの雛形を生成

> 通知サービスのテストを追加してください
3

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

> 通知サービスのエッジケースのテストケースを追加してください
4

テストを実行して検証

> 新しいテストを実行し、失敗があれば修正してください

ヒント:

  • エッジケースとエラー条件をカバーするテストを要求する
  • 適切な場合は単体テストと統合テストの両方を要求する
  • テスト戦略についてClaudeに説明を求める

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

​
包括的なPRを生成する

使用するタイミング: 変更内容について十分に文書化されたプルリクエストを作成する必要がある場合。

1

変更内容を要約

> 認証モジュールに加えた変更を要約してください
2

ClaudeでPRを生成

> prを作成してください
3

レビューと改善

> セキュリティ改善に関するより詳しいコンテキストでPRの説明を強化してください
4

テストの詳細を追加

> これらの変更がどのようにテストされたかについての情報を追加してください

ヒント:

  • ClaudeにPRを直接作成するよう依頼する
  • 提出前にClaudeが生成したPRをレビューする
  • 潜在的なリスクや考慮事項を強調するようClaudeに依頼する

​
ドキュメントを扱う

​
コードドキュメントを生成する

使用するタイミング: コードのドキュメントを追加または更新する必要がある場合。

1

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

> 認証モジュールで適切なJSDocコメントがない関数を見つけてください
2

ドキュメントを生成

> auth.jsのドキュメント化されていない関数にJSDocコメントを追加してください
3

レビューと強化

> より多くのコンテキストと例を追加して生成されたドキュメントを改善してください
4

ドキュメントを検証

> ドキュメントがプロジェクトの標準に従っているか確認してください

ヒント:

  • 希望するドキュメントスタイル（JSDoc、docstringsなど）を指定する
  • ドキュメントに例を含めるよう要求する
  • パブリックAPI、インターフェース、複雑なロジックのドキュメントを要求する

​
画像を扱う

​
画像とスクリーンショットを分析する

使用するタイミング: コードベースで画像を扱う必要がある場合や、画像内容の分析でClaudeの助けが必要な場合。

1

会話に画像を追加

以下のいずれかの方法を使用できます：

# 1. Claude Codeウィンドウに画像をドラッグ＆ドロップ

# 2. 画像をコピーしてCtrl+vでCLIに貼り付け

# 3. 画像パスを提供
$ claude
> この画像を分析してください: /path/to/your/image.png
2

Claudeに画像の分析を依頼

> この画像は何を示していますか？
> このスクリーンショットのUI要素を説明してください
> この図に問題のある要素はありますか？
3

コンテキストとして画像を使用

> これはエラーのスクリーンショットです。何が原因ですか？
> これは現在のデータベーススキーマです。新機能のためにどのように修正すべきですか？
4

視覚的コンテンツからコードの提案を得る

> このデザインモックアップに合わせたCSSを生成してください
> このコンポーネントを再現するにはどのようなHTML構造が必要ですか？

ヒント:

  • テキストでの説明が不明確または煩雑な場合は画像を使用する
  • より良いコンテキストのために、エラー、UIデザイン、図のスクリーンショットを含める
  • 会話で複数の画像を扱うことができる
  • 画像分析は図、スクリーンショット、モックアップなどで機能する

​
プロジェクトメモリを設定する

​
効果的なCLAUDE.mdファイルを作成する

使用するタイミング: 重要なプロジェクト情報、規約、よく使用するコマンドを保存するためのCLAUDE.mdファイルを設定したい場合。

1

コードベース用のCLAUDE.mdを初期化

> /init

ヒント:

  • よく使用するコマンド（ビルド、テスト、リント）を含めて、繰り返しの検索を避ける
  • コードスタイルの設定と命名規則を文書化する
  • プロジェクト固有の重要なアーキテクチャパターンを追加する
  • CLAUDE.mdファイルは、Claudeを実行するフォルダ、親ディレクトリ（Claudeは自動的に読み込む）、または子ディレクトリ（Claudeは必要に応じて取り込む）に追加できる

​
Claudeをunixスタイルのユーティリティとして使用する

​
検証プロセスにClaudeを追加する

使用するタイミング: Claude Codeをリンターやコードレビューアーとして使用したい場合。

手順:

1

ビルドスクリプトにClaudeを追加

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'あなたはリンターです。mainとの変更を確認し、タイプミスに関する問題を報告してください。ファイル名と行番号を1行目に、問題の説明を2行目に報告してください。他のテキストは返さないでください。'"
    }
}

​
パイプイン、パイプアウト

使用するタイミング: データをClaudeにパイプで送り、構造化された形式でデータを取得したい場合。

1

Claudeを通じてデータをパイプ

$ cat build-error.txt | claude -p 'このビルドエラーの根本原因を簡潔に説明してください' > output.txt

​
Model Context Protocol (MCP)を設定する

Model Context Protocol (MCP)は、LLMが外部ツールやデータソースにアクセスできるようにするオープンプロトコルです。詳細については、MCPドキュメントを参照してください。

サードパーティのMCPサーバーは自己責任で使用してください。MCPサーバーを信頼できることを確認し、 特にインターネットと通信するMCPサーバーを使用する場合は、プロンプトインジェクションのリスクに さらされる可能性があるため、特に注意してください。

​
MCPサーバーを設定する

使用するタイミング: Model Context Protocolを使用して、特殊なツールや外部サーバーに接続することでClaudeの機能を強化したい場合。

1

MCP Stdioサーバーを追加

# 基本的な構文
$ claude mcp add <name> <command> [args...]

# 例：ローカルサーバーの追加
$ claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2
2

MCPサーバーを管理

# 設定されているすべてのサーバーをリスト表示
$ claude mcp list

# 特定のサーバーの詳細を取得
$ claude mcp get my-server

# サーバーを削除
$ claude mcp remove my-server

ヒント:

  • -sまたは--scopeフラグをproject（デフォルト）またはglobalで使用して、設定の保存場所を指定する
  • -eまたは--envフラグで環境変数を設定する（例：-e KEY=value）
  • MCPはクライアント-サーバーアーキテクチャに従い、Claude Code（クライアント）は複数の専門サーバーに接続できる

​
PostgresのMCPサーバーに接続する

使用するタイミング: クエリとスキーマ検査のために、ClaudeにPostgreSQLデータベースへの読み取り専用アクセスを提供したい場合。

1

Postgres MCPサーバーを追加

$ claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"
2

Claudeでデータベースを照会

# Claudeセッションで、データベースについて質問できます
$ claude
> usersテーブルのスキーマを説明してください
> システム内の最新の注文を表示してください
> 顧客と請求書の関係を示してください

ヒント:

  • Postgres MCPサーバーは安全のため読み取り専用アクセスを提供する
  • Claudeはデータベース構造の探索と分析クエリの実行を支援できる
  • これを使用して、不慣れなプロジェクトのデータベーススキーマを素早く理解できる
  • 接続文字列には、必要最小限の権限を持つ適切な認証情報を使用する

​
次のステップ

Claude Codeリファレンス実装

開発コンテナのリファレンス実装をクローンしてください。

Was this page helpful?

概要コンピュータ使用（ベータ版）