Claude Codeをターミナルで始める方法｜インストールから初回起動・トラブル対処まで

ターミナルでClaudeを使うには、Claude Codeをインストールして、claudeと入力するだけです。macOS、Linux、Windowsのそれぞれにコマンドが用意されており、数分で初回起動まで進められます。本記事では、必要な準備、OS別のインストール、ログイン、よくあるトラブルの対処、企業で使うときの注意点を解説します。

ターミナルでClaudeを使うとは

ターミナルでClaudeを使うとは、Claude Codeというツールを自分のPCに入れ、文字だけの画面で依頼を出すことです。公式ガイドでも、Claude Codeは文字だけで動作すると説明されています。

Claude Codeでできること

Claude Codeは、プログラミング支援を主な目的としたツールです。コードの理解、修正、テストの実行など、PC上のファイルを扱う作業を、依頼しながら進められます。ターミナルの操作に慣れていなくても使えるよう、公式からも初心者向けのガイドが提供されています。

ターミナルを使わない選択肢もある

文字の画面が不安な場合は、Claudeのデスクトップアプリの「Code」タブから、Claude Codeを使う方法があります。公式ガイドでは、ターミナルを完全に省略できると案内されており、macOSとWindowsに対応しています（Linuxはベータ版）。ターミナルでの利用は、普段のコマンド操作と組み合わせて使いたい人に向いています。

始める前の準備

始める前に確認するのは、対応環境、アカウント、作業フォルダの3点です。事前に整えておくと、途中で止まりにくくなります。

対応環境

公式の要件は、macOS 13.0以降、Windows 10 1809以降（またはWindows Server 2019以降）、Ubuntu 20.04以降、Debian 10以降、Alpine Linux 3.19以降です。メモリは4GB以上、インターネット接続が必要です。

利用できるアカウント

Claude Codeの利用には、Pro、Max、Team、Enterpriseのいずれかのプラン、またはClaude Consoleのアカウントが必要です。公式ヘルプでは、無料のClaudeプランにはClaude Codeが含まれないと明記されています。Amazon BedrockなどのクラウドAPI経由で使う方法もあります。Team・Enterpriseでは、組織の管理者が利用を許可しているかも確認します。

WindowsのGit for Windowsは、推奨（必須ではありません）

Windowsでは、Git for Windowsを入れておくと、Claude CodeがBashツールを使えます。入れていない場合は、PowerShellがシェルツールとして使われます。公式ガイドでは、初心者向けの手順でGit for Windowsのインストールを任意の手順として案内しています。WSLで使う場合は、Git for Windowsは不要です。

作業用のフォルダを決める

Claude Codeは、ターミナルで開いているフォルダを、作業の対象とします。最初は、ほかの資料と分けた、練習用のフォルダを作るのがおすすめです。

インストール手順

インストールは、OSごとに1行のコマンドを実行する方式が基本です。公式ガイドでは、次のコマンドが案内されています。

macOSでは、Homebrewを使い、brew install --cask claude-code でも入れられます。Homebrewには、安定版の claude-code と、最新版の claude-code@latest の2種類があります。Windowsでは、winget install Anthropic.ClaudeCode でも入れられます。Homebrew版とWinGet版は自動更新されないため、手動で更新します。標準のインストーラー版は、バックグラウンドで自動更新されます。手順は更新される場合があるため、実行前に公式ガイドで最新のコマンドを確認してください。

STEP1：ターミナルを開く

macOSでは、アプリケーションのユーティリティからターミナルを開きます。Windowsでは、スタートメニューでPowerShellを検索して開きます。

STEP2：インストールコマンドを実行する

上の表のコマンドを、OSに合わせてコピーして貼り付け、実行します。インストーラーが、Claude Codeを自動でダウンロードして、設定します。

STEP3：インストールを確認する

新しいターミナルを開き、claude --version を実行します。バージョンが表示されれば、準備は完了です。

初回起動とログイン

初回起動は、作業フォルダへ移動してclaudeと入力し、画面の案内に従ってログインする流れです。ブラウザでの認証が必要になります。

STEP1：作業フォルダへ移動する

ターミナルで、練習用のフォルダへ移動します。

STEP2：claudeと入力して起動する

claude と入力して実行すると、Claude Codeが起動します。

STEP3：ブラウザでログインする

ブラウザが開き、Claudeアカウントでのログインを求められます。画面の案内に従って認証し、ターミナルへ戻ります。

STEP4：許可の確認が出たら、内容を読んで選ぶ

環境によっては、作業フォルダや操作への許可を求められる場合があります。公式ガイドでは、ファイルの作成や変更の前に確認が出るとされています。内容をよく読んで、許可するかどうかを選びます。

STEP5：最初の依頼を出してみる

たとえば、このフォルダにあるファイルの構成を説明して、と入力してみましょう。終了するときは、exit と入力するか、入力欄が空の状態で Ctrl+D を2回押します。

起動できないときの対処

うまく動かない場合の多くは、パスの設定か、環境の問題です。公式ガイドと解説記事で紹介されている、基本の対処は次のとおりです。

claudeが見つからない（command not found）

一度、ターミナルのウィンドウを閉じて、新しく開き直し、もう一度試します。それでも直らない場合は、インストール先のフォルダがPATHに入っていません。公式ガイドによると、macOS・Linuxでは ~/.local/bin をPATHに追加します。Windowsでは、PowerShellで、ユーザー環境変数のPATHに %USERPROFILE%\.local\bin を追加します。

インストールや環境を診断する

claude doctor を実行すると、セッションを開始せずに、インストールと設定の診断結果を表示できます（読み取り専用です）。原因が分からないときの、最初の確認手段として便利です。

