Claude Code CLIの導入と基本操作（Windows）

本記事では、Anthropic社が提供するAIコーディング支援ツール「Claude Code」のCLI版をWindows環境にインストールし、実際にプロジェクトフォルダで使ってみるまでの手順をまとめました。Claude Codeとは何か、Claude Desktopとの違いから、インストール、認証、基本的なコマンド操作までを一通り解説します。インストール方法はWSLとWindowsネイティブの両方を紹介します。

目次

• Claude Codeとは
  • Claude Codeの概要
  • Claude Codeでできること
  • Claude DesktopとClaude Code CLIの違い
  • WSLとWindowsネイティブの使い分け
• 前提条件・動作環境
  • アカウントの準備
  • 各インストール方法で必要なもの
• インストール
  • WSLにインストールする
  • Windowsネイティブにインストールする
• 認証（ログイン）
  • 初回ログインの手順
  • ログアウトと再認証
• 基本操作
  • 対話モードで使ってみる
  • ワンライナーモードで使ってみる
  • 対話モードとワンライナーモードの使い分け
• よく使うコマンド・操作
  • スラッシュコマンド
  • キー操作
• まとめ

Claude Codeとは

Claude Codeの概要

Claude Codeは、Anthropic社が提供するターミナルベースのAIコーディング支援ツールです。

ターミナル上で動作し、プロジェクト内のファイルを読み取り、コードの生成・修正・テスト・Git操作などを自然言語の指示で実行できます。たとえば「この関数にエラーハンドリングを追加して」と入力すると、Claude Codeがコードベースを解析し、該当箇所を特定して修正案を提示します。承認すれば、ファイルへの変更が直接反映されます。

従来のコード補完ツール（GitHub Copilotなど）が「入力中に次の行を予測して提案する」のに対して、Claude Codeはエージェントとして動作します。タスクを受け取ると、必要なファイルを自分で探し、編集し、コマンドを実行し、結果を確認するというループを、完了するまで自律的に繰り返します。

Claude Codeでできること

Claude Codeが行えるものには、以下のようなものがあります。

ファイルの変更やコマンドの実行には、ユーザーの承認が必要です。

Claude DesktopとClaude Code CLIの違い

Anthropicが提供するデスクトップアプリ「Claude Desktop」には、現在Chat・Cowork・Codeの3つのモードが統合されています。

当サイトの「WSL上のMCPサーバーをClaude Desktopから利用する方法」で使用したのは、このうちのChatモードです。

Claude Codeには、上記のClaude DesktopアプリのCodeモードのほかに、ターミナルから直接claudeコマンドで起動するCLI版があります。

DesktopアプリのCodeモードとCLI版は、内部で同じClaude Codeエンジンが動いており、機能的な差はほとんどありません。プロジェクト設定やCLAUDE.md（プロジェクトのルールや知識をClaude Codeに伝えるための設定ファイル）も共有されるため、どちらを使っても同じ作業が行えます。

CLI版は、デスクトップアプリのインストールが不要で、ターミナルから直接起動できるのが特徴です。また、-pオプションによるワンライナー実行に対応しているため、シェルスクリプトやCI/CDパイプラインへの組み込みにも適しています。

Windows環境では、CLI版をWSL上のUbuntuまたはWindowsネイティブ（PowerShell / コマンドプロンプト）のどちらでも使用できます。

WSLとWindowsネイティブの使い分け

Claude Code CLIはWSLとWindowsネイティブのどちらでも動作します。以下の特徴を参考に、自分の環境に合った方法を選んでください。

前提条件・動作環境

アカウントの準備

Claude Codeを利用するには、以下のいずれかの有料Anthropicアカウントが必要です。無料プランでは利用できません。

※ 上記は記事執筆時点（2026年5月）の情報です。最新の料金はAnthropic公式サイトをご確認ください。

長期間継続して使うことが決まっている場合は、年間契約を選ぶと若干安くなります。ただし、年間契約ができないプランもあります。なお、iOSから契約すると値段が上がるので注意です。iOSで一度契約すると契約期間が切れるまで、別のプラットホームから契約を変更することができなくなります。

各インストール方法で必要なもの

インストール方法によって、事前に用意するものが異なります。

WSLの導入がまだの方は、当サイトの「WSLのインストールと基本操作方法」を参考にしてください。

インストール

WSLにインストールする

WSLのUbuntuターミナルを開き、以下のコマンドを実行します。

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

インストールが完了したら、バージョンを確認します。

claude --version

バージョン番号が表示されれば、インストールは成功です。

Windowsネイティブにインストールする

始めに、Windowsネイティブ環境でのClaude Codeの動作について整理します。

Windowsネイティブでインストールした場合、どのターミナルからClaude Codeを起動しても、Git for Windowsがインストールされていれば、Claude Codeは内部的にGit Bashでコマンドを実行します。Git BashにはLinuxコマンドが含まれているため、Claude Codeが生成するスクリプトの実行成功率が上がります。

