> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 新規ユーザー向けターミナルガイド

> macOS と Windows で初めてターミナルを使用するユーザー向けの Claude Code インストール手順ガイド。

ターミナルを使用したことがなくても Claude Code を使用できます。このガイドでは、ターミナルを開く、Claude Code をインストールする、および最初のやり取りについて説明します。

* [macOS と Linux](#macos-and-linux)
* [Windows](#windows)

<Note>
  ターミナルを使用したくない場合は、Claude Code デスクトップアプリを使用すればターミナルをスキップできます。[macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)、[Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs)、または [Linux](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) 用にダウンロードしてから、[デスクトップクイックスタート](/ja/desktop-quickstart) を参照して開始してください。
</Note>

<h2 id="macos-and-linux">
  macOS と Linux
</h2>

macOS または Linux ターミナルから Claude Code をインストールして開始するには、以下の手順に従ってください。Claude Code には macOS 13.0 以降が必要です。サポートされている Linux ディストリビューションについては、[システム要件](/ja/setup#system-requirements) を参照してください。

<Steps>
  <Step title="ターミナルを開く">
    **macOS**: `Cmd + Space` を押して Spotlight Search を開き、`Terminal` と入力して `Enter` を押します。

    **Linux**: ターミナルアプリを開きます。ほとんどのディストリビューションでは、`Ctrl + Alt + T` を押すか、アプリケーションメニューで'Terminal'を検索します。

    点滅するカーソルが表示されたウィンドウが表示されます。これがターミナルで、ここでコマンドを入力します。
  </Step>

  <Step title="Claude Code をインストールする">
    この行をコピーしてターミナルに貼り付け（macOS では `Cmd + V`、Linux では `Ctrl + Shift + V`）、`Enter` を押します。

    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    ```

    これにより、claude.ai から Claude Code インストーラーがダウンロードされて実行されます。テキストがスクロールして動作しているのが見えます。完了すると、「Claude Code successfully installed!」と表示されます。代わりにエラーが表示される場合は、以下の[トラブルシューティングセクション](#macos-and-linux-troubleshooting)を確認してください。
  </Step>

  <Step title="Claude Code を開始する">
    `claude` と入力して `Enter` を押します。

    ```bash theme={null}
    claude
    ```

    Claude アカウントで[ログイン](/ja/authentication)するよう求められます。画面上の指示に従ってください。ブラウザウィンドウが開いてサインインできます。
  </Step>

  <Step title="Claude Code の使用を開始する">
    ログイン後、コードについての質問やその他のことについて Claude に質問を始めることができます。Claude Code はテキストで完全に実行されます。メッセージを入力して `Enter` を押して送信します。いくつか知っておくべきことがあります。

    * ターミナルのものをクリックすることはできません。矢印キーを使用して移動します。
    * `Esc` を押して、Claude が実行中の場合は中断します。
    * `exit` と入力するか、`Ctrl + D` を押して Claude Code を終了します。
    * `/help` と入力して、利用可能なコマンドを確認します。
  </Step>
</Steps>

***

<h2 id="windows">
  Windows
</h2>

Windows に Git をインストールし、PowerShell をセットアップして、Claude Code を開始するには、以下の手順に従ってください。Claude Code には Windows 10 バージョン 1809 以降が必要です。詳細については、[システム要件](/ja/setup#system-requirements) を参照してください。

<Steps>
  <Step title="Windows 用 Git をインストールする（オプション）">
    Git for Windows は Git Bash を提供し、Bash ツールを有効にします。これがない場合、Claude Code は代わりに PowerShell を使用します。Git 自体を学ぶ必要はありません。

    まだインストールしていない場合は、以下の手順に従ってください。

    1. [git-scm.com/downloads/win](https://git-scm.com/downloads/win) にアクセスしてインストーラーをダウンロードします。
    2. インストーラーを実行します。各画面で'Next'をクリックしてデフォルトを受け入れます。インストーラーには多くの画面がありますが、何も変更する必要はありません。
    3. エディターを選択するよう求められた場合は、デフォルトを保持して'Next'をクリックします。
    4. 'Adjusting your PATH environment'が表示されたら、推奨オプションを選択したままにします。

    <Note>
      既に Git がありますか？このステップをスキップできます。確実でない場合は、とにかくインストールしてください。再インストールしても問題は発生しません。
    </Note>
  </Step>

  <Step title="PowerShell を開く">
    PowerShell は Windows のコマンド入力用の組み込みターミナルです。すべての Windows コンピューターにプリインストールされています。

    `Win + X` を押してメニューから **Windows PowerShell**（または **Terminal**）を選択します。点滅するカーソルが表示されたウィンドウが表示されます。ここでコマンドを入力します。

    <Note>
      Windows には 2 つのコマンドラインプログラムがあります。PowerShell と CMD です。見た目は似ていますが、異なるコマンドを使用します。次のステップでは PowerShell にいることを確認してください。

      どちらにいるかを判断する方法：

      * **PowerShell**: 各行の開始時に `PS C:\Users\YourName>` が表示されます。
      * **CMD**: `PS` なしで `C:\Users\YourName>` が表示されます。
    </Note>
  </Step>

  <Step title="Claude Code をインストールする">
    この行をコピーして PowerShell に `Ctrl + V` で貼り付けるか、右クリックして `Enter` を押します。

    ```powershell theme={null}
    irm https://claude.ai/install.ps1 | iex
    ```

    これにより、Claude Code インストーラーがダウンロードされて実行されます。`irm` はファイルをフェッチし、`iex` はそれを実行します。テキストがスクロールして動作しているのが見えます。完了すると、'Claude Code successfully installed!'と表示されます。代わりにエラーが表示される場合は、以下の[トラブルシューティングセクション](#windows-troubleshooting)を確認してください。

    <Note>
      PowerShell ではなく CMD にいる場合は、このコマンドを使用します。

      ```batch theme={null}
      curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
      ```
    </Note>
  </Step>

  <Step title="Claude Code を開始する">
    `claude` を実行します。PowerShell が `'claude' is not recognized` と表示する場合は、インストールディレクトリがまだ PATH に含まれていません。以下の ['claude is not recognized'](#windows-troubleshooting) の修正に従い、新しい PowerShell ウィンドウを開いてもう一度試してください。

    ```powershell theme={null}
    claude
    ```

    Claude アカウントで[ログイン](/ja/authentication)するよう求められます。画面上の指示に従ってください。ブラウザウィンドウが開いてサインインできます。
  </Step>

  <Step title="Claude Code の使用を開始する">
    ログイン後、コードについての質問やその他のことについて Claude に質問を始めることができます。Claude Code はテキストで完全に実行されます。メッセージを入力して `Enter` を押して送信します。いくつか知っておくべきことがあります。

    * ターミナルのものをクリックすることはできません。矢印キーを使用して移動します。
    * `Esc` を押して、Claude が実行中の場合は中断します。
    * `exit` と入力するか、`Ctrl + D` を押して Claude Code を終了します。
    * `/help` と入力して、利用可能なコマンドを確認します。
  </Step>
</Steps>

***

<h2 id="what’s-next">
  次のステップ
</h2>

Claude Code ウェルカムスクリーンが表示されたら、準備完了です。コードの書き方を知る必要はありません。プレーンな英語で必要なことを説明すれば、Claude がコードを書きます。

<h3 id="build-something">
  何かを構築する
</h3>

Claude は説明からプロジェクトを作成できます。

```text theme={null}
make me a simple webpage that says hello world
```

Claude がファイルを作成します。HTML ファイルをダブルクリックしてブラウザで開きます。

<h3 id="work-with-files-on-your-computer">
  コンピューター上のファイルを操作する
</h3>

Claude は既に持っているファイルを読み取り、整理できます。

```text theme={null}
look at the screenshots on my Desktop and rename them based on what's in each image
```

<h3 id="ask-questions">
  質問をする
</h3>

Claude は物事を説明したり、学習を支援したり、プロジェクトを計画したりできます。

```text theme={null}
I want to build a personal budget tracker. What would I need?
```

まだプロジェクトがない場合は、問題ありません。Claude は新しいプロジェクトを開始するのに役立ちます。

<h3 id="other-ways-to-use-claude-code">
  Claude Code を使用する他の方法
</h3>

ターミナルを使用する必要はありません。Claude Code は以下でも利用できます。

* [VS Code](/ja/vs-code) および [JetBrains IDE](/ja/jetbrains) のエディター拡張機能
* [デスクトップアプリ](/ja/desktop-quickstart)（ターミナルは不要）
* [Web](/ja/claude-code-on-the-web) の claude.ai/code（クラウドセッション用）
* [GitHub Actions](/ja/github-actions) および [GitLab CI/CD](/ja/gitlab-ci-cd)（自動化用）

<h3 id="learn-more">
  詳細を学ぶ
</h3>

* [クイックスタート](/ja/quickstart): Claude Code を使用した最初のプロジェクトのガイド付きウォークスルー
* [Claude Code の仕組み](/ja/how-claude-code-works): Claude がファイルを読み取り、コマンドを実行し、編集を行う方法を理解します。
* [ベストプラクティス](/ja/best-practices): 効果的なプロンプトとプロジェクトセットアップでより良い結果を得ます。
* [一般的なワークフロー](/ja/common-workflows): デバッグ、テスト、リファクタリングなどのステップバイステップガイド
* [ターミナル設定](/ja/terminal-config): Claude Code の最適な体験のためにターミナルをカスタマイズします。

***

<h2 id="troubleshooting">
  トラブルシューティング
</h2>

<h3 id="macos-and-linux-troubleshooting">
  macOS と Linux のトラブルシューティング
</h3>

macOS または Linux でインストール時に問題が発生した場合は、これらの一般的な問題を確認してください。

<Accordion title="「command not found: claude」">
  インストール後に `command not found: claude` が表示される場合は、インストーラーが `claude` を配置したフォルダが PATH に含まれていません。インストーラーはインストールの最後の `Setup notes` の下に正確な修正方法を出力するため、そのコマンドを実行するか、以下のシェル用のコマンドを使用してください。

  Zsh（macOS デフォルトシェル）の場合：

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  ```

  Bash（Linux デフォルトシェル）の場合：

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  source ~/.bashrc
  ```

  その後、新しいターミナルを開いて、もう一度 `claude` を試してください。それでも見つからない場合は、ファイル `~/.local/bin/claude` が存在することを確認してください。存在しない場合は、インストールが完了していません。詳細については、[PATH を修正](/ja/troubleshoot-install#verify-your-path)を参照してください。
</Accordion>

<Accordion title="HTML コードのエラーまたは'syntax error near unexpected token'">
  `bash: line 1: syntax error near unexpected token '<'` または `<!DOCTYPE html>` などの HTML コードがターミナルに表示される場合は、インストール URL がインストーラースクリプトではなく Web ページを返しました。

  ページに'App unavailable in region'と表示されている場合は、Claude Code がお客様の国では利用できません。[サポートされている国](https://www.anthropic.com/supported-countries)を参照してください。

  それ以外の場合は、コマンドをもう一度実行してみてください。引き続き発生する場合は、代わりに [Homebrew](https://brew.sh) でインストールしてください：

  ```bash theme={null}
  brew install --cask claude-code
  ```
</Accordion>

<Accordion title="「dyld」エラーまたは「built for Mac OS X 13.0」">
  `dyld: cannot load`、`dyld: Symbol not found`、または `built for Mac OS X 13.0` が表示される場合は、macOS バージョンが Claude Code がサポートしているバージョンより古い可能性があります。

  Apple メニューを開いて「このマックについて」を選択してバージョンを確認します。13.0 より古い場合は、ソフトウェアアップデートを通じて macOS をアップデートしてください。詳細については、[macOS トラブルシューティングガイド](/ja/troubleshoot-install#dyld-cannot-load-on-macos)を参照してください。
</Accordion>

その他のエラーについては、完全な[インストールトラブルシューティングガイド](/ja/troubleshoot-install)を参照してください。

<h3 id="windows-troubleshooting">
  Windows のトラブルシューティング
</h3>

Windows でインストール時に問題が発生した場合は、これらの一般的な問題を確認してください。

<Accordion title="'irm is not recognized'">
  PowerShell ではなく CMD にいます。このウィンドウを閉じて、代わりに PowerShell を開きます（`Win + X` を押してから Windows PowerShell を選択します）。

  または、CMD インストールコマンドを使用します：

  ```batch theme={null}
  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  ```
</Accordion>

<Accordion title="SSL/TLS エラーまたは「Could not create SSL/TLS secure channel」">
  これは通常、古い Windows 10 システムで発生します。この行を最初に実行してから、インストールを再試行します：

  ```powershell theme={null}
  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  irm https://claude.ai/install.ps1 | iex
  ```
</Accordion>

<Accordion title="'Claude Code on Windows requires either Git for Windows (for bash) or PowerShell'">
  PowerShell も Git Bash も見つかりませんでした。Claude Code はシェルが少なくとも 1 つ必要です。

  1. `powershell.exe` が `PATH` にあることを確認してください。デフォルトの場所は `C:\Windows\System32\WindowsPowerShell\v1.0\` です。または、`pwsh` を提供する [PowerShell 7](https://aka.ms/powershell) をインストールします。
  2. Git Bash を使用する場合は、[Windows セクションの最初のステップ](#windows)に従って [Git for Windows](https://git-scm.com/downloads/win) をインストールします。
  3. Git がインストールされているが Claude Code がそれを見つけることができない場合は、どこを見るかを指定します：
     ```powershell theme={null}
     $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
     ```
     その後、もう一度 `claude` を実行します。Git が別の場所にインストールされている場合は、以下を実行してパスを見つけます：
     ```powershell theme={null}
     Get-Command git | Select-Object Source
     ```
     そのパスで `Git\bin` フォルダを探して、代わりにそれを使用します。

  毎回設定する必要がないようにこれを永続的にするには、[Git Bash パスを設定](/ja/troubleshoot-install#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell)を参照してください。
</Accordion>

<Accordion title="'claude is not recognized'">
  このエラーは、インストールディレクトリが PATH に含まれていないことを意味します。PowerShell でこれらのコマンドを実行して、それを追加してください：

  ```powershell theme={null}
  $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
  [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
  ```

  PowerShell を閉じて新しいウィンドウを開き、もう一度 `claude` を試してください。詳細については、[PATH を確認](/ja/troubleshoot-install#verify-your-path)を参照してください。
</Accordion>

その他のエラーについては、完全な[インストールトラブルシューティングガイド](/ja/troubleshoot-install)を参照してください。