メインコンテンツへスキップ
見出し画像

ターミナルの使い方|「黒い画面」が怖い初心者向け入門。WindowsとMacの開き方と最低限のコマンド【2026年10月】

    「ターミナルの使い方が分からない」「黒い画面を開くだけで怖い」「Claude Code や Codex を始めたいけど、最初のコマンドで止まってしまった」。この記事は、そんな方に向けたターミナルの入門です。

    この記事を読むと、ターミナルとは何か、Windows と Mac での開き方、「いまいる場所」の考え方、最低限のコマンド、パスの書き方、入力を楽にする技、コピー&貼り付け、よくあるエラーの直し方、やってはいけないことまで、一通り分かります。最後には、練習用のフォルダを作って移動し、claude や codex を起動する直前まで進みます。

    私は Claude Code と Codex を毎日使って、教材の原稿づくりから note・Gumroad への出品、画像づくりまでを自動化しています。どちらもターミナルで動かすことが多いので、ターミナルの基本は毎日使っています。ただ、私が日常で打つコマンドは、実は数個だけです。この記事では、その数個に絞って、つまずきやすい所も正直に書きます。全文無料です。

    コマンドは、Windows の PowerShell と、Mac の zsh(Mac の標準のターミナルで動く、命令を受け取るソフト)で動くものだけを載せています。

    この記事で分かること

    • ターミナルとは何か。「黒い画面」の正体と、怖くない理由

    • Windows と Mac でのターミナルの開き方

    • いまいる場所(カレントディレクトリ)の考え方

    • 最低限のコマンド(pwd・ls・cd・mkdir・フォルダを開く命令)

    • パスの書き方(絶対パスと相対パス、~・.・..)

    • Tab 補完、↑キー、Ctrl+C、コピー&貼り付け

    • 練習:フォルダを作って移動し、AI ツールを起動する直前まで

    • よくあるエラー(command not found、スペースを含むパス、権限)と対処

    • やってはいけないこと

    先に結論:覚えるのは6つだけ

    ターミナルには数え切れないほどのコマンドがありますが、Claude Code や Codex を使うだけなら、覚えるのは次の6つで足ります。

    • pwd:いま自分がどのフォルダにいるかを表示する

    • ls:いまいるフォルダの中身を一覧で表示する

    • cd フォルダ名:そのフォルダに移動する

    • mkdir フォルダ名:新しいフォルダを作る

    • Tab キー:途中まで打った名前の続きを自動で入れてくれる

    • Ctrl+C:動いているものを止める

    この6つの使い方を、順番に説明します。上の6つは Windows(PowerShell)でも Mac でも同じように使えます。

    ターミナルとは?「黒い画面」の正体

    ターミナルは、文字で命令を打ち込んでパソコンを動かすための画面です。マウスでアイコンをクリックする代わりに、「このフォルダに移って」「この名前のフォルダを作って」と、文字で書いて Enter キーを押します。

    映画のハッカーが使う画面のように見えるので怖く感じますが、中身は「フォルダを開く」「ファイルを見る」といった、普段やっている操作を文字で行っているだけです。

    ターミナル・シェル・PowerShell・zsh の関係

    名前がいくつも出てきて混乱しやすいので、先に整理します。

    • ターミナル:文字を打ち込んだり、結果を見たりするための「窓」です。Windows の「Windows Terminal」、Mac の「ターミナル」アプリがこれにあたります

    • シェル:窓に打ち込まれた命令を受け取って、実際にパソコンに伝えるソフトです。窓の中で動いています

    • PowerShell:Windows の標準のシェルのひとつです

    • zsh:Mac の標準のシェルです(macOS Catalina 以降の標準)

    ふだんは「ターミナル」とまとめて呼んで構いません。この記事も、窓とシェルをまとめて「ターミナル」と書きます。

    なぜ Claude Code や Codex でターミナルが出てくるのか

    Claude Code も Codex も、「いま開いているフォルダ」の中でファイルを読み書きして、コマンドを動かす AI です。このため、本来の使い方では、ターミナルで作業するフォルダに移動してから claude や codex と打って起動します。

    入門記事に出てくる最初の手順が、ほとんど同じ形なのはそのためです。

    cd claude-practice
    claude

    この2行の意味が分かれば、ターミナルの入口は越えられます。1行目は「claude-practice というフォルダに移動する」、2行目は「claude というプログラムを起動する」です。

    なお、ターミナルを使わなくても始める方法はあります。入門記事のとおり、Claude Code はデスクトップアプリやブラウザ、VS Code の拡張機能でも使えますし、Codex にもデスクトップアプリがあります。ターミナルがどうしても苦手なら、アプリから入るのも手です。ただ、アプリを使う場合も「いま作業しているフォルダはどこか」という考え方は同じです。この記事で身につく考え方は、どの入り口でも役に立ちます。

    怖くない理由

    最初に、安心できる点を3つ書きます。

    1. Enter を押すまで、何も実行されません。途中までの打ち込みは、何度でも消して打ち直せます

    2. 見るだけのコマンドが多い。この記事の pwd や ls は、見るだけです。何も壊れません

    3. 間違えたら、たいていはエラーの文が出て終わり。「そんなコマンドはない」と言われるだけで、パソコンが壊れることはほとんどありません

    ただし、1つだけ注意があります。ファイルを「削除する」コマンドは、ゴミ箱に入らず、元に戻せないことがあります。この点は、後半の「やってはいけないこと」で詳しく説明します。

    ターミナルの開き方(Windows)

    方法1:スタートメニューから開く

    1. 画面の下のスタートボタンを押す

    2. 「ターミナル」と入力する(Windows Terminal が入っている場合)。なければ「PowerShell」と入力する

    3. 出てきたアプリを押す

    もう1つの方法は、スタートボタンを右クリックして、出てくるメニューから「ターミナル」を選ぶことです。

    Windows Terminal は、最近の Windows 11 では標準で入っています。古い Windows 10 などで見つからないときは、スタートメニューの「Windows PowerShell」を使えば、この記事のコマンドは同じように使えます。

    管理者として開かない

    メニューに「管理者として実行」という項目が出ることがありますが、今回は選ばないでください。管理者の権限は、パソコンの大事な部分まで書き換えられる強い権限です。普通に開いたターミナルで、この記事の内容はすべて動きます。

    方法2:フォルダの中から開く

    エクスプローラーでフォルダを開いた状態で、何も無い所を右クリックし、「ターミナルで開く」を選ぶと、そのフォルダにいる状態でターミナルが開きます(Windows 11 の場合。項目名は版で変わることがあります)。

    もう1つ、エクスプローラーの上のアドレスバー(フォルダの場所が書いてある欄)に powershell と打って Enter を押す方法もあります。そのフォルダにいる状態で、PowerShell が開きます。

    画面の見方

    開くと、次のような1行が出ます。

    PS C:\Users\taro>

    これは「プロンプト」と呼ばれる表示です。意味は次のとおりです。

    • PS:PowerShell という意味です

    • C:\Users\taro:いまいる場所です(この例では taro さんのホームフォルダ)

    • >:ここから命令を入力してください、という印です

    プロンプトの右側が、命令を打つ場所です。点滅する四角(カーソル)があるはずです。

    PS が付いておらず、C:\Users\taro> とだけ出ているときは、PowerShell ではなく「コマンドプロンプト」(CMD)という別のソフトです。CMD では ls や pwd が使えないので、この記事の例が動きません。PowerShell を開き直してください。Claude Code の入門記事でも書きましたが、PowerShell か CMD かは、この PS の有無で見分けられます。

    ターミナルの開き方(Mac)

    方法1:Spotlight から開く

    1. キーボードの Command キーを押しながらスペースキーを押す(Command+スペース)

    2. 検索欄に「ターミナル」と入力する

    3. 出てきたアプリで Enter を押す

    方法2:アプリケーションフォルダから開く

    Finder で「アプリケーション」を開き、その中の「ユーティリティ」フォルダにある「ターミナル」をダブルクリックしても開けます。よく使うなら、Dock(画面下のアイコンの並び)に置いておくと便利です。

    画面の見方

    開くと、次のような1行が出ます。

    taro@MacBook-Air ~ %

    意味は次のとおりです。

    • taro:あなたのユーザー名

    • MacBook-Air:パソコンの名前

    • ~:いまいる場所。~ は「ホームフォルダ」を表す記号です(この後で説明します)

    • %:ここから命令を入力してください、という印です

    表示の形は、設定やパソコンによって少し違います。名前の部分が違っても気にしなくて大丈夫です。

    「$」や「%」は打たない

    ネット上の解説には、次のようにコマンドの前に $ や % が付いているものがよくあります。

    $ ls

    この $ は、「ここから入力します」という印を示しているだけです。打つのは ls だけです。Windows でも同じで、PS C:\> や > の部分は打ちません。この記事のコードブロックには、打つ部分だけを書いています。

    いまいる場所(カレントディレクトリ)の考え方

    ターミナルでいちばん大事な考え方がこれです。

    ターミナルは「いまいるフォルダ」の中で作業する

    ふだん、Windows のエクスプローラーや Mac の Finder では、フォルダを開くと、そのフォルダの中身が見えます。ターミナルにも同じ考え方があり、「いま、どのフォルダの中にいるか」が必ず決まっています。この「いまいる場所」を、カレントディレクトリと呼びます。

    ディレクトリは、フォルダの別名です。ターミナルの世界では「フォルダ」のことを「ディレクトリ」とよく呼びます。この記事でも、ここだけ両方の言葉が出てきますが、同じものです。カレントは「いま現在の」という意味です。

    つまり、カレントディレクトリは「いま開いているフォルダ」と同じ意味です。

    フォルダは木のような形になっている

    パソコンのフォルダは、フォルダの中にフォルダが入る、木の枝のような形をしています。

    ホームフォルダ(taro)
      ├─ デスクトップ
      ├─ ドキュメント
      └─ ai-practice
           └─ memo.txt

    ターミナルの cd は、この木の中を、枝をたどって移動する命令です。上の図の例で、ホームフォルダから ai-practice に入るには、cd ai-practice と打ちます。

    ホームフォルダとは

    ホームフォルダは、あなた専用のフォルダです。Windows では C:\Users\ユーザー名、Mac では /Users/ユーザー名 にあります。ターミナルを開いた直後は、たいていこのホームフォルダにいます。

    ここで、Windows の場合の補足です。ファイルを探すときに「デスクトップ」や「ドキュメント」があるのは、ホームフォルダの中です。ただし、OneDrive でバックアップを有効にしていると、実際の置き場所が OneDrive の中になっていることがあります。見た目は同じでも、ターミナルで開くと場所が違って戸惑うので、練習はホームフォルダの直下に作るのが確実です(後の練習でそうします)。

    なぜ Claude Code・Codex でこれが大事か

    Claude Code も Codex も、起動した場所を「作業するフォルダ」にして、その中のファイルを読み書きします。入門記事に「失敗しても困らない練習用のフォルダで始める」とあったのは、このためです。

    どこで起動するかで、AI が触れる範囲が決まります。何も考えずにホームフォルダのような広い場所で起動すると、AI が触れる範囲も広くなります。起動する前に、必ず pwd で「いまどこにいるか」を確かめる習慣をつけると、安心です。私も、AI ツールを起動する前には、いまいる場所を見るようにしています。

    最低限のコマンド

    ここからは、実際に打つコマンドです。それぞれ、Windows(PowerShell)と Mac で同じように使えます。

    打つときの約束が3つあります。

    1. コマンドも名前も、半角で打ちます。全角の文字や全角のスペースが混ざると、エラーになります(後で詳しく書きます)

    2. 打ち終わったら、Enter キーを押します。押すまで実行されません

    3. コマンドと、後ろの名前の間は、半角スペースを1つ空けます(cd ai-practice のように)

    pwd:いまいる場所を確かめる

    pwd

    「いまどこにいるか」を表示します。名前は print working directory(作業中のディレクトリを表示)の略です。Mac では次のように表示されます。

    /Users/taro

    Windows の PowerShell では、次のように、少し見た目が違います。

    Path
    ----
    C:\Users\taro

    どちらも「ホームフォルダにいる」という意味です。迷ったら、まず pwd を打ってください。見るだけなので、何度打っても安全です。

    ls:中身を一覧で見る

    ls

    いまいるフォルダの中にあるファイルとフォルダを一覧で表示します。名前は list(一覧)の略です。

    Mac では、名前が並びます。

    Desktop    Documents    Downloads    ai-practice

    Windows の PowerShell では、種類・更新日時・大きさ・名前が表で出ます。右端の Name(名前)の列を見れば、中身が分かります。

    中に何も無いフォルダで ls を打つと、何も表示されません。エラーではなく、「空っぽ」という意味です。

    隠しファイルも見たいときのオプション(- から始まる追加の指定)は、次のとおりです。

    • Mac:ls -a(ドット . で始まる隠しファイルも表示。.codex のような名前のものです)

    • Windows(PowerShell):ls -Force

    最初は使わなくて構いません。AI ツールの設定ファイルが . から始まる名前のことが多いので、「隠れているだけで、あるはず」というときに思い出してください。

    cd:フォルダに移動する

    cd ai-practice

    cd は change directory(ディレクトリを変える)の略で、フォルダに移動する命令です。cd のあとに、移りたいフォルダの名前を打ちます。成功しても、特に何も表示されません。プロンプトの表示が変わるか、pwd で場所が変わったかを確認します。

    ひとつ上のフォルダに戻るときは、次のとおりです。

    cd ..

    ..(ドット2つ)は、「ひとつ上のフォルダ」を意味する特別な記号です。

    ホームフォルダに戻るときは、WindowsでもMacでも動く次の形が便利です。

    cd ~

    ~(チルダ)は、キーボードの右上あたりにあります。日本語キーボードでは Shift を押しながら「へ」のキーで打てます。

    Windows の PowerShell なら、別のドライブへの移動も、cd で行えます。たとえば cd D:\ で D ドライブへ移れます。

    存在しない名前を打つと、エラーになります。Mac の例です。

    cd: no such file or directory: ai-practis

    名前の打ち間違いが多いので、次の章の Tab 補完を使いましょう。

    mkdir:新しいフォルダを作る

    mkdir ai-practice

    mkdir は make directory(ディレクトリを作る)の略で、いまいる場所に、新しいフォルダを作ります。作ったフォルダは、そのままでは移動しません。入るには、続けて cd ai-practice と打ちます。

    名前は、半角の英数字とハイフン(-)で付けるのがおすすめです。日本語の名前でも動きますが、スペースが入ると扱いが面倒になります(後で説明します)。

    Windows の PowerShell では、作ったフォルダの情報が表で表示されます。Mac では何も出ません。どちらも成功です。

    フォルダを普通の画面で開く(Finder・エクスプローラー)

    「いまのターミナルのフォルダを、普通のウィンドウで見たい」ときは、次のコマンドが使えます。

    Mac の場合です。

    open .

    Windows(PowerShell)の場合です。

    explorer .

    最後の .(ドット1つ)は、「いまいるフォルダ」を意味する記号です。スペースを入れて打ってください。いまいるフォルダが Finder かエクスプローラーで開きます。ターミナルで作ったファイルが本当にあるか、目で確かめたいときに便利です。

    パスの書き方

    パスは、ファイルやフォルダの「住所」です。cd の後ろに書くのも、パスです。ここが分かると、AI ツールに「このフォルダを見て」と頼むときにも役立ちます。

    絶対パスと相対パス

    パスの書き方は2種類あります。

    • 絶対パス:一番上から全部書く住所。どこにいても同じ場所を指します

    • 相対パス:いまいる場所からの住所。いる場所が変わると、指すものも変わります

    郵便で例えると、絶対パスは「東京都〇〇区…」と全部書いた住所、相対パスは「隣の家」「ひとつ上の階」のような言い方です。

    Mac の例です。

    cd /Users/taro/ai-practice

    これは絶対パスです。/ から始まります。

    cd ai-practice

    こちらは相対パスです。「いまいる場所の中の ai-practice」を指します。

    Windows と Mac の違い

    • 区切りの記号:Windows は \(バックスラッシュ。日本語キーボードでは円マークの表示のキーです)、Mac は /(スラッシュ)で、フォルダの間を区切ります

    • ドライブ:Windows は C: や D: のようにドライブの文字から始まります。Mac にはドライブの文字がなく、/ から始まります

    • PowerShell は / も使える:PowerShell では \ の代わりに / でも通ることが多いです。ただし、混乱しやすいので、最初は \ に統一する方が安心です

    Windows の例です。

    cd C:\Users\taro\ai-practice

    特別な記号:~・.・..

    • ~:ホームフォルダ(Windows では C:\Users\ユーザー名、Mac では /Users/ユーザー名)

    • .:いまいるフォルダ

    • ..:ひとつ上のフォルダ

    たとえば、ホームフォルダの中の ai-practice に、どこからでも行きたいときは、Mac では cd ~/ai-practice、Windows では cd ~\ai-practice と打ちます。

    フォルダをドラッグして、パスを入れる

    パスを手で打つのは大変です。入門記事にも書いたとおり、フォルダを窓にドラッグ&ドロップすると、そのパスが入ります。まず cd と打ち(最後に半角スペース)、フォルダをターミナルの窓に落とします。パスが入るので、Enter を押すだけです。

    Mac のターミナルでも、Windows Terminal でも使えます。スペースを含むパスは、自動で整形されて入ることが多いので、まずこの方法を試すのがおすすめです。

    画像

    入力を楽にする技

    Tab 補完:名前の続きを自動で入れる

    打ち間違いを一番減らす技です。名前の最初の数文字を打って、Tab キーを押すと、続きを自動で入れてくれます。

    たとえば、ai-practice というフォルダがあるとき、次のように打ちます。

    cd ai-pr

    ここで Tab を押すと、cd ai-practice と補完されます。候補が複数あるときは、動きが少し違います。

    • Windows(PowerShell):Tab を押すたびに、候補が順番に入れ替わります。逆向きは Shift+Tab

    • Mac(zsh):共通の部分まで入ります。もう一度 Tab を押すと、候補の一覧が出ます

    長い名前も、最初の数文字と Tab で済みます。私も、フォルダ名を最後まで打つことはほとんどありません。

    ↑キー:前に打ったコマンドを呼び出す

    キーボードの↑キーを押すと、直前に打ったコマンドが出てきます。もう一度押すと、さらに前のコマンドです。↓キーで新しい方へ戻ります。同じコマンドをもう一度打つときや、打ち間違えたコマンドを少し直して打ち直すときに便利です。

    Ctrl+C:動いているものを止める

    コマンドが終わらない、画面が動き続けている、何も反応がない。そんなときは、Ctrl+C(Ctrl キーを押しながら C)で止められます。

    Mac のターミナルでも、止めるときは Command ではなく Control キーを使います。Mac ではコピーが Command+C、止めるのが Control+C と、別のキーです。

    Windows Terminal では、文字を選んでいる最中の Ctrl+C は「コピー」になります。選んでいない状態なら「止める」です。止まらないと感じたら、文字の選択を解除してから、もう一度押してください。

    画面をきれいにする:clear

    文字が増えて見づらくなったら、次のコマンドで画面を片づけられます。

    clear

    Mac でも、Windows の PowerShell でも使えます。過去の出力が消えるだけで、フォルダやファイルには何も起きません。

    コピー&貼り付け

    AI ツールの入門記事は、「コマンドをコピーして貼り付けて、Enter を押す」手順が多いです。ここで、貼り付け方を覚えておきましょう。

    Windows(Windows Terminal・PowerShell)

    • コピー:文字をマウスで選んで、Ctrl+C(または Ctrl+Shift+C)

    • 貼り付け:Ctrl+V(または Ctrl+Shift+V)。右クリックで貼り付けられる設定のこともあります

    先ほどのとおり、Ctrl+C は、何も選んでいないと「止める」の意味になります。コピーするときは、文字を選んでから押します。

    Mac(ターミナル)

    • コピー:文字を選んで、Command+C

    • 貼り付け:Command+V

    貼り付けたら、Enter の前に必ず読む

    貼り付けたあと、すぐに Enter を押さないでください。画面に出た文字を、一度読みます。確認するのは、次の3つです。

    1. 自分が貼ろうとしたコマンドと同じか(余計な行が増えていないか)

    2. 意味の分からないコマンドが混ざっていないか

    3. 複数行が貼られていないか(複数行だと、1行ずつ順に実行されることがあります)

    複数行を貼ろうとすると、確認の画面が出ることがあります。内容が分かっているときだけ、貼り付けを進めてください。

    引用符が曲がる問題

    文章作成のソフトや一部のサイトからコピーすると、半角のダブルクォート(")が、カーブした引用符(“ ”)に変わっていることがあります。見た目が似ていますが、コマンドとしては別の文字です。エラーの原因になるので、変なエラーが出たときは疑ってみてください。

    不安なときは、いったんメモ帳(Windows)やテキストエディット(Mac)に貼って、見た目を確かめてから、ターミナルに貼り直す方法もあります。

    練習:フォルダを作って移動し、AIツールを起動する直前まで

    ここまでの内容を、実際に手を動かして確かめましょう。入力するのは、ほとんどが見るだけのコマンドです。何も壊れません。

    手順1:ターミナルを開く

    前の章の方法で、ターミナルを開きます。Windows は PowerShell(プロンプトに PS が付いていること)、Mac は「ターミナル」です。

    手順2:いまの場所を確かめる

    pwd

    ホームフォルダが表示されるはずです。

    手順3:ホームフォルダに移動する

    cd ~

    念のため、ホームフォルダに行きます。もう一度 pwd で確認しても構いません。

    手順4:練習用のフォルダを作る

    mkdir ai-practice

    手順5:そのフォルダに入る

    cd ai-practice

    Tab 補完も試してみましょう。cd ai-p まで打って Tab を押すと、cd ai-practice に補完されます。

    手順6:場所を確かめる

    pwd

    Mac では /Users/あなたのユーザー名/ai-practice、Windows では C:\Users\あなたのユーザー名\ai-practice のように、最後が ai-practice になっていれば成功です。

    手順7:中身を見る

    ls

    まだ何も入れていないので、何も表示されないはずです。

    手順8:空のファイルを作る

    ファイルを作るコマンドは、WindowsとMacで違います。

    Windows(PowerShell)の場合です。

    New-Item memo.txt -ItemType File

    Mac の場合です。

    touch memo.txt

    どちらも、memo.txt という名前の、中身が空のファイルを作ります。もう一度 ls を打つと、memo.txt が表示されます。

    手順9:普通の画面で確かめる

    Mac の場合です。

    open .

    Windows(PowerShell)の場合です。

    explorer .

    Finder かエクスプローラーが開いて、memo.txt があるのが見えます。ターミナルで作ったものが、普段の画面にも見える。これが分かると、一気に怖くなくなります。

    手順10:戻って、また入る

    cd ..
    pwd
    cd ai-practice
    pwd

    cd .. で、ひとつ上のホームフォルダに戻り、cd ai-practice で、また入ります。途中で ↑キーを押して、前のコマンドが出てくるのも試してみてください。

    手順11:AIツールが入っているか確かめる

    Claude Code や Codex をすでにインストールしている方は、次のコマンドで、パソコンがそれを見つけられるか確認できます。

    Windows(PowerShell)の場合です。

    Get-Command claude
    Get-Command codex

    Mac の場合です。

    which claude
    which codex

    見つかれば、場所が表示されます。見つからないと、エラーが出ます。まだ入れていない方は、エラーが出て当然です。インストールの手順は、記事末の入門記事にあります。

    Claude Code は、バージョンを確認する次のコマンドも使えます(入門記事で紹介したものです)。

    claude --version

    手順12:起動する直前で止まる

    ここまでで、「練習用のフォルダの中にいて、pwd でそれを確かめた」状態です。あとは、起動したいツールの名前を打って Enter を押すだけです。

    claude

    または、

    codex

    が、起動のコマンドです。初回はログインを求められます。ログインや最初の頼み方は、それぞれの入門記事で詳しく書いています。

    このとき、起動してよいか、最後にチェックすることが2つあります。

    1. pwd で、練習用のフォルダにいるか(ホームフォルダや、大事な仕事のフォルダではないか)

    2. そのフォルダに、失われて困るものが入っていないか

    この2つが問題なければ、起動して大丈夫です。AI ツールが動いている間は、ターミナルの窓を閉じないでください。終わり方は、ツールごとに違います。Claude Code は /exit と打ちます。Codex の終わり方は、Codex の入門記事で確認してください。

    この記事の練習はここまでです。

    よくあるエラーと対処

    初心者がつまずくのは、実はほとんどが次の3つ、または打ち間違いです。

    1. 「command not found」(コマンドが見つからない)

    Mac で、次のように出ます。

    zsh: command not found: claude

    Windows の PowerShell では、次のように出ます。

    claude : 用語 'claude' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。

    英語の環境では、The term 'claude' is not recognized as the name of a cmdlet, function, script file, or operable program. と出ます。どちらも同じ意味で、「そんな名前のプログラムは、見つからない」と言っています。

    原因と、確認する順番です。

    1. 打ち間違い。claud や cluade のようなミスがないか、見直します

    2. インストールしていない。まだ入れていないなら、このエラーが出て当然です。入門記事の手順でインストールします

    3. インストール後にターミナルを開き直していない。入れた直後の窓には、新しい情報が届いていないことが多いです。いったん窓を閉じて、新しく開いて、もう一度試します。入門記事でも、いちばん多い原因として挙げています

    4. PATH に入っていない。PATH は、パソコンが「プログラムを探しに行く場所の一覧」です。インストール先がこの一覧に入っていないと、入れてあっても見つかりません

    PATH の一覧は、次のコマンドで見られます(見るだけです)。

    Mac の場合です。

    echo $PATH | tr ":" "\n"

    Windows(PowerShell)の場合です。

    $env:Path -split ";"

    1行に1つずつ、場所が表示されます。ここにインストール先が見えないときは、PATH の設定が必要です。ただ、その直し方は、ツールや環境で違います。それぞれの公式のトラブルシューティングを見てください。AI ツールの入門記事にも書いたとおり、claude doctor や codex doctor のような診断のコマンドが用意されているので、使える状態なら試してみてください。

    2. スペースを含むパスで失敗する

    フォルダ名にスペースが入っていると、ターミナルは「スペースの前と後で、別の言葉」と受け取ってしまいます。

    たとえば、My Documents というフォルダに、次のように打つとします。

    cd My Documents

    Windows では「位置指定パラメーターが見つかりません」といった長いエラー、Mac では cd: string not in pwd: My のようなエラーになります。

    直し方は、パスを半角のダブルクォート " で囲むことです。

    Windows(PowerShell)の場合です。

    cd "C:\Users\taro\My Documents"

    Mac の場合です。

    cd "/Users/taro/My Documents"

    Mac で ~ を使うときは、注意が必要です。~ はダブルクォートの中に入れると展開されません。~ はクォートの外に出します。

    cd ~/"My Documents"

    もうひとつの方法として、Mac ではスペースの前に \(バックスラッシュ)を付ける方法もあります。cd My\ Documents のように打ちます。

    もっと手軽なのは、前に書いたドラッグ&ドロップです。自動でパスを整えてくれるので、スペースが入っていても、あまり心配が要りません。

    作る側の工夫として、自分で作るフォルダの名前には、スペースを使わず、ハイフン(-)やアンダースコア(_)を使うことをおすすめします。

    3. 全角文字・全角スペースが混ざる

    日本語を入力できる状態(かな入力がオン)で打つと、ls が「ls」のような全角になったり、スペースが全角になったりします。見た目は似ていますが、コマンドとしては別物なので、エラーになります。

    コマンドを打つときは、入力を半角英数に切り替えます。Windows では半角/全角キー、Mac では英数キーで切り替えられます。「エラーになる理由が見えない」ときは、全角が混ざっていないか、疑ってみてください。

    4. 権限のエラー(アクセスが拒否された)

    権限のエラーは、「その場所に書く許可がない」「その操作をする許可がない」という意味です。

    #### Windows で「アクセスが拒否されました」

    よくあるのが、管理者として開いたターミナルや、C:\Windows\System32 のような、システムの大事な場所にいる状態でフォルダを作ろうとしたときです。次のように直します。

    • 管理者ではない、普通のターミナルを開き直す

    • cd ~ で、ホームフォルダに戻ってから作業する

    #### Windows で「スクリプトの実行が無効になっている」

    PowerShell で、プログラムを起動しようとしたときに、「このシステムではスクリプトの実行が無効になっているため…」という文が出ることがあります。これは PowerShell の実行ポリシーという安全装置が、スクリプトを止めている状態です。

    自分のユーザーだけに限った設定として、次のコマンドが一般的な直し方として知られています。

    Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

    これは、パソコンの設定を変えるコマンドです。意味が分からないまま打たないでください。会社や学校のパソコンでは、管理者が決めている設定と食い違うことがあります。公式のインストール手順どおりに進めて、このエラーが出たときにだけ、公式ドキュメントも確認して使ってください。

    #### Mac で「permission denied」や「Operation not permitted」

    permission denied は、その操作の許可がない、という意味です。Operation not permitted は、Mac が守っている場所(デスクトップ・書類・ダウンロードなど)へのアクセスが止められている、という場合に出ることがあります。

    最初にターミナルがデスクトップなどにアクセスしようとすると、「ターミナルがデスクトップフォルダ内のファイルにアクセスしようとしています」のような確認が出ます。「許可」を選べば進みます。後から変えたいときは、「システム設定」の「プライバシーとセキュリティ」から、ターミナルの権限を確認します。

    #### 「sudo」で解決しようとしない

    エラーを検索すると、「sudo を付ければ動く」という解説に出会うことがあります。sudo は、管理者の権限で実行する命令です。権限の問題を力ずくで通すことになり、大事なファイルの権限を壊したり、あとで別のトラブルを生んだりします。入門記事でも、npm のインストールで sudo を使わないよう、公式が警告していることを書きました。意味が分かるまでは、使わないでください。

    5. その他の、よく見るエラー

    • no such file or directory/「パスが存在しないため検出できません」:フォルダ名が違う、または、いまいる場所が違います。pwd と ls で、場所と中身を確認します

    • すでに存在する:mkdir で作ろうとしたフォルダが、もうあります。作り直す必要はなく、cd で入れます

    • 何も反応しない:処理中の可能性があります。しばらく待ってから、止めたいなら Ctrl+C を押します

    • 入力が変になった:Ctrl+C で止め、画面を clear で片づけて、やり直します

    エラーが出たら、エラーの文をそのままコピーして、AI に貼って聞くのも有効です。ただし、貼る前に、個人情報(フルネームのユーザー名、パスワード、API キーなど)が入っていないか、確認してください。

    やってはいけないこと

    ターミナルは、ほとんどの操作が安全ですが、いくつか「やってはいけない」ことがあります。

    意味の分からない削除コマンドを貼らない

    最重要の約束です。

    ネット上の解説、SNS、見知らぬ人のメッセージ、AI の回答の中に、「これを貼れば直ります」というコマンドが出てくることがあります。意味が分からないコマンドは、貼って実行しないでください。

    特に危険なのは、削除に関するコマンドです。Mac の rm に -rf のような指定を付けたもの、Windows の Remove-Item に -Recurse や -Force を付けたもの、del や format のような命令です。ここでは、あえて貼れる形では載せません。

    理由は2つです。

    • ターミナルで削除したものは、ゴミ箱に入らず、元に戻せないことがあります

    • パスの書き方や場所を1文字間違えると、消すつもりのないものまで消えます

    「このフォルダの中だけ消す」つもりが、場所を間違えて、仕事のフォルダ全体を消してしまう。実際に起きる失敗です。

    管理者権限・sudo を安易に使わない

    先ほど書いたとおり、sudo や「管理者として実行」は、パソコンの大事な部分を触れる強い権限です。分からない間は使わないでください。

    「出どころの分からない」インストールコマンドを貼らない

    入門記事には、次のような形のインストールコマンドが出てきます。

    curl -fsSL https://claude.ai/install.sh | bash

    これは「インターネット上のプログラムを取ってきて、そのまま実行する」という意味です。公式のページに書かれているものを使うのは、一般的なやり方です。ですが、出どころの分からないページに載っていた同じ形のコマンドを貼るのは、危険です。悪意のあるプログラムをそのまま動かしてしまいます。

    インストールのコマンドは、必ず公式のページ(または、公式のページへの案内を載せた信頼できる記事)から取ってください。URL の綴りも確認します。似た名前の偽のページがあるからです。

    重要なフォルダで AI を起動しない(最初のうちは)

    練習用ではなく、大事なデータが入ったフォルダで、いきなり AI ツールを起動するのは避けます。ホームフォルダ全体や、仕事のデータが全部入ったフォルダも同じです。AI は、起動した場所の中を読み書きできます。最初は、ai-practice のような練習用の場所で慣れてください。

    AI ツールには、確認画面(権限の仕組み)があります。ファイルを書き換える前や、コマンドを動かす前に聞いてくれる画面です。意味の分からないコマンドが出たときは、承認する前に、AI に「このコマンドは何をするのか説明してください」と聞いて構いません。これは入門記事でも勧めたことです。

    迷ったら、聞いてから実行する

    最後に、私が実際に決めているルールです。

    • 意味の分からないコマンドは、まず AI に「このコマンドは何をしますか?取り消せますか?」と聞く

    • 「削除」「上書き」「全部」「強制」という言葉があれば、特に警戒する

    • 練習用のフォルダで試してから、本番のフォルダで使う

    • 大事なフォルダは、別の場所にコピーを取ってから作業する

    「聞いてから実行する」だけで、ほとんどの事故は避けられます。

    まとめ

    • ターミナルは、文字で命令を出す画面。中身は、フォルダやファイルの普段の操作を文字で行っているだけ。Enter を押すまで実行されない

    • Windows はスタートメニューや右クリックメニューから「ターミナル」または「PowerShell」を、Mac は Command+スペースで「ターミナル」を開く。Windows は、プロンプトに PS が付いていることを確認する

    • 「いまいる場所」がカレントディレクトリ。Claude Code と Codex は、起動した場所の中で作業する。起動前に pwd で確認する

    • 覚えるのは pwd(場所を見る)・ls(中身を見る)・cd(移動)・mkdir(フォルダを作る)の4つと、Tab 補完・Ctrl+C。フォルダを普通の画面で開くのは、Mac が open .、Windows が explorer .

    • パスは、住所。絶対パスと相対パスがあり、~ はホーム、. はいまの場所、.. はひとつ上。Windows は \、Mac は /。迷ったらフォルダをドラッグする

    • コピー&貼り付けは、貼ってから Enter の前に読む。Windows は Ctrl+V、Mac は Command+V

    • command not found は、打ち間違い・未インストール・ターミナルの開き直し忘れ・PATH の順に疑う。スペースを含むパスは " で囲む。全角が混ざらないよう半角で打つ

    • 意味の分からない削除コマンドを貼らない。sudo や管理者権限を安易に使わない。出どころの分からないインストールコマンドを実行しない

    次の一歩は、練習の手順1〜10をやってみることです。そのあとで、Claude Code か Codex の入門記事に進んでください。


    次に読む

    このアカウントをフォローすると、Claude Code や Codex の新しい手順の記事が届きます。ぜひフォローしてください。

    まさのAI実務ラボ|Codex・Claude Code では、有料記事が読み放題になります。道具や教材を作って売る手順を、まとめて読みたい方はご覧ください。

    あなたへのおすすめ