読み込み中

実践で見るClaude Code

レッスン 592 分
読み込み中

Claude Codeは単にコードを書くためのツールではなく、プロジェクトのライフサイクル全体を通じてあなたのコーディングパートナーとなるよう設計されています。初期セットアップからデプロイ、保守に至るまで、Claudeはソフトウェア開発のあらゆるステップを支援できます。

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

/init コマンド

新しいプロジェクトを始める際、/init コマンドが最初のステップになります。Claude Codeはあなたのコードベースをスキャンし、プロジェクト構造、依存関係、コマンド、コーディングパターンを把握します。その結果は CLAUDE.md ファイルにまとめられ、Claudeは今後の会話で自動的にそれを読み込みます。

VS Codeのターミナルで"/init"と入力されているClaude Code。"Initialize a new CLAUDE.md file with codebase documentation"というヒントが表示されている。

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

  • プロジェクト - gitにチェックインされ、エンジニア間で共有される
  • ローカル - gitにチェックインされない、Claudeへのあなた独自のメモ
  • ユーザー - すべてのプロジェクトで使用される

/init を実行する際、Claudeに重点的に取り組んでほしい領域について特別な指示を追加できます。また # ショートカットを使って、CLAUDE.mdファイルに追記される簡単なメモを加えることもできます。

一般的なワークフロー

Claudeは作業効率を倍増させる存在として最も効果を発揮します。提供するコンテキストと構造が多いほど、得られる結果も良くなります。ここでは効果的な2つのアプローチを紹介します。

計画優先ワークフローの3段階の矢印:コンテキストを与える、解決策を計画する、それを実装する。詳細は以下に記載。

計画優先ワークフロー

この3ステップのアプローチは、複雑な機能に対してうまく機能します。

  1. Claudeにコンテキストを与える - 機能に関連するファイルを見つけ、Claudeにそれらを読むよう依頼する
  2. Claudeに解決策を計画させる - 作りたいものを説明するが、まだコードは書かないよう具体的に依頼する
  3. Claudeに解決策を実装させる - 確実な計画ができたら、Claudeはすでに完了したコンテキストと計画に基づいてコードを書くことができる

例えば、ドキュメント変換ツールを構築する場合、まずClaudeに既存のツールの例やヘルパー関数を調べるよう依頼するとよいでしょう。その後、実装手順を計画させます。最後に、実際のコード実装を依頼します。

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

Claude Codeのターミナル:main.py、tools/document.py、tests/test_document.pyへの変更がスタッシュされ、その後"/clear"が入力されている。

このアプローチは事前の労力をより多く必要としますが、Claudeの効果を劇的に高めます。

  1. Claudeにコンテキストを与える - 機能に関連するファイルを共有する
  2. Claudeにテストケースを考えさせる - まだコードは一切書かないよう具体的に伝える
  3. Claudeにそれらのテストを実装させる - 自分の機能に関連していそうなテストだけを選ぶ
  4. Claudeにテストに合格するコードを書かせる - Claudeはテストが通るまで解決策を反復する

このワークフローは、コードの堅牢性を確保し、最初には考慮していなかったエッジケースにも対応するのに役立ちます。

実践的なヒント

Claudeは単にコードを書くこと以上の、日常的な開発タスクを処理できます。次のようなことを依頼できます。

  • プロジェクト環境のセットアップと依存関係のインストール
  • 説明的なコミットメッセージでの変更のステージングとコミット
  • テストスイートの実行と結果の解釈
  • /clear で会話履歴をクリアしてコンテキストをリセットする

Claude CodeはCLAUDE.mdファイルを自動的に読み込むため、そこに記載したコーディング規約、プロジェクト固有のメモ、アーキテクチャ上の決定事項は、今後のすべてのやり取りに影響を与えることを覚えておいてください。これにより、Claudeはあなたのプロジェクトのパターンや要件について学ぶほど、ますます効果的になります。