企画書ファイルひとつでClaude Codeの誤作動を減らす方法

コーディングを知らない起業家がClaude Codeを使いながら最も頻繁に犯すミスは、対話するようにコードを書いてしまうことです。最初は物珍しくてあれこれ指示しているうちに、ある瞬間、AIが支離滅裂なコードを吐き出し始めます。プロジェクトが大きくなるほど、AIは最初に何を作ろうとしていたのかを忘れてしまうからです。これを防ぐには、ターミナルを叩く前に日本語の設計図から作る必要があります。

product_spec.mdファイルが稼いでくれる時間

開発の知識がなくても、サービスの骨組みは自分で作らなければなりません。プロジェクトフォルダの最上位にproduct_spec.mdというファイルを作成してください。ここに、作りたいサービスの目的、必須機能、ユーザーが画面でどのように動くかを日本語で詳しく書き留めておけばいいのです。

準備ができたら、ターミナルでClaude Codeを実行し、プランモード（Plan Mode）に入ります。その後、「この文書の内容通りに実装計画を立てて」と指示します。Anthropicの観察結果によると、このように事前に定義された仕様に基づいて開発した場合、後でこじれたコードを解くために費やす時間を5時間以上節約できます。

APIキーの流出で1,000万円の請求書を受け取らない方法

セキュリティは後回しにするものではありません。2024年の統計によると、GitHubに誤って露出される機密情報は毎年2%以上増加しています。特にAIエージェントは、人間が書くときよりもセキュリティ情報を露出させる確率が2倍も高いです。実際にGoogle CloudのAPIキーが流出し、わずか2日間で8万2千ドル、日本円で1,000万円を超える料金が請求された事例もあります。個人起業家にとっては、事業を畳まなければならないほど致命的な事故です。

コードを書く前に、たった3つのことだけを先に行ってください。

• ターミナルにtouch .envと入力してファイルを作成し、すべてのパスワードとAPIキーはここだけに書くようClaudeに命じてください。
• .gitignoreファイルを作成し、その中に.envと書き込みます。このファイルが自分のコンピュータの外に出るのを防いでくれます。
• Claudeの設定ファイル(~/.claude/settings.json)で、.envファイルへのアクセス権限を拒否に設定してください。

こうすることで、自動化されたハッキングボットがあなたの大切な認証情報を盗んでいく状況を根本から遮断できます。

画面が表示されない時はブラウザのコンソールをコピーしましょう

コードはすべて書き終えたというのにブラウザの画面が真っ白だと、慌ててしまいます。しかし、そんな時に高い外注開発者を探す必要はありません。ブラウザがすでに正解を教えてくれているからです。

ウェブブラウザでF12キーを押すと、コンソール（Console）ウィンドウが表示されます。そこに表示されている赤色のエラーメッセージをすべてコピーして、Claude Codeのターミナルにそのまま貼り付けてください。「このエラーが出ているので、原因を探して直して」と一言添えるだけで十分です。技術を知らなくても、エラーメッセージさえしっかり伝えれば、AIがあなたの目や耳となってバグを仕留めてくれます。

90%のコストを節約するロールバックの習慣

Claude Codeは、使用したトークン量に応じて料金が発生します。1日に12ドル前後で利用するユーザーがほとんどですが、同じ質問を繰り返したり、大きすぎる塊の作業をさせたりすると、料金が跳ね上がる可能性があります。

コストを抑えるには、作業を細かく分割する必要があります。ログイン機能ひとつ、メニューバーのデザインひとつといった具合に、個別にリクエストしてください。そして、ひとつの機能が成功するたびに「これまでの作業をコミット（Commit）して」と指示しましょう。ゲームのセーブポイントのようなものです。もしAIがコードをめちゃくちゃに書き換えてしまったら、慌てずにターミナルでgit reset --hard HEADと入力してください。たった今成功していた状態に、魔法のように戻ります。この習慣ひとつが、不要な再修正コストを90%まで削減してくれます。