トップ / ガイド

非エンジニアが Claude Code で止まる「8つの壁」と、越え方の要点

AIでアプリを作り始めて止まってしまうのは、才能のせいではありません。止まる場所は、だいたい決まっています。

私はその場所を、8つの壁に分けています。1〜3つ目は作り始める前、4〜5つ目は作っている途中、6〜8つ目は「作れた」の先にある壁です。どこで止まっているかが分かれば、次の一手が決まります。

Claude Code を例に書いていますが、Cursor や Codex など、ほかのAI開発ツールでも考え方は同じです。途中で分からない言葉が出てきたら、AI開発の用語集をご覧ください。

作り始める前の壁(1〜3)

1つ目の壁 作るものを決める

最初の版が大きすぎると、作る前に力尽きます。

AIは「全部入りで作って」と頼めば、本当に全部を一度に作ろうとします。画面は一見それらしく出てきますが、どこか1か所が動かなくなったとき、量が多すぎて、どこが悪いのか分からなくなります。

越え方の要点:最初の版は、機能3つ以内の「最小の一個」に切ります。「〇〇を入れると、〇〇が出る」の1文で書ける大きさが目安です。

2つ目の壁 AIに頼む

「〇〇を作って」の一言では、AIは推測で埋めます。

誰が使うのか、何を入れて何を見たいのか。分からないところを、AIはそれらしく埋めます。できあがったものが「なんだか違う」となり、直してもらううちに、どんどん遠ざかっていきます。

越え方の要点:頼む前に3行の「注文書」(使う人/入れるもの/出てくるもの)を書きます。具体例を1組そえて、一度に頼むのは1つの機能だけにします。

3つ目の壁 道具をそろえる

「黒い画面」とインストールで止まる方は少なくありません。

手順どおりに進めたのに、よく分からないメッセージが出て止まる。AIの開発ツールは更新が速く、少し前の手順がもう合わないこともあります。手順どおりなのに動かないのは、あなたのせいではないかもしれません。

越え方の要点:出てきた文字は写真ではなくコピーで、Mac か Windows かをそえてAIに聞きます。作業用のフォルダは1つに決めて、いつもそこから始めます。

作っている途中の壁(4〜5)

4つ目の壁 エラーを読む

エラーは敵ではなく、どこが悪いかを教えてくれる道案内です。

英語の赤い文字が何十行も出ると、それだけで閉じたくなります。「直して」とだけ頼むと、AIはエラーを消すことだけを目指し、エラーは消えたのに欲しかった動きではなくなっている、ということも起きます。

越え方の要点:AIには3点セット(エラーの全文/直前にやったこと/本当はどうなってほしいか)で聞きます。同じエラーが3回続いたら、同じ聞き方をやめて「ほかに考えられる原因を3つ挙げて」と聞き方を変えます。

5つ目の壁 保存とやり直し

「昨日まで動いていたのに」で止まる壁です。

AIに1か所を直してもらうと、別の場所が壊れる。それを直すと、最初の場所がまた壊れる。この「もぐらたたき」に入ると、多くの方がここで疲れて手を止めます。

越え方の要点:動いたら「今の状態を Git で保存して」と頼みます。直すたびに別の場所が壊れるようになったら、直すのをやめて、保存したところに戻ります。

「作れた」の先の壁(6〜8)

6つ目の壁 データとログイン

画面が動くことと、使い続けられることは別の話です。

入力欄があって、ボタンを押すと一覧に追加される。「できた」と思って次の日に開くと、入れたはずのデータが消えている。ログイン機能を作ろうとして止まるのも、よくあるつまずきです。

越え方の要点:データの置き場所は「誰が、どこから、どのくらいの量を使うか」で決めます。ログインは、本当に今必要かを先に考えます。置き場所の選び方は、用語集のデータベースの項にも書いています。

7つ目の壁 公開する

「自分のパソコンで動く」から「URLで誰でも開ける」へ。

「あとは公開するだけ」と思っていたら、そこからが長かった、という話はよくあります。どこに置くか、URLをどうするか、毎月いくらかかるか、直したときにどう反映させるか。決めることが次々に出てきます。

越え方の要点:公開先の候補は1つに絞ってから進みます。費用と、直したときの反映の方法を先に確かめます。

8つ目の壁 人に使ってもらう前に

自分だけのときは問題にならなかったことが、問題になります。

APIキーやパスワードがプログラムに書かれたまま公開されると、他人に使われてしまうおそれがあります。アプリの中からAIを呼び出すなら、使った分だけ料金がかかる仕組みが多くあります。

越え方の要点:秘密の情報・AIの利用料の上限・個人情報の3点を点検します。最初の一手は、AIに「このプロジェクトに、外に出してはいけない情報が書かれていないか点検して」と頼むことです。

前半と後半で、壁の性質が違います

1〜5つ目の壁は「知っていれば越えられる」壁です。コツを知り、手を動かしていれば、一人でも越えていけます。

6〜8つ目の壁は「判断が要る」壁です。AIに聞けば答えは返ってきます。ただ、その答えが自分のアプリにとって正しいのか、安全なのかを判断するには、経験が要ります。AIの答えをそのまま使って、あとから大きな手戻りになりやすいのも、こちらです。

いま、どの壁の前にいますか

8つの壁を40のチェックに分けたチェックリストを、無料でお配りしています。上から順に✓を付けていくと、✓が付かなかった項目が最初に出てくる壁が、いまあなたがいる場所です。その先の壁は、今は気にしなくて大丈夫です。

登録の翌日からは、壁を1日1つずつ取り上げて、越え方をメールで詳しくお話しします。

Claude Code 詰まりどころチェックリストの表紙
無料のPDF・7ページ

AIでアプリを作り始めて、止まっていませんか。

止まりやすい場所を8つの壁・40のチェックにまとめた「Claude Code 詰まりどころチェックリスト」を、メールでお届けしています。翌日からは、壁の越え方を1日1つずつお送りします。

▶ チェックリストを無料で受け取る