⚠️ エラー逆引き

Windowsでは xxx : 用語 'xxx' は、コマンドレット、関数、... として認識されません と表示されます。意味は同じです。

原因: 次の3つのどれかです。 (1) コマンドの打ち間違い。 (2) その道具がまだインストールされていない。 (3) インストールはしたが、パソコンがまだ置き場所を知らない。

対処: まず手打ちをやめて、ページのコピーボタンで貼り直してください。 次に、ターミナルを閉じて開き直してください。 入れた直後は置き場所が読み込まれていないことがあります。 VS Codeの中のターミナルを使っている場合は、VS Codeごと閉じて開き直すと確実です。 それでも出る場合は、その道具を入れるページに戻り、インストールを確認します。

原因: 日本語入力がオンのまま打つと、見た目がそっくりな全角文字になります。 コンピュータにとって、半角の ls と全角の ｌｓ は別物です。 全角スペースが混ざった場合は、見た目では気づけません。

対処: Macは「英数」キー、Windowsは「半角/全角」キーで日本語入力を切り、打ち直してください。 このサイトのコマンドは、コピーボタンで貼れば全角にはなりません。

原因: 指定した名前の場所が、そこには存在しません。 綴りの間違い、大文字と小文字の違い、または「いまいる場所」が想定と違うのが定番です。

対処: いまいる場所と、そこにある名前を確認します。

pwd

ls

表示された一覧に目的の名前があるか、綴りの1文字目から見比べてください。

原因: 故障ではありません。 ターミナルは、のぞき見防止のためにパスワードを画面に表示しません。 文字数のぶんの「●」すら出ない仕様です。

対処: 何も見えないまま、パソコンのログインパスワードを打って Enter を押してください。 間違えると Sorry, try again と出るので、もう一度打てば大丈夫です。

原因: その場所やファイルを操作する権限が、いまのあなたにありません。 システム領域など、触るべきでない場所を触ったときにも出ます。

対処: まず、作業場所が ai-tools の中など、自分のホームフォルダの下かを確認してください。 それでも解決しない場合は、エラー全文をClaudeに貼って相談します。 sudo を付けて再実行する対処を勧める記事もありますが、意味を理解するまでは使わないでください。

command not found: npx も同じ意味です。

原因: 公開に使う部品（Node.js）が、まだパソコンに入っていません。

対処: 自分で入れに行かなくて大丈夫です。 図解ツールに「Node.jsが入っていないようです。入れ方を案内してください」と伝えてください。 確認したうえで、入れるところまで案内してくれます。

途中でパソコンのパスワードを聞かれることがあります。画面に何も表示されませんが、そのまま打ってEnterで進みます。

原因: 故障ではありません。公開先のアカウント登録が始まっています。

対処: メールアドレスを打ってEnter → 決めたパスワードを打ってEnter、の順です。 使ったことのないメールアドレスなら、その場でアカウントが作られます。 登録ページを開く必要はありません。

⚠️ パスワードは画面に表示されません。それが正常です。 ⚠️ パスワードは、AIとの会話欄には打たないでください。ターミナルに直接打ちます。

打ち間違えたときは Ctrl+C でいったん止めて、もう一度やり直せます。

原因: 前に一度受け取り済みです。エラーですが、困ったことは起きていません。

対処: そのまま次の手順に進んでください。受け取り直す必要はありません。 中身を最新にしたいときは、Claudeにこう伝えてください。

原因: npm ERR! はエラーの見出しで、本当の理由はその後ろに書かれています。 EACCES は権限の問題、ENOENT はファイルが見つからない、など種類はさまざまです。

対処: 自力で読み解く必要はありません。 エラーの最初の行から最後の行まで、全部コピーしてClaudeに貼ってください。

（10ステップの手順書では出ません。詳しい版でアプリを作るときのエラーです。）

原因: 前に起動した開発サーバー（npm run dev など）が、まだ動いたままです。 同じ番号の窓口（ポート）は、同時に1つしか使えません。

対処: 開いているターミナルのウィンドウとタブを、すべて確認してください。 サーバーが動いている画面で Ctrl+C を押すと止まります。 見つからないときは、ターミナルを一度すべて終了してから、もう一度起動してください。

原因: GitHubに「あなた本人だ」と証明できていません。 GitHubはパスワードでの認証を廃止しているため、Webサイトのパスワードを打っても失敗します。

対処: 作ったものをGitHubに保存する の方法で、認証をやり直します。

gh auth login

質問には Enter で進み、ブラウザが開いたら許可します。終わったら確認します。

gh auth status

Logged in to github.com と出れば解決です。

原因: Claude Code があなたのアカウントを確認できていません。 未ログイン、認証の期限切れ、または別アカウントでのログインが原因です。

対処: Claude の入力欄で、サインインをやり直します。

ブラウザが開くので、Claudeのアカウントで許可します。 ブラウザが開かないときは、画面に表示されたURLをコピーして、自分でブラウザに貼ってください。 プランに加入していない場合は、先に Claudeの有料プランに入る を済ませてください。