Claude Codeの使い方完全ガイド|インストール・VS Code連携・コマンドを初心者向けに解説

AIノウハウ

「Claude Codeってどうやって使うの?」「インストール方法がわからない」と悩んでいませんか?Claude CodeはAnthropicが提供するAIコーディングエージェントで、ターミナルから自然言語で指示を出すだけでコード生成・編集・デバッグ・テスト作成までを自動化してくれます。

この記事では、Claude Codeのインストール方法からVS Code連携、基本コマンド、効果的な使い方のコツまで、初心者でもすぐに使い始められるよう実践的に解説します。

なお、AIツール全般の選び方を知りたい方は「AIツールおすすめ20選|無料・一覧・比較・ランキングを目的別に徹底解説」もあわせてご覧ください。

Claude Codeとは?特徴を30秒で理解

Claude Codeの概要

Claude Codeは、Anthropic社が開発したターミナルベースのAIコーディングエージェントです。プロジェクトのディレクトリでClaude Codeを起動し、「この機能を追加して」「このバグを修正して」と日本語で指示を出すだけで、AIがコードを読み解き、必要なファイルを編集してくれます。

従来のコード補完ツール(GitHub Copilotなど)との最大の違いは、プロジェクト全体を理解した上で複数ファイルにまたがる変更を一括で行える点です。単なるコードの穴埋めではなく、設計から実装、テスト作成まで任せられるAIアシスタントだと考えてください。

Claude Codeでできること

Claude Codeで実行できる主な作業は以下のとおりです。

  • コード生成・編集:新しい機能の実装、既存コードのリファクタリング
  • バグ修正:エラーの原因特定と修正の自動実行
  • テスト作成:ユニットテスト・統合テストの自動生成
  • コード解説:複雑なコードの動作を日本語で説明
  • Git操作:コミットメッセージの作成、ブランチ操作、PRの作成
  • ファイル操作:ファイルの作成・移動・削除・検索

😅 ドレ

要はターミナルで「これ作って」って言ったらAIが実際にファイルを編集してくれるってこと?すごくない?

🤖 アイ

その理解で完璧です。プロジェクトの全ファイルを把握した上で変更を提案・実行してくれるので、まさに「隣に座っている優秀なエンジニア」のような存在ですね。

Claude Codeのインストール方法【3分で完了】

必要な環境とシステム要件

Claude Codeのインストールに必要な環境は以下のとおりです。

  • 対応OS:macOS、Linux、Windows(WSL経由)
  • Claudeの有料プラン:Pro($20/月)以上のサブスクリプション、またはAPI従量課金
  • ターミナル:macOSのTerminal.app、iTerm2、Windows Terminal(WSL)など

2026年現在、ネイティブインストーラーが提供されており、Node.jsのインストールは不要になりました。以前はnpmを使ったインストールが必要でしたが、現在はワンコマンドでインストールできます。

macOS / Linuxでのインストール手順

ターミナルを開いて、以下のコマンドを実行するだけです。

# ネイティブインストーラー(推奨)
curl -fsSL https://claude.ai/install.sh | sh

# Homebrew(macOS)
brew install claude-code

インストールが完了したら、以下のコマンドでバージョンを確認します。

claude --version

Windows(WSL)でのインストール手順

WindowsでClaude Codeを使うには、WSL(Windows Subsystem for Linux)が必要です。

  1. WSLをインストール:PowerShellを管理者権限で開き、wsl --install を実行
  2. WSLターミナルを起動:スタートメニューからUbuntuを起動
  3. Claude Codeをインストール:WSLターミナル内で curl -fsSL https://claude.ai/install.sh | sh を実行

Windows用のネイティブサポートも今後予定されていますが、2026年3月時点ではWSL経由での利用が推奨されています。

初回起動と認証

インストール後、任意のプロジェクトディレクトリで以下のコマンドを実行します。

cd ~/my-project
claude

初回起動時には認証が必要です。

  1. ブラウザが自動で開き、Claudeのログイン画面が表示される
  2. Claudeアカウント(Pro以上)でログイン
  3. 認証コードを確認し、ターミナルに戻る
  4. 権限設定を選択(推奨は「Suggest」モード:変更前に確認を求める)

認証は一度行えば、以降は自動的にログイン状態が維持されます。

😅 ドレ

Node.js不要でワンコマンドって、マジでインストールのハードル下がったな。昔はnpmのバージョン問題で詰まったりしてたのに。

🤖 アイ

ネイティブインストーラーの導入で、開発環境の準備に時間をかけずにすぐ始められるようになりました。初回認証も1分もかかりませんよ。

VS Code・エディタとの連携方法

VS Code拡張機能のインストール

