困ったとき
誰でも、簡単に、素早く、アプリが出来る。プログラムは書きません。AI に日本語で頼むだけです。
手を挙げて、サポーターを呼んでください。サポーターの方は、この表から探してください。
Cloudflare の登録・ログイン・初めての公開でつまずいたら、先に「Cloudflare でつまずくところ」を見てください。
よくあること
| 症状 | 原因 | 直し方 |
|---|---|---|
| start.bat を開くと「開いているファイル - セキュリティの警告」と出る | インターネットから取ってきたファイルなので、Windows が念のため確認している | 「実行」を押す |
| start.bat の黒い画面が、すぐに消える | zip の中から直接開いている | starter.zip を右クリック →「すべて展開」してから、展開したフォルダの start.bat を開く |
| start.bat を開いたら「管理者として実行されていません」と出た | ダブルクリックで開いた（管理者の許可が要る） | 閉じて、start.bat を右クリック →「管理者として実行」→「はい」。別の人（管理者）のパスワードを聞かれたら、サポーターを呼ぶ |
| publish.bat でエラーが出て進まない | パソコンの設定で、管理者の許可が要ることがある | publish.bat も右クリック →「管理者として実行」→「はい」 |
| 黒い画面に「Node.js を自動で入れられませんでした」と出る | winget が使えない／会社の設定で止められている | 開いたページから入れて、もう一度 start.bat を管理者として実行。会社のパソコンは管理者に確認する |
| 「スクリプトの実行が無効になっているため…」と出て止まる | PowerShell で npx を動かした（初期設定の Windows では禁止されている） |
公開は publish.bat をダブルクリック。Claude には「npx.cmd を使って」と送る。Windows の設定は変えない |
| ログインでブラウザが開かない | ブラウザが自動で開けなかった | 黒い画面に出ている長い URL を、自分でブラウザに貼る |
| 「register a workers.dev subdomain」と英語で聞かれた | 自動で決める URL の一部の名前が、使えなかった（まれ） | y を押し、小文字の英数字で好きな名前（例：会社名）を入れて Enter。ふだんは名前が自動で決まり、聞かれない |
| Claude に「publish.bat をダブルクリック」と言われた | アカウントの選択か、上の質問（まれ）に答える必要がある | publish.bat をダブルクリックして、質問に答える（Mac は、Claude が出したコマンドをターミナルで実行） |
| Mac で「Password」と出て、文字を打っても何も表示されない | パスワードは表示されない仕組み | そのまま Mac のパスワードを打って Enter |
| Claude がコマンドを実行せず、「次を実行してください」と返す | 「チャット」で開いている | Code に切り替え、my-app フォルダを開き直す |
| Code が見当たらない | 無料プランのまま／アプリが古い | プランを確かめる。アプリを最新にする |
| Code に切り替えたら、英語のインストール画面が勝手に出た | Claude のアプリが Git を入れようとしている | すべて「次へ（Next）」→「Install」→「Finish」。終わったら Claude アプリを開き直す |
| 「git が見つからない」と言われる | Git が入っていない | 「2. Git の準備」 |
| 実行してよいかを何度も聞かれる | 許可の設定がまだ読まれていない（前に starter.zip をダウンロードした人は、許可の設定が古い） | そのつど「許可」を押す。続くときは Code で新しいセッションを始める |
| 英語で「(y/n)」「Ok to proceed?」と聞かれる黒い画面で止まった | Cloudflare の道具が、確認の質問をしている | 黒い画面を閉じて、Claude に「黒い画面を開かずに、質問が出ないようにして（CI=1 を付けて）、あなたが自分で実行して」と送る |
| 初めて公開したら「サーバーが見つかりません」（Mac の Safari）と出る | URL が開けるようになるまで数分かかる。その前に開いたので、パソコンが「無い」を覚えている | 30分ほど待って開き直す。急ぐときは、スマホの Wi-Fi を切って（モバイル回線で）開く。アプリは公開できている |
| 公開したのに前の画面のまま | ブラウザが前の画面を覚えている | 再読み込み（Windows：Ctrl + F5 ／ Mac：command + shift + R） |
| アプリが動かない・真っ白 | 作ったアプリに不具合がある | 「動きません。直して」と送る。起きていることを書き足すと早い |
| ドラッグしたファイルを見つけてもらえない | ファイルの場所が伝わっていない | my-files にコピーして「my-files に入れたファイルを、アプリにしてよ」 |
| .doc / .xls が読めない | 古い形式 | Word / Excel で .docx / .xlsx として保存し直す |
| 自分のファイルのアプリを「公開して」と頼んだら、確かめられた | 本物のデータが誰でも見られる場所に出ないよう、1回だけ聞いている | 大丈夫なら「はい」。心配なら「本物のデータを架空のデータに差し替えてから、公開して」 |
Node.js を自分で入れる
start.bat（Mac は「4. 準備する」の1行）で入れられなかったときだけ、自分で入れます。
Windows の場合
- Windows 用のインストーラー（.msi）をダウンロードして開き、何も変えずに「Next」 で進める
- 入れ終わったら、もう一度 start.bat を開く
Mac の場合
- macOS 用のインストーラー（.pkg）をダウンロードして開き、そのまま「続ける」で進める
- 入れ終わったら、「4. 準備する」の1行をもう一度ターミナルに貼る
遅れてしまったら
- 準備（4）の公開で止まっていても、作業フォルダ（
my-app）ができていれば、6・7 のアプリ作りはできます。 公開は、あとで publish.bat（Mac は「公開して」）で追いつけます - 6 で時間が足りなければ、注文をつける（6-2）はとばして、7 に進んでください
ハンズオンのあとで困ったら
質問はいつでも受け付けています。LINE（@sanyosan）か Facebook（noriyukimaeoka）へどうぞ。