読み込み中

実践で見るClaude Code

レッスン 596 分
読み込み中

Claude Codeは単なるコード作成ツールではありません。ソフトウェアプロジェクトのあらゆる段階を通じて、あなたと一緒に働くように設計されています。初期セットアップからデプロイ、サポートまで、あらゆることを担当できるチームのもう一人のエンジニアだと考えてください。

5つのプロジェクト段階、Discover、Design、Build、Deploy、そして「Support and Scale」、それぞれに3つのClaude Codeタスクがある。

/init コマンド

プロジェクトでClaude Codeを使い始める際、最初にやりたいことは/initコマンドを実行することです。これにより、Claudeはコードベース全体をスキャンし、プロジェクトの構造、依存関係、コーディングスタイル、アーキテクチャを理解します。

Claudeは学習した内容をCLAUDE.mdという特別なファイルにまとめます。このファイルは今後のすべての会話で自動的にコンテキストとして含まれるため、Claudeはあなたのプロジェクトに関する重要な詳細を覚えています。

異なるスコープのために複数のCLAUDE.mdファイルを持つことができます。

  • Project - プロジェクトに取り組むすべてのエンジニア間で共有される
  • Local - gitにチェックインされない個人用メモ
  • User - すべてのプロジェクトで使用される

/initを実行する際、Claudeに注目してほしい領域について特別な指示を追加できます。生成されたファイルには、ビルドコマンド、コーディングガイドライン、Claudeが従うべきプロジェクト固有のパターンが含まれます。

「/init」と入力されたClaude Codeのターミナルと、「コードベースのドキュメントを含む新しいCLAUDE.mdファイルを初期化する」という提案。

#コマンドを使って、CLAUDE.mdファイルにすばやくメモを追加することもできます。例えば、# 常にわかりやすい変数名を使用すると入力すると、このガイドラインをプロジェクト、ローカル、またはユーザーのメモリに追加するよう促されます。

よくあるワークフロー

Claudeは、あなたが効果を増幅させる存在として取り組む場合に最もうまく機能します。提供するコンテキストと構造が多ければ多いほど、得られる結果も向上します。最も効果的なワークフローは次のとおりです。

3ステップのワークフロー:Claudeにコンテキストを与える、解決策を計画させる、その後実装を依頼する、詳細は以下に記載。

ステップ1:Claudeにコンテキストを与える

Claudeに何かを構築してもらう前に、作成したい機能に関連するコードベース内のファイルを特定します。まずClaudeにこれらのファイルを読んで分析するよう依頼します。これにより、Claudeはあなたのコーディングパターンや、その上に構築できる既存の機能の例を得られます。

ステップ2:Claudeに解決策を計画させる

実装にすぐ飛びつくのではなく、Claudeに問題を考え抜いて計画を立てるよう依頼します。まだコードを一切書かないよう具体的に伝え、アプローチと必要な手順だけに集中させます。

ステップ3:Claudeに解決策の実装を依頼する

しっかりした計画ができたら、Claudeにそれを実装するよう依頼します。Claudeは、あなたがすでに一緒に行ったコンテキストと計画作業に基づいてコードを書きます。

テスト駆動開発のワークフロー

さらに良い結果を得るには、テスト駆動のアプローチを使うこともできます。

VS Code内のClaude Codeターミナルで/clearと入力され、そのヘルプには「会話履歴をクリアし、コンテキストを解放する」と書かれている。

  1. Claudeにコンテキストを与える - 前と同じく、Claudeに関連ファイルを見せる
  2. Claudeにテストケースを考えさせる - 新機能を検証するにはどんなテストが適切か、Claudeにブレインストーミングさせる
  3. Claudeにそれらのテストを実装させる - 最も関連性の高いテストを選び、Claudeに書かせる
  4. Claudeにテストに合格するコードを書かせる - Claudeはすべてのテストに合格するまで実装を繰り返す

この方法は、Claudeが目指すべき明確な成功基準を持つため、より堅牢なコードを生み出すことがよくあります。

実践例

これらのワークフローが実際にどのように見えるか見てみましょう。既存のプロジェクトにドキュメント変換ツールを追加したいとします。

// First, ask Claude to read relevant files
> Read the math.py and document.py files

// Then ask for planning (not implementation)
> Plan to implement document_path_to_markdown tool:
1. Create a function that:
   - Takes a file path parameter
   - Validates the file exists  
   - Determines file type from extension
   - Reads binary data from file
   - Leverages existing binary_document_to_markdown function
   - Returns markdown string
2. Add appropriate documentation
3. Register the tool with MCP server
4. Add tests

// Finally, ask for implementation
> Implement the plan

その後Claudeは関数を作成し、必要なファイルを更新し、テストを書き、さらにはすべてが正しく動作することを確認するためにテストスイートを実行します。

追加のコマンド

Claude Codeにはいくつかの便利なコマンドが含まれています。

  • /clear - 会話履歴をクリアしてコンテキストをリセットする
  • /init - コードベースをスキャンしてCLAUDE.mdドキュメントを作成する
  • # - CLAUDE.mdファイルにメモを追加する

Claudeは、gitへの変更のステージングとコミット、テストの実行、依存関係の管理など、日常的な開発タスクも処理できます。エディタとターミナルを切り替える代わりに、Claudeにこれらのタスクを処理してもらい、あなたはより大きな課題に集中できます。

Claude Codeで成功する鍵は、それが単なるコードジェネレーターではなく、協力的なパートナーとして設計されていることを忘れないことです。提供するコンテキストと構造が多ければ多いほど、Claudeはあなたのプロジェクトの構築と保守をより効果的に支援できます。