Claude CodeはVS Code上でも利用できます。拡張機能をインストールすれば、エディタから直接Claude Codeの機能を呼び出せるようになります。

  1. VS Codeの拡張機能マーケットプレイスで「Claude Code」を検索
  2. Anthropic公式の拡張機能をインストール
  3. VS Code内でターミナルを開き、claude コマンドを実行

VS Code上では、エディタで開いているファイルをClaude Codeに直接参照させたり、差分(diff)をビジュアルに確認しながら変更を承認したりできます。

JetBrains IDEとの連携

IntelliJ IDEA、PyCharm、WebStormなどのJetBrains IDEでもClaude Codeを利用できます。JetBrains Marketplace から「Claude Code」プラグインをインストールし、IDE内のターミナルで claude を起動するだけです。

ターミナルのみでの利用

もちろん、エディタ連携なしでターミナル単体でもClaude Codeは使えます。エディタに依存しないのがClaude Codeの強みで、SSH接続先のリモートサーバーやDockerコンテナ内でもそのまま動作します。

😅 ドレ

VS Codeで使えるのありがたい。ターミナルだけだとコード見ながら作業しにくいし。

🤖 アイ

VS Code拡張だと差分のビジュアル確認ができるので、変更内容のレビューが格段に楽になります。エディタ派にはこちらがおすすめですね。

覚えておきたい基本コマンド10選

セッション中のコマンド

Claude Codeのセッション中に使える主要なコマンドは以下のとおりです。すべて / から始まるスラッシュコマンドです。

コマンド 機能
/help 使えるコマンドの一覧と説明を表示
/clear 会話履歴をリセットして新しいセッションを開始
/model 使用するAIモデルを切り替える(Sonnet/Opus/Haiku)
/usage 現在の利用量と残り枠を確認
/compact 会話のコンテキストを要約して圧縮(トークン節約)
/config 設定画面を開く
/review 最新のGit差分をレビューさせる
/init プロジェクトにCLAUDE.mdファイルを生成

ターミナルから直接使えるCLIコマンド

Claude Codeの外から直接使えるコマンドもあります。

コマンド 機能
claude 対話モードでClaude Codeを起動
claude "指示内容" ワンショットで指示を実行(対話なし)
claude --resume 前回のセッションを再開

ワンショットモードは、シェルスクリプトやCI/CDパイプラインに組み込む場合に便利です。たとえば claude "このプロジェクトのREADMEを更新して" のように使えます。

😅 ドレ

/clearと/compactは毎日使ってる。長い会話が続くと上限にすぐ引っかかるから、こまめにリセットするのが大事。

🤖 アイ

コンテキスト管理はClaude Codeを効率的に使う鍵ですね。料金と利用制限の詳細は「Claude Codeの料金プラン完全ガイド」で解説しています。

CLAUDE.mdファイルの活用法

CLAUDE.mdとは

CLAUDE.mdは、プロジェクトルートに配置するClaude Code専用の設定ファイルです。プロジェクトの構造、コーディング規約、使用技術などを記述しておくと、Claude Codeがセッション開始時に自動で読み込み、プロジェクトに最適な対応をしてくれます。

/init コマンドを実行すると、Claude Codeがプロジェクトを分析して自動的にCLAUDE.mdを生成してくれます。

CLAUDE.mdに書くべき内容

効果的なCLAUDE.mdには、以下の情報を記述します。

# プロジェクト概要
このプロジェクトはReact + TypeScriptで構築されたECサイトです。

# 技術スタック
- フロントエンド: React 18, TypeScript, TailwindCSS
- バックエンド: Node.js, Express
- データベース: PostgreSQL
- テスト: Jest, React Testing Library

# コーディング規約
- 変数名はキャメルケースで記述する
- コンポーネントは関数コンポーネントで書く
- 日本語でコメントを書く

# ディレクトリ構造
src/
  components/  - UIコンポーネント
  pages/       - ページコンポーネント
  hooks/       - カスタムフック
  utils/       - ユーティリティ関数
  api/         - API通信

# よく使うコマンド
- テスト実行: npm test
- ビルド: npm run build
- 開発サーバー: npm run dev

CLAUDE.mdが充実していると、毎回のセッションで同じ説明を繰り返す必要がなくなり、トークン消費の節約と回答精度の向上が同時に実現します。

😅 ドレ

CLAUDE.md作ったらClaude Codeの回答の質が目に見えて変わった。プロジェクト固有のルールをちゃんと理解してくれるようになる。

🤖 アイ

CLAUDE.mdはClaude Codeを使いこなす上で最も重要な設定ファイルです。まずは /init で自動生成して、そこから必要な情報を追記していくのがおすすめです。

効果的な使い方のコツ5選

具体的かつ段階的に指示を出す

