Claude Code: Claude Code 基本使用法

最終更新:2026-08-31

基本使用法は Claude Code の日常ツールキットです — コードの作成からバグ修正、リファクタリングからテスト作成まで、開発者のコア作業シナリオをカバーします。

💡 ヒント: Claude Code の最大の強みは単発の回答ではなく、「プロジェクトを理解 → コードを修正 → 結果を検証 → 反復修正」のクローズドループ能力です。

📋 前提条件: 第7章 - インタラクティブモードと操作ガイド

1. 学ぶ内容


2. コード生成

(1) ゼロからファイルを作成

TEXT 📖 参照専用
> Create src/services/email.ts with email sending service:
> - Support HTML and plain text formats
> - Use template engine for rendering
> - Add retry mechanism (max 3 attempts)
> - Write unit tests (mock SMTP)

Claude Code:
  → src/services/email.ts を作成中
  → src/services/__tests__/email.test.ts を作成中
  → 依存関係をインストール中: nodemailer, handlebars
  → 実行中: npm test -- email.test.ts
  ✅ 5つのテストが合格

(2) 既存コードをベースに拡張

TEXT 📖 参照専用
> Add password reset functionality to UserService

Claude Code:
  → src/services/user.ts を読み取り中
  → src/models/user.ts を読み取り中
  → src/services/email.ts を読み取り中(既存のメールサービス)
  → src/services/user.ts を修正中(resetPassword を追加)
  → src/routes/user.ts を修正中(POST /reset-password を追加)
  → パスワードリセットのテストを作成中
  ✅ すべてのテストが合格

▶ 例1:CRUD モジュールの生成

TEXT 📖 参照専用
> Create complete Product CRUD module:
> 1. Prisma model definition
> 2. Repository layer
> 3. Service layer
> 4. Controller layer
> 5. Route definitions
> 6. Complete tests

Claude Code: 6ファイルを作成、12テストがすべて合格 ✅

3. バグ修正

(1) バグ修正を指定

TEXT 📖 参照専用
> Fix the relativeTime calculation error in src/utils/date.ts when crossing years

Claude Code:
  → src/utils/date.ts を読み取り中
  → バグを発見:relativeTime が日数のみの比較を使用
  → 修正中:年の境界チェックを追加
  → 実行中: npm test -- date.test.ts
  ✅ すべてのテストが合格(新しいエッジケースを含む)

(2) エラーメッセージに基づく修正

TEXT 📖 参照専用
> Run tests and fix all failing cases

Claude Code:
  → 実行中: npm test
  ❌ 3つのテストが失敗
  → 失敗したテストファイルを読み取り中...
  → 各失敗テストを修正中
  → 実行中: npm test
  ✅ 47テストがすべて合格

▶ 例2:ランタイムエラーの修正

TEXT 📖 参照専用
> App startup error: TypeError: Cannot read property 'id' of undefined at UserController.getProfile

Claude Code:
  → 発見:getProfile が req.user の存在をチェックしていない
  → null チェックと適切なエラーレスポンスを追加
  → 実行中: npm test -- user.controller.test.ts
  ✅ すべてのテストが合格

4. コードリファクタリング

(1) 関数レベルのリファクタリング

TEXT 📖 参照専用
> Refactor formatCurrency in src/utils/format.ts to use Intl.NumberFormat

Claude Code:
  → 手動フォーマットを Intl.NumberFormat に置き換え
  → ロケールサポートを追加(デフォルト: en-US)
  → 実行中: npm test -- format.test.ts
  ✅ すべてのテストが合格

(2) モジュールレベルのリファクタリング

TEXT 📖 参照専用
> Reorganize all utility functions under src/helpers/ into src/utils/ by function:
> - Date related → utils/date.ts
> - String related → utils/string.ts
> - Number related → utils/number.ts
> Update all import paths

Claude Code:
  → 適切なエクスポートで関数を移動
  → 32の import 文を更新
  → src/helpers/ を削除
  → 実行中: npm test
  ✅ 89テストがすべて合格

5. テスト作成

▶ 例3:バッチテスト生成

TEXT 📖 参照専用
> Write tests for all services under src/services/ without tests, coverage target 80%

Claude Code:
  → 8つのサービスファイルをスキャン
  → 3つのサービスでテストが不足していることを発見
  → それぞれのテストを作成
  → 実行中: npm test
  ✅ 新しいテストがすべて合格
  カバレッジ平均:85% ✓

6. コードレビューとドキュメント

(1) コードレビュー

TEXT 📖 参照専用
> Review src/auth/jwt.ts for security issues

Claude Code:
  ⚠️ 3つの問題を発見:
  1. ハードコードされたシークレットキー(12行目) → 環境変数を使用
  2. トークン有効期限の検証なし(34行目) → 有効期限チェックを追加
  3. アルゴリズムが未指定(8行目) → RS256 を強制

(2) ドキュメント生成

TEXT 📖 参照専用
> Generate API documentation for all routes under src/api/

Claude Code:
  → すべてのルートファイルを読み取り(12ファイル)
  → エンドポイント一覧、例、エラーコードを含む docs/api.md を生成

7. 総合例:全流れ開発

TEXT 📖 参照専用
> Implement user permission system:
> 1. Define Role and Permission models
> 2. Implement RBAC middleware
> 3. Add permission check decorators
> 4. Write complete integration tests
> 5. Generate API documentation

Claude Code: 8ファイルを作成、4ファイルを修正、15テストが合格 ✅

❓ よくある質問

Q Claude Code が生成するコードの品質はどうですか?
A 一般的なパターンと標準実装では高い品質です。複雑なビジネスロジックと特殊ケースには依然として人間のレビューが必要です。生成されたコードは常にレビューしてください。
Q 複数のバグを一度に修正できますか?
A はい。各バグを明確に記述すれば、Claude Code は1つずつ修正します。ただし、1つのバグに集中する方がエラーの確率が下がります。
Q リファクタリングで既存の機能が壊れますか?
A プロジェクトに包括的なテストがあれば、Claude Code はそれらが通ることを確認します。テストがない場合、リファクタリングのリスクは高くなります — まずテストを追加することを推奨します。
Q テストの品質は良いですか?
A ユニットテストの品質は良好で、特にハッピーパスと一般的なエッジケースに優れています。境界条件や複雑なモックシナリオは手動での補足が必要な場合があります。
Q コードレビューは人間のレビューに代わりますか?
A 完全には代わりません。Claude Code は一般的なセキュリティ問題やスタイル問題の発見に優れていますが、ビジネスロジックの正確性には依然として人間の判断が必要です。
Q Claude Code にプロジェクトのコードスタイルに従わせるには?
A CLAUDE.md にコーディング規約を書いてください。また、最初に ESLint/Prettier 設定を読み取らせるのも有効です。

📖 まとめ


📝 練習問題

  1. 基本 (⭐): Claude Code を使って関数のユニットテストを生成し、テスト品質を確認してください。
  2. 応用 (⭐⭐): 意図的にバグを導入し、Claude Code に修正させ、その特定と修正のプロセスを観察してください。
  3. 高度 (⭐⭐⭐): Claude Code に完全な機能モジュール(model+service+route+test+docs)を作成させ、生成されたすべてのコードをレビューしてください。
Web-Tutorial.com

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

100%