Claude Codeに頼む前に確認したい、たった3つの質問

Claude Codeを使った自動化スクリプト開発が、個人開発の現場でも少しずつ当たり前になってきた。コードを書く速度が上がるのは事実だが、一方で「生成してもらったのに動かない」「数ヶ月後に突然止まった」という経験をする人も増えている。

こうした失敗の多くは、Claude Codeの能力の問題というより、依頼側の準備不足によるものだと感じている。生成AIはコードの文法的な正しさや、一般的な設計パターンには長けているが、目の前のサービスが今どういう仕様になっているかまでは知り得ない。この前提を理解した上で依頼しないと、生成されたコードがそのまま「最後まで動かない」という結果になりやすい。

依頼前に自分に問いかけている質問が3つある。

1つ目は「入力と出力の形が今すぐ言葉にできるか」。CSVを読んでSlackに通知する、APIを叩いてJSONを整形する、といったように入出力の形が固まっているタスクは、Claude Codeが得意とする範囲に収まりやすい。「状況によって変わる」という部分が入出力に含まれているなら、まずそこを設計段階で決め切る。

2つ目は「失敗したらどうするかを3つ言えるか」。リトライするのか、スキップするのか、通知するのか。この異常系の設計を先に言語化してから依頼すると、生成されるコードが初回から異常系を含んだ実用的な品質になりやすい。

3つ目は「手元で何度でも試せるか」。本番データや本番の決済フローに直結する処理をいきなり自動化しようとすると、動作確認のたびにリスクが発生する。まずローカルやテスト環境で繰り返し実行できる状態を作ってから着手するのが、結果的に一番速い。

この3つを事前に整理してから依頼するだけで、生成されるコードの質と、その後の保守のしやすさが変わってくる。向き不向きを見極めるための具体的なチェックリストと、依頼文のテンプレートはまとめて別でも用意しています。https://coconala.com/contents_market/articles/cmufllea702fpbc0h7lmc7vsm