手順1：Git for Windowsをインストールする（推奨）

Claude Codeをインストールする前に、Git for Windowsをインストールすることを推奨します。Git for Windowsのインストーラーは、基本的にデフォルト設定のまま進めます。特に「Adjusting your PATH environment」の画面では、「Git from the command line and also from 3rd-party software」（デフォルト）とすると、Claude CodeがGit Bashを自動的に検出できるようになります。

Git for Windowsが未インストールの場合でもClaude Codeのインストール自体は可能です。その場合、Claude CodeはPowerShellを内部シェルとして使用します。基本的な操作は行えますが、一部のLinuxコマンドが動作しない場合があります。

手順2：Claude Code CLIをインストールする

インストールコマンドはPowerShellまたはコマンドプロンプトから実行します。コマンドは違いますが、どちらからインストールしても同じです。また、インストールするのに管理者権限は必要はありません。それぞれのコマンドを以下に示します。

PowerShell:
irm https://claude.ai/install.ps1 | iex

CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

インストール完了後、バージョンを確認します。PowerShell、コマンドプロンプト、Git Bashのいずれからでも実行できます。

claude --version

バージョン番号が表示されれば、インストールは成功です。インストール後は、お好みのターミナルからclaudeコマンドで起動できます。

認証（ログイン）

インストールが完了したら、Claude Codeにログインします。認証の手順はWSL・Windowsネイティブどちらも同じです。

初回ログインの手順

ターミナルで以下のコマンドを実行します。

claude

初回起動時には、テーマ（配色）の選択画面が表示されます。好みのテーマを矢印キーで選択し、Enterキーで決定してください。矢印キーで選択を変えると下にあるコードサンプルの表示が変わるので、それを見て選びます。

続いて、認証方法の選択画面が表示されます。

本記事では、最も一般的な「Claude account with subscription（サブスクリプション）」での認証を説明します。認証方法を選択すると、ブラウザが自動的に開き、Anthropicのログイン画面が表示されます。Claude.aiのアカウント（メールアドレスまたはGoogleアカウント）でログインしてください。

WSL環境などでブラウザが自動的に開かないことがあります。その場合は、ターミナルに表示される指示に従い、cキーを押してください。ログインURLがクリップボードにコピーされるので、手動でブラウザに貼り付けてアクセスします。以降の手順（ログイン→許可→ターミナルに戻る）は同じです。

ログインすると、「Claude Codeへのアクセスを許可しますか？」という確認画面が表示されます。「承認する」をクリックします。

承認コードが表示されるので、Claude Codeを実行したターミナルに貼り付けます。しばらくした後に、「Login successful. Press Enter to continue...」という文字が表示されたらログインは成功です。Enterキーを押してください。そうすると、セキュリティノートが表示されます。

 Security notes:

 1. Claude can make mistakes
    You should always review Claude's responses, especially when
    running code.

 2. Due to prompt injection risks, only use it with code you trust
    Learn more: https://code.claude.com/docs/en/security

 Press Enter to continue…

「Claudeは間違えることがあるのでレスポンスを必ず確認すること」と「プロンプトインジェクションのリスクがあるので信頼できるコードでのみ使うこと」という2点の注意が表示されています。Enterキーを押せばそのまま進めます。

 Accessing workspace:

***********

 Quick safety check: Is this a project you created or one you trust? (Like your own code, a well-known open source
 project, or work from your team). If not, take a moment to review what's in this folder first.

 Claude Code'll be able to read, edit, and execute files here.

 Security guide

 ❯ 1. Yes, I trust this folder
   2. No, exit

 Enter to confirm · Esc to cancel

これはワークスペースの安全確認画面です。「このフォルダを信頼しますか？Claude Codeはここにあるファイルの読み取り・編集・実行ができます」という確認です。信頼できるフォルダであれば「1. Yes, I trust this folder」を選んでEnterで進めます。これにより、Claudeの「対話モード」が始まります。

ログアウトと再認証

アカウントを切り替えたい場合や認証に問題がある場合は、Claude Codeの「対話モード」を開いた状態（プロンプト）で以下のコマンドを入力します。

/loginを実行すると認証方式の設定を再度行います。この設定は初回ログイン時と同じ内容です。

基本操作

対話モードで使ってみる

対話モードは、Claude Codeの最も基本的な使い方です。プロンプトに自然言語で指示を入力し、会話しながら作業を進めます。

Claude Codeは、起動したディレクトリ以下のファイルを読み取り・編集できます。そのため、作業したいプロジェクトのフォルダに移動してから起動するのが基本です。

cd ~/my-project
claude