Claude Codeに指示を出す際は、曖昧な指示よりも具体的な指示の方が精度が高くなります。

  • 悪い例:「ユーザー機能を作って」
  • 良い例:「src/components/にUserProfile.tsxを作成して。ユーザー名、メールアドレス、プロフィール画像を表示するコンポーネントで、TailwindCSSでスタイリングしてください」

また、大きな機能を一度に依頼するのではなく、小さなタスクに分けて段階的に進めるとミスが減ります。

.claudeignoreで不要なファイルを除外する

プロジェクトルートに .claudeignore ファイルを作成し、Claude Codeに読み込ませたくないファイルやディレクトリを指定しましょう。

# .claudeignore の例
node_modules/
dist/
build/
.git/
*.log
*.lock

不要なファイルを除外することで、コンテキストが小さくなり、トークン消費の削減と回答速度の向上が期待できます。

権限設定を適切に使い分ける

Claude Codeには3つの権限モードがあります。

  • Suggest(推奨):変更を提案し、ユーザーの承認後に実行
  • Auto Edit:ファイル編集は自動実行、コマンド実行は確認を求める
  • Full Auto:すべての操作を自動実行

最初はSuggestモードで使い、Claude Codeの動作に慣れてきたら徐々にAuto Editに移行するのがおすすめです。

Gitの差分レビューを活用する

/review コマンドを使うと、最新のGit差分をClaude Codeにレビューさせられます。プルリクエストの作成前に品質チェックとして活用すると、コードレビューの効率が大幅に向上します。

Claude DesktopのCowork機能と連携する

Claude DesktopにはClaude Codeとの連携機能(Cowork)があります。デスクトップアプリのチャットで戦略を相談しながら、Claude Codeで実際のコーディングを進めるというワークフローが可能です。Claude Desktopの詳しい使い方は「Claude Desktopとは?使い方・MCP連携・料金を初心者向けに完全解説」をご覧ください。

😅 ドレ

最初はSuggestモードにして全部確認してた。慣れてきたらAuto Editにしたら作業スピードが倍以上になった。

🤖 アイ

段階的に権限を上げていくのが正しいアプローチです。ただし重要なプロダクション環境では、常にSuggestモードを維持することをおすすめします。

初心者がつまずきやすいポイントと解決法

「認証エラー」が出る場合

認証に失敗する場合は、以下を確認してください。

  • Claudeの有料プラン(Pro以上)に加入しているか
  • ブラウザでclaude.aiにログインできるか
  • claude logoutclaude で再認証を試す

「conversation too long」と表示される場合

会話が長くなりすぎてコンテキストの上限に達した場合に表示されます。/compact で会話を圧縮するか、/clear で新しいセッションを開始してください。

意図しないファイル変更が行われた場合

Claude Codeが意図しない変更を行った場合は、Gitを使って簡単に復元できます。

# 最新の変更を元に戻す
git checkout -- .

# 特定のファイルだけ戻す
git checkout -- path/to/file

このため、Claude Codeを使う前にGitリポジトリを初期化してコミットしておくことを強く推奨します。変更の取り消しが簡単になり、安心してAIに作業を任せられます。

応答が遅い・タイムアウトする場合

コンテキストが大きすぎる、またはネットワーク環境が不安定な場合に起こります。.claudeignoreで不要なファイルを除外し、コンテキストを小さく保つことで改善できます。

😅 ドレ

最初Gitを初期化せずに使ってて、意図しない変更を戻すのに苦労した。Gitは絶対に先にセットアップしておくべき。

🤖 アイ

AIコーディングツールを使う大前提として、Gitでのバージョン管理は必須です。変更の追跡と復元ができない状態でAIにファイル編集を任せるのは危険ですからね。

まとめ|Claude Codeを今日から始めよう

Claude Codeの使い方を改めて整理します。

  • Claude CodeはターミナルベースのAIコーディングエージェント。日本語で指示するだけでコード生成・編集・テスト作成が可能
  • インストールはワンコマンドで完了。Pro以上の有料プランが必要
  • VS Code・JetBrains IDEとの連携でさらに使いやすくなる
  • CLAUDE.mdと.claudeignoreの設定で回答精度とコスト効率が大幅に向上
  • Gitリポジトリの初期化は必須。変更の復元を簡単にするための安全策

まずはインストールして、既存のプロジェクトで claude と打ってみてください。「このコードを説明して」と聞くだけでも、Claude Codeの実力が体感できるはずです。

Claude Codeの料金プランについて詳しく知りたい方は「Claude Codeの料金プラン完全ガイド」、Claude APIの使い方を知りたい方は「Claude APIの使い方・料金・導入方法を初心者向けに完全解説」もあわせてご覧ください。AIを活用した副業に興味がある方は「AI副業おすすめ10選」もチェックしてみてください。

タイトルとURLをコピーしました