Claude Code CLI 入門ガイド:インストールから最初のAIコーディングタスクまで
このチュートリアルで学べること
Claude Code は、Anthropic が開発した AI コーディングエージェントで、ターミナル上で動作します。プロジェクトの読み取り、ファイルの編集、コマンドの実行、開発タスクの自動化まで、すべてコマンドラインで完結します。このチュートリアルを終えると、Claude Code のインストール、ログイン、そして最初の AI 支援コーディングタスクまでを実行できるようになります。
このチュートリアルが対象とするバージョン: ターミナルで実行する Claude Code CLI のみを対象とします。デスクトップアプリやWeb版は対象外です。GUIのデスクトップアプリをお求めの場合は、専用のデスクトップガイドをご覧ください。
所要時間: 15〜20 分
難易度: 初心者向け
始める前に
| 要件 | 説明 |
|---|---|
| オペレーティングシステム | macOS 13 以降、Windows 10 1809 以降、または Linux(Ubuntu 20.04+、Debian 10+、Alpine 3.19+) |
| アカウント | Claude Pro / Max / Team / Enterprise のサブスクリプション、または Claude Console アカウント(従量課金) |
| ターミナル | PowerShell(Windows)、ターミナル(macOS)、または Linux のターミナル |
| ハードウェア | 4 GB 以上の RAM |
| 費用 | Claude サブスクリプション(Pro は月額 $20 から)、または API 従量課金 |
ターミナルとは? ターミナル(コマンドラインとも呼ばれます)は、ボタンをクリックする代わりにコマンドを入力して操作するウィンドウです。Windows では PowerShell、macOS ではターミナルと呼ばれます。このチュートリアルでは claude コマンドを使います。このウィンドウに入力して Enter キーを押してください。
Claude Code とは? Claude Code は Anthropic 製のコーディングエージェントです。ファイルを読み取り、プロジェクト内の各部分がどうつながっているかを理解し、複数ファイルの編集、テストの実行、エラーの修正を、許可を求めたうえで自動的に行います。
API キーとは? API キーは、従量課金で利用する際にアカウントを識別するための秘密のコードです。Claude Console(console.anthropic.com)で一度生成します。パスワードと同じように扱い、絶対に共有しないでください。
ターミナルを開く方法(ステップバイステップ)
ターミナルの開き方が分からない場合は、以下のお使いの OS の手順に従ってください。このチュートリアルのすべてのコマンドはこのターミナルで実行します。
Windows — PowerShell を開く
- 1画面左下のスタートボタン(Windows ロゴ)をクリックします。
- 2
PowerShellと入力します。先に何かをクリックする必要はありません。そのまま入力を始めてください。 - 3一覧に表示された Windows PowerShell または ターミナル アプリをクリックします。
- Windows 11 ではターミナル、Windows 10 では Windows PowerShell と表示されます。どちらでも構いません。
- 1青いユーザーアカウント制御ウィンドウが表示されたら、はいをクリックします。
コマンドの貼り付け方: PowerShell ウィンドウ内で右クリックすると貼り付けられます(または Ctrl + V)。
ダウンロードとインストール
バージョンを選ぶ
| バージョン | こんな人におすすめ | 備考 |
|---|---|---|
| ネイティブインストーラー(推奨) | ほとんどのユーザー | 十分にテスト済みで推奨。バックグラウンドで自動更新 |
| Homebrew | すでに Homebrew を使っている macOS ユーザー | 他のアプリと一緒に管理。手動更新 |
| WinGet | すでに WinGet を使っている Windows ユーザー | Windows のパッケージマネージャー。手動更新 |
Homebrew とは? Homebrew は macOS 用の無料パッケージマネージャーです。brew install と入力してプログラムをインストールします。コマンドライン版のアプリストアのようなものです。すでに Homebrew を使っている場合のみ選択してください。
WinGet とは? WinGet は Windows 10 と 11 に標準搭載されている公式パッケージマネージャーです。すでに使っている場合のみ選択してください。
お使いのシステムにインストール
お使いのシステムを選択してください。各タブにお使いの OS の完全な手順が記載されています。
Windows のインストール
- 1PowerShell を開きます。スタートボタン(Windows ロゴ)をクリックし、
PowerShellと入力して、Windows PowerShell またはターミナルをクリックします。 - 2下のコマンドをコピーして PowerShell ウィンドウに貼り付け、Enter キーを押します:
irm https://claude.ai/install.ps1 | iex- 1インストールが完了するまで待ちます。再び入力できるようになったら、以下のコマンドをコピーして実行し、インストールを確認します:
claude --versionバージョン番号の後に (Claude Code) が続いていれば(例:2.1.211 (Claude Code))、インストール成功です。
PowerShell ではなく CMD を使う場合: ターミナルの行頭が C:\ で PS が付いていない場合は CMD です。代わりに次のコマンドを実行してください:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdThe token '&&' is not a valid statement separator と表示されたら PowerShell です。上の irm コマンドを使ってください。'irm' is not recognized as an internal or external command と表示されたら CMD です。上の curl コマンドを使ってください。
Claude Code の更新: ネイティブインストールは自動更新されます。すぐに更新を確認するには:
claude updateオプション — WinGet: WinGet パッケージマネージャーをお使いの場合:
winget install Anthropic.ClaudeCode更新はこちら:
winget upgrade Anthropic.ClaudeCodeログイン
- 1ターミナルを開き、プロジェクトフォルダーに移動します(
path/to/your/projectは自分のフォルダーパスに置き換えてください):
cd path/to/your/project- 1Claude Code を起動します:
claude- 1初回はログインを求められます。ブラウザウィンドウが自動的に開きます:
- Claude アカウントでログイン — Pro / Max / Team / Enterprise のサブスクリプションを使用します。ログインすると、ブラウザが自動的に資格情報を Claude Code に返します。
- Claude Console(API)を使用 — 従量課金をご希望の場合は、Console アカウントでログインしてください。
- 1ログインが完了すると、Claude Code のプロンプトが表示され、最初のタスクを受け付ける準備が整います。ログイン状態は保存されるため、次回以降はログイン不要です。
注意: 無料の Claude.ai プランには Claude Code は含まれません。有料サブスクリプションまたは Console アカウントが必要です。
インストールのトラブルシューティング
| エラー | 原因 | 解決方法 | |
|---|---|---|---|
claude: command not found | インストールフォルダーが PATH にない | 下記の各 OS の手順に従って修正 | |
'irm' is not recognized as an internal or external command | CMD で PowerShell のコマンドを実行した | CMD 用のインストールコマンドを使う(curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd) | |
The token '&&' is not a valid statement separator | PowerShell で CMD のコマンドを実行した | PowerShell 用のインストールコマンドを使う(`irm https://claude.ai/install.ps1 \ | iex`) |
インストール中に syntax error near unexpected token '<' または HTTP 403 | ネットワーク制限、または間違ったシェルにコマンドを貼り付けた | インターネット接続を確認し、claude.ai にアクセスできることを確認して、正しいターミナルで再試行 | |
| ブラウザのログインページが開かない | ネットワーク制限またはプロキシ | インターネット接続を確認して再試行。VPN やプロキシを使っている場合はオフにするかサーバーを切り替える | |
Login expired · Please run /login | 保存されたログインが期限切れ | claude を実行し、セッション内で /login と入力して再ログイン |
「claude: command not found」の修正 — Windows:
- 1Windows キーを押し、
環境変数(environment variables)と入力して、システム環境変数の編集をクリックします。 - 2環境変数... ボタンをクリックします。
- 3下のリスト(システム変数)で Path を見つけて選択し、編集... をクリックします。
- 4新規をクリックし、Claude Code のインストールフォルダー(既定:
C:\Users\<ユーザー名>\.local\bin)を追加し、すべてのウィンドウで OK をクリックします。 - 5PowerShell を完全に閉じて開き直し、
claude --versionを実行します。
「claude: command not found」の修正 — macOS/Linux:
- 1ターミナルを開き、次のコマンドをコピーして実行します:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc- 1設定を再読み込みします:
source ~/.zshrc- 1Bash を使用している場合は、上記の両方のコマンドで
~/.zshrcの代わりに~/.bashrcを使います。 - 2
claude --versionを実行して確認します。
最初のタスク
ステップ 1:プロジェクトを開く
Claude Code で作業したいプロジェクトフォルダーに移動します(パスは自分のものに置き換えてください):
cd path/to/your/projectターミナルのプロンプトにフォルダーのパスが表示されるはずです。
ステップ 2:Claude Code を起動する
claudeClaude Code が起動し、バージョン、現在のモデル、作業中のフォルダーが表示されたプロンプトが現れます。
ステップ 3:最初の質問をする
次のリクエストを入力して Enter キーを押します:
このプロジェクトは何をするものですか?Claude Code がプロジェクトのファイルを読み取り、見つかった内容を説明します。さらに試してみましょう:
このプロジェクトはどの技術を使っていますか?— 使用されている技術を特定しますメインのエントリーポイントはどこですか?— メインファイルを見つけますフォルダー構造を説明してください— フォルダーの構成を説明します
ステップ 4:最初のコード変更を行う
次のリクエストを入力して Enter キーを押します:
メインファイルに hello world 関数を追加してくださいClaude Code が適切なファイルを見つけ、変更内容を提示し、承認を求めます。これは正常で安全な流れです。何が実行されるかは自分で決められます。
ステップ 5:変更を承認または拒否する
Claude Code がファイルを編集したりコマンドを実行したりするときは、まず許可を求めます。y と入力して Enter で承認、n で拒否します。各変更を確認してください。最終的な管理権はあなたにあります。
Shift + Tab を押すと、権限モードを切り替えられます:
- 既定モード — Claude は変更のたびに確認します
- acceptEdits モード — ファイル編集は自動承認(コマンド実行は確認あり)
- plan モード — Claude は計画のみ提示し、変更は行いません
ステップ 6:Claude Code を終了する
終了するときは、/exit と入力して Enter を押すか、Ctrl + D を 2 回押します。
便利なコマンド
| コマンド | 機能 |
|---|---|
claude | インタラクティブセッションを開始 |
claude "タスクの説明" | 一度きりのタスク付きでセッションを開始 |
claude -p "質問" | 一度きりのクエリを実行して終了(スクリプト向け) |
claude -c | このフォルダーの最近の会話を続行 |
claude -r | 以前の会話を再開 |
claude update | 最新バージョンに更新 |
claude doctor | インストールの状態を確認 |
/help | 利用可能なコマンドをすべて表示(セッション内) |
/clear | 会話履歴をクリア(セッション内) |
/login | アカウントを切り替えたり再ログイン(セッション内) |
/usage | セッションの使用量と費用を表示(セッション内) |
/exit または Ctrl + D を 2 回 | Claude Code を終了 |
よくある質問
有料プランは必要ですか?
必要です。Claude Code を使用するには、有料の Claude サブスクリプション(Pro:月額 $20 から・月払い、Max:月額 $100 から、Team、Enterprise)または従量課金の Claude Console アカウントが必要です。無料の Claude.ai プランには Claude Code は含まれません。最新のオプションは公式の料金ページで確認してください。
Claude Code は git リポジトリの外でも動作しますか?
Claude Code は Git プロジェクト内で最もよく動作します。ゼロから始める場合は、最初にリポジトリを作成してください:
git initClaude Code は自分のコードを実行できますか?
はい、許可があれば可能です。Claude Code はシェルコマンドやテストを実行できますが、実行前に必ず内容を表示して確認を求めます。権限モード(Shift + Tab)で、確認なしで実行できる操作を制御できます。
コードは Anthropic に送信されますか?
Claude Code を使用すると、プロンプトとファイルの内容は、アカウントタイプに応じたデータ管理ポリシーに従って処理されます。詳細は Anthropic のデータ利用に関するドキュメントを確認してください。
MCP とは何ですか?
MCP(Model Context Protocol)は、Claude Code をデータベースや社内サービスなどの外部ツールやデータソースに接続するための標準的な方式です。後でセッション内で /mcp を使って MCP サーバーを追加できます。これは上級者向けの機能で、始める段階では不要です。
次のステップ
- プロジェクトのガイドラインを追加: リポジトリに
CLAUDE.mdファイルを作成し、プロジェクトに関する長期的な指示を Claude Code に与えましょう。 - 質問を具体的に: 「バグを修正して」ではなく、目標と制約を具体的に説明しましょう。
- 権限モードをマスター: 慣れてきたら
Shift + Tabで確認モードと自律モードを切り替えましょう。 - 他の場所でも使う: Claude Code はデスクトップアプリ、VS Code / JetBrains IDE、ウェブ版でも利用できます。
- MCP でツールを接続:
/mcpを使って Claude Code に外部データやサービスへのアクセスを許可しましょう。