Windowsで動作が不安定なとき

PowerShellで開いているか確認します（x86と表示されるPowerShellは使いません）。Git for Windowsを入れている場合は、Claude Codeがgit bashを見つけられているかも確認します。また、WSL（Windows Subsystem for Linux）上で、Linux向けのコマンドを使う方法もあります。WSL 2では、サンドボックス機能も使えます。

企業で使うときの注意点

企業での利用では、インストール方法、権限、データの扱いを事前に決めておきます。個人のPCで試す場合より、確認事項が増えます。

ターミナルの基本操作を最低限おさえる

ターミナルに不慣れでも、移動、確認、起動の3つの操作を覚えれば、Claude Codeを使い始められます。操作はOSで多少異なるため、迷ったときは、公式ガイドの初心者向けの説明も参照してください。

フォルダを移動する

cd に続けてフォルダ名を入力すると、そのフォルダへ移動できます。たとえば、デスクトップにある練習用フォルダなら、デスクトップへ移動してから、そのフォルダ名を指定します。

今いる場所を確認する

macOSやLinuxでは pwd、フォルダの中身は ls で確認できます。WindowsのPowerShellでも、ls や pwd が使えます。Claude Codeは、今開いているフォルダを作業対象とするため、起動前に場所を確認する習慣をつけると、意図しないフォルダを渡す事故を防げます。

打ち間違いを減らす

長いコマンドは、手入力せずに、コピーして貼り付けます。貼り付けた後は、実行する前に、内容が公式ガイドと一致しているかを目で確認しましょう。

使い始めに試したい依頼例

最初の依頼は、ファイルを変更しない、読み取り中心の内容から始めるのが安全です。慣れてから、修正や作成を依頼すると、動きを理解しやすくなります。

変更を依頼するときは確認しながら進める

Claude Codeは、ファイルの変更やコマンドの実行を伴うため、実行前に許可を求められる場面があります。内容をよく読んで許可するか、断るかを選びます。最初のうちは、練習用のフォルダで、変更内容を確認しながら進めてください。

社内に展開するときの進め方

社内展開は、小さな試用から始めて、ルールを整えながら広げるのが現実的です。一斉に配布するより、問い合わせの数も抑えられます。

STEP1：試用メンバーを決める

ターミナル操作に慣れた担当者を数名選び、練習用のフォルダで試してもらいます。つまずいた点を、記録してもらいましょう。

STEP2：手順書を作る

試用で出た疑問をもとに、OS別のインストール手順、ログイン方法、よくあるトラブルの対処を、1つの文書にまとめます。コマンドは、公式ガイドの最新版と照らして更新します。

STEP3：許可範囲と利用ルールを決める

作業対象にしてよいフォルダ、実行を許可する操作、機密情報の扱いを決めて、周知します。

STEP4：見直しの機会を設ける

ツールの手順や機能は更新されます。定期的に、手順書とルールを見直す担当を決めておくと、運用が安定します。

ターミナル版とデスクトップアプリ版の選び方

どちらを選ぶかは、普段の作業環境と、操作への慣れで決まります。両方を試して、自分に合うほうを使うのも一つの方法です。

ターミナル版が向いている人

普段からコマンド操作を使う開発者や情シスの担当者は、ターミナル版が使いやすいでしょう。ほかのコマンドと組み合わせて、作業の流れの中で呼び出せる点が利点です。

デスクトップアプリ版が向いている人

ターミナルに不慣れな人や、まず画面で動きを確認したい人には、デスクトップアプリ版が向いています。公式ガイドによると、macOSとWindowsに対応しています（Linuxはベータ版）。利用にはPro、Max、Team、Enterpriseのいずれかのプランが必要です。

迷ったときの考え方

よくある質問（FAQ）

Claude Codeのインストールにはどのくらい時間がかかりますか？

コマンドの実行自体は、通信環境にもよりますが、数分で終わるのが一般的です。Gitなど事前の準備を含めても、短時間で完了します。

Claude Codeは無料で使えますか？

Claudeの無料プランには、Claude Codeは含まれません。Pro、Max、Team、Enterpriseのいずれか、またはClaude Consoleのアカウントが必要です。利用できるプランは変わる場合があるため、公式ページで最新の条件を確認してください。

ターミナルの操作に慣れていなくても使えますか？

使えます。公式ガイドが、ターミナルの開き方から説明しています。不安な場合は、ターミナルを使わないデスクトップアプリ版を選ぶ方法もあります。

Claude Codeを終了するにはどうすればよいですか？

exit と入力するか、入力欄が空の状態で Ctrl+D を2回押します。Claudeが作業している途中で止めたいときは、Escキーで中断できます。

起動時にエラーが出たときは最初に何を確認すべきですか？

ターミナルを開き直したうえで、claude doctor を実行します。また、Claudeのステータスページで、障害が出ていないかも確認すると、切り分けが早くなります。

Claude Codeのターミナル導入を成功させるためのまとめと次の一歩

Claude Codeは、OSごとの1行のコマンドで導入でき、claudeと入力するだけで起動できます。Windowsでは、Git for Windowsを入れておくと、Bashツールも使えます（任意）。トラブル時は、ターミナルの開き直しと、claude doctor が基本の対処です。

まずは、練習用のフォルダを1つ作り、インストールから最初の依頼までを試してみましょう。1度動かせれば、日々の作業でどう使えるかが具体的に見えてきます。うまく動かないときも、基本の対処を知っていれば慌てずに済みます。社内で展開する場合は、手順書にまとめて共有しておくと、問い合わせも減らせます。