Claude Codeの使い方2026｜導入・設定・Cursor比較の実践ガイド

Claude Codeの使い方を検索している人の多くは、「Cursorと何が違うのか」「本当に業務で使えるのか」が知りたいはずだ。結論から言うと、Claude Codeはチャット型AIの延長ではなく、ターミナルに住む自律型エージェントだ。ファイルを読み、コマンドを実行し、gitまで操作する。タスクを丸ごと引き受けて完了まで走り続けるのが設計思想で、ここがCursorやCopilotとの決定的な違いになる。

筆者もClaude Codeを業務に導入して約4ヶ月になるが、正直なところ最初の1週間は「ただのターミナル版チャットでは？」と思っていた。評価が変わったのは、CLAUDE.mdとHooksを設定してからだ。本記事ではClaude Codeの使い方を、導入から実践的なカスタマイズまで一本の流れで書いていく。

Claude Codeの正体 -- チャットUIとは別物

Claude CodeはAnthropicが提供するエージェント型のCLIツール。ブラウザのclaude.aiとは根本的に動作が異なる。

チャットUIが「質問→回答」の1ターンで完結するのに対し、Claude Codeはタスクを受け取ると自律的にループを回す。コードベースを読み、ファイルを編集し、テストを実行し、結果を確認してまた修正する。人間が介入するのは最初の指示と最後の承認だけという場面も多い。

利用環境は4つある。

個人的にはターミナル版を推す。理由は単純で、シェルの履歴やパイプラインと直接組み合わせられるからだ。IDE拡張はCursorと機能が被るため、後述する使い分けを考えると住み分けたほうが効率的になる。

料金プランと導入手順

料金体系

Claude Code自体に追加料金はない。Anthropicのサブスクリプションに含まれる。

実際に使ってみた感覚だと、Proプランで1日2-3時間の開発であれば月の後半に制限がかかることがある。仕事で本格的に使うならMax 5xが安心だ。

インストール（3分）

macOSの場合、Homebrewで一発。

# macOS
brew install --cask claude-code

# Windows
winget install Anthropic.ClaudeCode

# npm経由（全OS対応）
npm install -g @anthropic-ai/claude-code

インストール後、プロジェクトディレクトリでclaudeと打てば起動する。初回はブラウザが開いてAnthropicアカウントの認証を求められる。

cd ~/projects/my-app
claude

これだけで使い始められる。設定ファイルは後から追加すればいい。

最初に覚える操作5つ

Claude Codeの使い方は単純で、起動したら自然言語で指示を出すだけ。ただし、知っておくと効率が上がる操作がいくつかある。

見落としがちだが、指示の粒度がそのまま品質に直結する。「このプロジェクトをリファクタして」のような曖昧な指示は避け、「src/api/auth.tsのrefreshToken関数で401が返る問題を修正して。auth.test.tsにテストも追加」のように範囲と期待を明示するのが鉄則だ。

CLAUDE.mdでプロジェクトの文脈を渡す

Claude Codeが競合ツールと最も差別化されるポイントがここだ。プロジェクトルートにCLAUDE.mdを置くだけで、毎回のセッション開始時に自動で読み込まれる。

つまりClaude Codeは、毎回のセッションでプロジェクトのルールをすでに知った状態で作業を始める。

実際に効果が大きかった記述例

# プロジェクト規約

## 技術スタック
- フレームワーク: Next.js 15 (App Router)
- 言語: TypeScript (strict mode)
- スタイル: Tailwind CSS v4
- ORM: Prisma
- テスト: Vitest + Testing Library

## コーディング規約
- TypeScriptのclassは使わない。関数とインターフェースで構成
- any/unknownは禁止。型が不明な場合はzodでバリデーション
- コンポーネントは関数コンポーネントのみ（export function、defaultは使わない）
- エラーハンドリングはResult型パターン（throw禁止）

## よく使うコマンド
- テスト: pnpm test
- lint: pnpm lint
- 型チェック: pnpm typecheck
- dev: pnpm dev

## ディレクトリ構成
- src/app/ -- ルーティング
- src/components/ -- UIコンポーネント
- src/lib/ -- ビジネスロジック
- src/server/ -- サーバーサイド処理

これを置く前と後で、生成コードの一発合格率が体感で3割は上がった。特にTypeScriptのclass禁止ルールは効果が大きい。指定しないとClaude Codeは平気でclassを生成してくる。

CLAUDE.mdの書き方を深掘りしたい場合は、CursorとClaude Codeの設定ファイル完全ガイドで詳しく扱っている。

Hooksで開発ワークフローを自動化する

Hooksは、Claude Codeが特定のアクションを実行した前後にシェルコマンドを走らせる仕組みだ。競合記事でほぼ触れられていない機能だが、筆者はこれを設定してから手動でフォーマッターをかけた回数がゼロになった。

