Claude Codeを使えば、非エンジニアでもアプリ開発に手が届くようになりました。
「こういう画面にしたい」 「このボタンを押したら、こう動いてほしい」
そう伝えると、AIがコードを書いてくれる。 これは本当に大きな変化です。
ただ、実際に使い始めた私が最初にぶつかったのは、コードの壁ではありませんでした。
コードを書く前の壁です。
- ターミナルの黒い画面が怖い
- 英語のエラーが出ると止まる
- フォルダやファイルの場所が分からない
- どこを直せばいいのか分からない
- AIに何を聞けばいいのか分からない
この記事では、非エンジニアがClaude Codeを使い始めたときに感じやすい壁を整理します。
「自分には無理かも」と感じる前に、何でつまずいているのかを分けて考える。 それだけで、見える景色が変わります。
最初の壁は、コードそのものではない
使い始める前、私は「難しいのはコードを書くことだ」と思っていました。
違いました。
非エンジニアが最初につまずくのは、コードの中身よりも、その手前です。
たとえば、ターミナル。 黒い画面に文字だけが並んでいて、そこにコマンドを打つ。 これだけで、何かとんでもなく専門的なことをしている気分になります。
そして、何かを実行すると英語のエラーが出る。
Error: file not foundこの表示が出た瞬間の心境を、正直に書きます。 「何か壊したかもしれない」「もう触らないほうがいいかも」でした。
でも、実際のエラーの多くは、「指定したファイルが見つからない」「コマンドを実行する場所が違う」といった、原因をたどれば直せるものです。
怖いのはエラーそのものではなく、何が起きているのか見えないことだったんです。
非エンジニアが最初につまずく3つの場面
つまずきやすい場面は、大きく3つです。
1つ目は、コマンドが分からないことです。
何を打てばいいのか。この文字列をどこに貼ればいいのか。実行していいのか。
Excelやブラウザのように画面を見ながら操作してきた人にとって、文字だけで操作するターミナルは、完全に異世界です。
2つ目は、エラーが読めないことです。
エラーは英語で出ます。長い文章や記号も混ざります。
何が悪いのかを考える前に、見た目で圧倒される。 これが実態です。
3つ目は、ファイルの場所が分からないことです。
Claude Codeが何かを作ってくれても、どこに保存されたのか、どのファイルを直しているのかが分からない。
家の中で物を探すのに、部屋の名前も棚の場所も分からない状態です。 探し物以前に、不安になります。
「分からない」の中身を分けると進みやすい
止まったとき、「全部分からない」と感じます。 私も何度もなりました。
でも、分からない内容は、実は3つに分けられます。
- 今どこにいるのか分からない —— 作業場所の問題
- 何を直せばいいのか分からない —— 原因の問題
- 次に何を聞けばいいのか分からない —— 質問の問題
似ているようで、全部違います。
作業場所の問題なら、フォルダの確認。 原因の問題なら、エラーなのか、表示崩れなのか、期待と違うだけなのかの切り分け。 質問の問題なら、一気に聞かず、一つずつ。
「全部分からない」をこの3つに分けるだけで、次の一歩が見えます。
エラーは「怒られている」のではなく「場所を教えてくれている」
赤い文字のエラーを見ると、「失敗した」「壊した」「自分には無理だ」と感じます。
でも、エラーは怒っているのではありません。
「ここで止まっています」 「このファイルが見つかりません」 「この設定が足りません」
と、場所を教えてくれているんです。
そして、ここが一番大事なのですが——エラーを自分で解読しようとしなくていい。
そのままAIに貼ればいいんです。
このエラーの意味を、非エンジニアにも分かるように説明してください。
何が原因で、次に何を確認すればいいかを順番に教えてください。
（ここにエラー全文を貼る）エラー文は、怖いものではなく、AIに渡す材料。 この見方に変わってから、私はエラーで止まらなくなりました。
まず確認するのは「今いる場所」
Claude Codeで作業するとき、最初に意識するのは「今どの場所で作業しているか」です。
アプリ開発では、フォルダの場所が命です。 同じコマンドでも、実行する場所が違うと動きません。
この「場所」の感覚、非エンジニアには最初ピンと来ません。 でも、難しく考えなくて大丈夫。Claude Codeに聞けばいいんです。
今、どのフォルダで作業していますか？
このプロジェクトの主要なフォルダとファイルを、初心者向けに説明してください。
次に触る可能性が高いファイルも教えてください。これだけで、地図が手に入ります。
アプリ開発は、知らない街を歩くようなもの。 いきなり目的地まで走ると迷います。 まず、現在地の確認。それだけで次の一歩が踏み出せます。
全部理解してから進めようとしなくていい
ターミナルも分からない。英語エラーも分からない。ファイル構成も分からない。コードも読めない。
「全部理解してから進めよう」とすると、最初の数分で心が折れます。
全部は要りません。 見るのは、次の一手だけです。
- 今どのフォルダにいるか
- どのファイルを触っているか
- エラーは何を言っているか
- 次に何を試せばいいか
初めて車を運転するとき、エンジンの構造は理解しませんよね。 アクセル、ブレーキ、ハンドル、ミラー。それだけ覚えれば走れます。
Claude Codeも同じです。 内部の仕組みを知らなくても、「今どこにいて、次に何をするか」が分かれば前に進めます。
AIに聞くときは、状況をそのまま渡す
止まったとき、うまく説明しようとしなくて大丈夫です。 状況をそのまま渡すほうが、むしろ伝わります。
Claude Codeで作業中です。
非エンジニアなので、状況を整理しながら進めたいです。
今起きていること：
・〇〇をしようとした
・このコマンドを実行した
・その結果、このエラーが出た
知りたいこと：
・何が起きているのか
・壊れているのか、それとも設定や場所の問題なのか
・次に何を確認すればいいのか
専門用語を少なめに、順番に説明してください。
エラー文：
（ここにエラー全文）病院で症状を伝えるのと同じです。 病名を自分で言えなくても、「いつから」「どこが」「どう痛いか」を伝えれば、医師は判断できます。
かっこいい質問は要りません。 「何をしたら、何が起きたか」をそのまま渡す。それだけです。
Claude Codeは魔法ではなく、隣で作業してくれる相手
Claude Codeは便利ですが、魔法の道具ではありません。 こちらが何も分からないままでも全部やってくれる、わけではない。
でも、隣で一緒に作業してくれる相手として見ると、これほど心強いものはありません。
「これは何ですか？」 「今どこを見ていますか？」 「次に何をすればいいですか？」
一度で全部分からなくても、会話しながら進めればいい。
非エンジニアに必要なのは、コードを全部読める力ではなく、止まったときに状況を切り分けられる力です。
ターミナルで止まったのか。エラーで止まったのか。ファイルの場所で迷っているのか。聞き方で止まっているのか。
これを分けられるだけで、Claude Codeとの付き合い方は変わります。
まとめ：最初の壁は、分ければ小さくなる
非エンジニアがClaude Codeで感じる最初の壁は、大きく3つ。
- ターミナルの黒い画面に身構える
- 英語のエラーで止まる
- フォルダやファイルの場所が分からない
これは、コードの才能がないから起きる壁ではありません。 初めて触る道具だから、戸惑っているだけです。
やることは、
- 今いる場所を見る
- エラーをそのままAIに渡す
- 小さく試して、少しずつ広げる
最初の一歩で必要なのは、技術より「状況を整理する力」。
分からないことを、ひとまとめにしない。 それだけで、黒い画面も英語のエラーも、少しずつただの道具に見えてきます。
関連記事
すでに似たサービスがあっても、一度自分で作ってみることの意味はこちらで整理しています。
実際に家族用アプリを作った経験と気づきはこちらです。
コードを書く前に、画面イメージを言葉にする大切さについてはこちらです。
Claude CodeとChatGPTをどう使い分けているかは、こちらで実例つきで書いています。
Claude CodeとChatGPTをどう使い分けているか｜非エンジニアの実例
ナギのまとめコメント
Claude Codeを初めて使ったとき、一番つらかったのは「何が分からないか分からない」状態でした。
でも、つまずいている場所を分けてみたら、一つひとつは意外と小さかった。
黒い画面も、英語のエラーも、最初は怖い。 でも、そのまま貼って聞けばいい。全部分からなくても、次の一手だけ分かればいい。
そう思えるようになってから、手が動くようになりました。