非エンジニアが Claude Code で止まる「8つの壁」と、越え方の要点
2026年11月7日 更新 / かずゆき
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つずつ取り上げて、越え方をメールで詳しくお話しします。