設定は.claude/settings.jsonに記述する。

実用パターン1: ファイル保存時にフォーマッター自動実行

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

Claude Codeがファイルを編集するたびにPrettierが走る。人間がフォーマッターをかけ忘れる問題がゼロになる。

実用パターン2: 作業完了時にデスクトップ通知

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code: タスク完了\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

長時間のリファクタリングを任せて別の作業をしているとき、完了通知が飛んでくる。確認のためにターミナルに戻る回数が半分になった。

実用パターン3: 危険なコマンドをブロック

{
  "permissions": {
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force*)",
      "Bash(DROP TABLE*)"
    ]
  }
}

Claude Codeはシェルコマンドを実行できるため、安全策は必要だ。permissions.denyでパターンマッチによるブロックが可能。本番DBに接続する環境では必須の設定と考えていい。

MCPサーバーで外部ツールと接続する

MCP（Model Context Protocol）はAnthropicが策定したオープンプロトコルで、AIツールと外部サービスを標準化された方法で接続する。Claude Codeは.mcp.jsonファイルでMCPサーバーを設定できる。

プロジェクトルートに.mcp.jsonを作成する。

{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
    }
  },
  "postgres": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-postgres"],
    "env": {
      "DATABASE_URL": "postgresql://localhost:5432/mydb"
    }
  }
}

これでClaude CodeからGitHubのIssueを読んだり、PostgreSQLのテーブル構造を直接確認したりできるようになる。

MCPサーバーは公式リポジトリに多数公開されており、npmでインストールするだけで使える。自作もTypeScriptのSDKが整備されているため半日で動くものが作れる水準だが、既存サーバーの組み合わせだけで実務の大半はカバーできる。

Cursor vs Claude Code -- 両方使うのが正解

CursorとClaude Codeは動作レイヤーが違う。どちらを使うかではなく、どの場面でどちらを呼ぶかを決める問題だ。

筆者の使い分けパターン

• Cursor優先 -- 既存コードの修正、1ファイル内のリファクタ、Tab補完でのコーディング。エディタの中で完結する作業はこちら
• Claude Code優先 -- 新機能の追加（複数ファイルにまたがる変更）、バグ調査から修正・テストまでの一連作業、PR作成、ドキュメント生成
• 両方同時に立ち上げる -- Claude Codeで大枠を実装し、Cursorで細部を調整。この順番がもっとも再作業が少ない

意外だったのは、Claude CodeのVS Code拡張はCursorと共存できる点だ。Cursorのフォークベースであるため設定方法にクセはあるが、パネルからClaude Codeを呼び出しつつCursorのTab補完も使うという運用は可能。ただし個人的にはターミナル版とCursorを別ウィンドウで使うほうがすっきりする。

設定ファイルの詳細な書き方についてはCursorとClaude Codeの設定ファイル完全ガイドが参考になる。また、AIツールを活用した開発手法の全体像はAIネイティブ開発完全ガイドでまとめている。

トークン消費を半分にする実践テクニック

Claude Codeの使い方を覚えた次に直面するのがコスト問題だ。コンテキストウィンドウは約200Kトークン。大きいように見えるが、ファイルを数十個読むとすぐに埋まる。トークン消費の管理は月額コストに直結するため、以下の対策は早めに身につけたい。

1. 指示にファイルパスを含める

「認証のバグを直して」ではなく「src/api/auth.tsのrefreshToken関数のバグを直して」と書く。Claude Codeが読むファイル数が減り、トークン消費が大幅に下がる。筆者の計測では、ファイルパスを明示するだけで1タスクあたりのトークン消費が30-50%減少した。

2. /compactをこまめに使う

Claude Codeには自動コンパクション機能があり、コンテキストが上限に近づくと自動で会話を要約する。だが意図的に/compactを打ったほうが要約の品質が高い。タスクの区切りごとに実行する習慣をつけるといい。

3. サブエージェントを活用する

Claude Codeはサブエージェント（子プロセス）を起動して並列作業ができる。サブエージェントは独自のコンテキストを持つため、リサーチ作業を委譲するとメインのコンテキストを汚さない。CLAUDE.mdで定義すればカスタムサブエージェントも作れる。

4. .claude/rules/で遅延ロードを使う

すべてのルールをCLAUDE.mdに書くとセッション開始時にトークンを大量消費する。.claude/rules/ディレクトリにファイルを分けてpaths:フロントマターを付けると、対象ファイルにアクセスしたときだけ読み込まれる。

---
paths:
  - src/api/**
---

# API規約
- レスポンスは必ずResult型で返す
- エラーコードはsrc/lib/errors.tsの定義を使う
- ミドルウェアチェーンの順序を変更しない

大規模プロジェクトではこの遅延ロードだけでセッション開始時のトークン消費を数千トークン削減できる。

よくある質問