Claude Codeの使い方とエージェント設計：小さく実装し検証する

この分野の考え方

コードを多く変更することと、依頼された問題を解決することは別です。この経路では、変更してよい範囲と触れない範囲を先に決め、作業量ではなく利用者の行動が成立するかで完了を判断します。

不具合は症状だけを伝えるより、入力、手順、期待、実際の結果に分けると検証可能になります。修正後のテストも、その症状を捉えるものか、実装の形をなぞっているだけかを点検します。

複数の作業やツールをつなぐ時は、権限、予算、停止条件を独立して設計します。自動化を追加する前に、一回の変更で必要な証拠が揃うかを確認すると、繰り返し作業の目的を見失いにくくなります。

おすすめの学習順序

1. Claude Codeへ修正を依頼する：完了条件と変更範囲を小さく定める

   依頼の範囲と、完了を判定する行動を定義します。

   次へ進む目安：変更対象と対象外、期待動作を短く記録できる。

2. Claude Codeのバグ修正：症状から再現条件へ絞り込む

   実装前に失敗を再現し、修正の効果を見分けます。

   次へ進む目安：同じ入力で失敗と修正後の成功を確認できる。

3. Claude Codeが書いたテストを読む：実装の写しではなく失敗を検出する

   通ったテストが、実際に何を保証するかを説明します。

   次へ進む目安：証拠の対象ソースと未検証条件を分けられる。

4. Claudeエージェントの停止条件：回数だけでなく進捗と危険を監視する

   進展のない繰り返しや範囲拡大を止めるためです。

   次へ進む目安：停止、相談、再開の条件を具体的に書ける。

よくあるつまずき

• 小さな修正から、依頼されていない再設計へ広げる。
• テスト件数だけで完了と判断する。
• 並列化や再試行を増やせば必ず速く終わると考える。

まとめの確認課題

小さな既存不具合を一つ選び、再現手順、変更範囲、修正後の確認、停止条件を一枚にまとめてください。

• 依頼の行動に対応する再現例がある。
• 最終ソースに対して必要な確認が終わっている。
• 解決できない場合に残す情報と相談条件が明確である。

学習用の課題です。実際の業務では、対象サービスの公式資料と所属組織のルールを確認してください。

この分野の全10記事

• Claude CodeのCLAUDE.mdを育てる：規則と作業記録を分ける

  毎回の説明を減らしながら古い指示を蓄積しない方法。長く保つ規則、今回の目標、過去の検証結果を別に管理します。

• Claude Codeへ修正を依頼する：完了条件と変更範囲を小さく定める

  曖昧な改善依頼を、実装して検証できる仕事へ変換。現状、期待動作、維持条件、確認方法を具体化します。

• Claude Codeのバグ修正：症状から再現条件へ絞り込む

  すぐに修正案を増やす前に、入力、環境、直前の状態を整理する手順。仮説を一つずつ検証し、直った理由を説明します。

• Claude Codeが書いたテストを読む：実装の写しではなく失敗を検出する

  テスト数を品質と混同しないためのチェック。期待動作、独立した正解、失敗時の確認、入力範囲を整理します。

• Claude Codeでリファクタリングする：振る舞いを保つ範囲を決める

  コードの整理を機能変更へ広げないための設計。外部契約、データ形式、エラー、並行処理を維持条件として確認します。

• Claude Codeの作業を引き継ぐ：ブランチ・差分・検証状態を照合する

  会話の要約だけでは復元できない開発状態を整理。未コミットの変更、検証した版、公開の有無を分けて記録します。

• ClaudeとMCPを接続する：できることと許可することを分ける

  外部ツールの接続を権限の設計から考えるガイド。読み取りと更新、引数、結果の説明、認証の責任を整理します。

• Claudeでワークフローかエージェントかを選ぶ：変化する判断を見極める

  処理を自律化する前に、固定できる手順と動的な探索を分ける方法。失敗時の追跡、待ち時間、費用も含めて判断します。

• Claudeエージェントの停止条件：回数だけでなく進捗と危険を監視する

  長い処理が同じ作業を繰り返す原因を整理。予算、時間、情報の増分、実行済み操作を使って終了を判断します。

• Claudeエージェントを並列化する前に：独立性と統合の責任を設計する

  複数の処理を同時に走らせる際の入力分割、共有状態、矛盾した結果の扱いを整理。速さだけで判断しないためのガイドです。