何ができるの？ ― 実例で見るClaude Code

シナリオ：自己紹介ページを作りたい

> 自己紹介用のWebページを作ってください。名前は田中太郎、
  Webエンジニア歴5年、趣味は登山とカメラです。
  モダンなデザインで、レスポンシブ対応にしてください。

Claude Codeの動作：

1. プロジェクト構造を確認（既存ファイルがあるかチェック）
2. index.html を作成 ― HTML構造、自己紹介セクション、スキルバー
3. style.css を作成 ― レスポンシブレイアウト、アニメーション
4. script.js を作成 ― スムーズスクロール、インタラクション
5. 作成したファイルの概要を説明

所要時間：約30秒〜1分。手作業なら数時間かかる作業です。

シナリオ：Pythonスクリプトがエラーで動かない

> このPythonスクリプトを実行すると以下のエラーが出ます。修正してください。
  TypeError: cannot unpack non-sequence NoneType

Claude Codeの動作：

1. 該当ファイルを読み込み、エラー箇所を特定
2. 関数の戻り値が None になるケースを発見
3. Noneチェックを追加する修正を提案
4. 許可を得てファイルを修正
5. 修正後にスクリプトを実行して動作確認

# 修正前
data = get_user_data(user_id)
name, email = data  # data が None の場合にエラー

# 修正後
data = get_user_data(user_id)
if data is None:
    raise ValueError(f"User {user_id} not found")
name, email = data

シナリオ：長すぎる関数を分割したい

> utils.py の process_order 関数が200行もあって読みにくいです。
  適切な単位に分割してリファクタリングしてください。

Claude Codeの動作：

1. utils.py を読み込んで関数の構造を分析
2. 論理的なまとまりを判断（入力検証、計算、DB保存 等）
3. 5つの小さな関数に分割する修正を提案
4. 元の関数から新しい関数を呼び出す形に書き換え
5. 既存のテストがあれば実行して、動作が変わっていないことを確認

シナリオ：既存のコードにテストを追加したい

> src/calculator.js にある Calculator クラスの
  ユニットテストを書いてください。Jest を使ってください。

Claude Codeの動作：

1. calculator.js のクラス定義を読み込み、全メソッドを確認
2. 各メソッドの正常系・異常系のテストケースを設計
3. tests/calculator.test.js を作成
4. npm test を実行してテストが通ることを確認

// Claude Codeが生成するテストの例
describe("Calculator", () => {
  let calc;
  beforeEach(() => { calc = new Calculator(); });

  test("add: 正の数同士の足し算", () => {
    expect(calc.add(2, 3)).toBe(5);
  });

  test("divide: ゼロ除算でエラー", () => {
    expect(() => calc.divide(10, 0)).toThrow("Division by zero");
  });
});

シナリオ：変更をコミットしてプッシュしたい

> 今の変更内容を確認して、適切なコミットメッセージで
  コミットしてください。

Claude Codeの動作：

1. git status で変更ファイルを確認
2. git diff で差分を確認
3. 変更内容を分析し、コミットメッセージを作成
4. ユーザーに確認を求めてからコミット実行

# Claude Codeが実行するコマンド
$ git add src/calculator.js tests/calculator.test.js
$ git commit -m "feat: Calculator クラスにユニットテストを追加"

シナリオ：バラバラなファイル名を統一したい

> images フォルダの中にあるファイル名がバラバラです。
  すべて「YYYY-MM-DD_連番.jpg」の形式にリネームしてください。
  撮影日時はExifデータから取得してください。

Claude Codeはスクリプトを作成し、Exifデータを解析して一括リネームを実行します。実行前に変更一覧を表示して確認を求めます。

シナリオ：他の人が書いたコードをレビューしたい

> src/ フォルダ以下の全ファイルをレビューしてください。
  セキュリティ上の問題、パフォーマンスの改善点、
  コードスタイルの統一について指摘してください。

Claude Codeの動作：

1. src/ フォルダの全ファイルを読み込み
2. セキュリティリスク（SQLインジェクション、XSS等）を検出
3. パフォーマンスの改善点を分析
4. 指摘事項をまとめたレポートを出力
5. 希望すればその場で修正も可能

シナリオ：APIドキュメントを自動生成したい

> api/ フォルダ内のPHPファイルを読んで、
  各エンドポイントのAPIドキュメントをMarkdownで作成してください。
  リクエスト/レスポンスの例も含めてください。

Claude Codeがコードを解析し、エンドポイント一覧、パラメータ、レスポンス形式を含むAPIドキュメントを自動生成します。

シナリオ：複雑なSQLクエリを書きたい

> usersテーブルとordersテーブルを結合して、
  過去3か月の注文金額が合計10万円以上のユーザーを
  金額の多い順に取得するクエリを書いてください。
  テーブル構造はdb/schema.sql を見てください。

Claude Codeがスキーマファイルを読み、テーブル構造を理解した上で正確なSQLクエリを作成します。

SELECT u.id, u.name, u.email, SUM(o.amount) AS total_amount
FROM users u
JOIN orders o ON u.id = o.user_id
WHERE o.created_at >= DATE("now", "-3 months")
GROUP BY u.id
HAVING total_amount >= 100000
ORDER BY total_amount DESC;

シナリオ：FTPでサーバーにアップロードするスクリプトが欲しい

> 本番サーバーへのFTPデプロイスクリプトを作成してください。
  node_modules と .env は除外し、変更があったファイルだけ
  アップロードするようにしてください。

Claude Codeがプロジェクト構成を確認し、必要なファイルだけをアップロードするシェルスクリプトまたはPHPスクリプトを作成します。

シナリオ：新しいReactプロジェクトを作りたい

> TypeScript対応のReactプロジェクトを作成してください。
  ESLint、Prettier、Tailwind CSS も設定してください。
  Gitの初期化もお願いします。

Claude Codeが一連のコマンドを実行し、設定ファイルの作成・調整まで行います。手動なら30分以上かかる環境構築が数分で完了します。

やってみよう

以下の課題を頭の中でシミュレーションしてみましょう。「Claude Codeにどう指示すれば良いか？」を考えてみてください。

1. 会社のWebサイトに「お問い合わせフォーム」を追加したい
2. CSVファイルのデータをHTMLのテーブルに変換したい
3. 既存のJavaScriptコードをTypeScriptに変換したい

答え合わせはインストール後に実際に試してみましょう！