ホームディレクトリなど広い範囲で起動すると、意図しないファイルにアクセスされる可能性があるため避けてください。認証セクションで表示されたワークスペースの安全確認画面は、この点を確認するためのものです。

起動するとプロンプト（>）が表示されます。ここに自然言語で指示を入力し、Enterキーで送信します。

指示の例：

• 「このプロジェクトの構成を説明して」
• 「README.mdを作成して」
• 「この関数にエラーハンドリングを追加して」
• 「テストを書いて実行して」

Claude Codeはプロジェクト内のファイルを自動的に読み取り、指示に基づいて作業を進めます。Claude Codeがファイルを変更する場合、変更内容（diff）が表示され、承認を求められます。承認プロンプトでの操作は以下の通りです。

シェルコマンドの実行時にも同様に承認が求められます。Claude Codeがpip installやテストの実行などを行おうとすると、実行するコマンドが表示され、許可を求められます。

コマンド実行時の2番目は、同じコマンドを繰り返し実行する場面（テストの実行など）で便利です。

承認・拒否の後もプロンプトに戻るので、続けて別の指示を出せます。Claude Codeは会話の文脈を保持しているため、「さっきのファイルに〇〇を追加して」のように、前の指示を踏まえたやり取りが可能です。

Claude Codeには、承認の粒度を変更できるパーミッションモードがあります。Shift + Tabキーでモードを順に切り替えられます。すべてのモードが表示されるわけではなく、アカウントの権限や使用するモデルで表示されるモードが変わります。

初めて使う場合は、デフォルトのdefaultモードのまま操作し、各変更を確認しながら進めることをおすすめします。操作に慣れてきたらacceptEditsモードを試してみてください。また、コードの調査など変更を行わない場合にはplanモードにするのが安全です。

ワンライナーモードで使ってみる

ワンライナーモードは、-p（--print）オプションを使って、対話に入らずに1回の指示で結果を得る方法です。

claude -p "このプロジェクトの構成を説明して"

実行すると、Claude Codeが指示を処理し、結果をターミナルに出力して終了します。対話モードのようにプロンプトに留まることはありません。ワンライナーモードの出力はパイプで他のコマンドに渡すこともできます。

claude -p "このプロジェクトのREADMEを生成して" > README.md

対話モードとワンライナーモードの使い分け

ワンライナーモードでパーミッションモードを変更する場合は--permission-modeオプションで指定します。

claude -p "readme.txtをマークダウン形式に変更して" --permission-mode acceptEdits

よく使うコマンド・操作

Claude Codeの対話モードで使えるスラッシュコマンドと、よく使うキー操作をまとめます。

スラッシュコマンド

対話モードのプロンプトで、スラッシュ（/）に続けて入力するコマンドです。

Claude Codeでは、対話を続けるほど「コンテキスト」（会話の蓄積）が増えていきます。コンテキストが大きくなると、応答の精度が下がったり、トークン消費が増えたりします。/clearと/compactはこのコンテキストを管理するためのコマンドです。

なお、コンテキストが上限の95%に達すると、Claude Codeは自動的に圧縮を行います。ただし、手動で早めに/compactを実行しておいたほうが、要約の精度が高くなる傾向があります。

Claude Codeは、作業中にAIモデルを切り替えることができます。/modelを実行すると、利用可能なモデルの一覧が表示されます。

/model         # モデルの選択画面を表示
/model sonnet  # Sonnetに直接切り替える
/model opus    # Opusに直接切り替える

キー操作

環境変数CLAUDE_AUTOCOMPACT_PCT_OVERRIDEにより、自動的にコンテキスト圧縮を行うパーセントを95%から変更できます。

まとめ

本記事では、Claude Code CLIのWindows環境への導入から基本操作までを解説しました。要点を以下にまとめます。

• Claude CodeはターミナルベースのAIコーディング支援ツールで、プロジェクト全体を理解したうえでコードの生成・修正・テスト・Git操作などを自然言語で実行できる
• Claude DesktopアプリのCodeモードとCLI版は同じエンジンで動いており、機能差はほとんどない
• Windows環境ではWSLとWindowsネイティブの2つの方法でインストールできる。Linux環境での開発にはWSL、Windowsのファイルを扱う場合はネイティブが向いている
• インストールはコマンド1行で完了し、ブラウザ認証を通せばすぐに使い始められる
• 対話モードでじっくり作業を進め、ワンライナーモードでサッと結果を得る、という使い分けが基本

Claude Codeの基本操作を理解できたら、以下のトピックを学ぶとさらに活用の幅が広がります。

• CLAUDE.md：プロジェクトのルールや知識をClaude Codeに伝えるための設定ファイル
• MCPサーバーとの連携：外部ツールやデータベースとClaude Codeを接続する（当サイトの「WSL上のMCPサーバーをClaude Desktopから利用する方法」も参考になります）
• VS Code拡張：VS Code上でClaude Codeを使う方法