Claude Code完全入門ガイド 2026年版 ── インストールから実践テクニックまで

ターミナルに向かって「このバグを直して」と話しかけるだけで、AIがコードベース全体を理解し、ファイルを横断して修正を完了する。そんな開発体験を実現するのが、Anthropicが開発したエージェント型コーディングツール「Claude Code」だ。2025年5月のローンチ以来、爆発的に普及し、npmの統計によれば2026年3月時点で1日あたり約29.7万回インストールされている。本記事では、Claude Codeのインストールから実践テクニックまでを網羅的に解説する。

Claude Codeとは？ —— ターミナルに住むAIエンジニア

Claude Codeとは何か。一言で言えば「ターミナル上で動作する、コードベース全体を理解するAIエージェント」だ。

Anthropicが2025年5月に研究プレビューとして公開し、同年6月に正式リリースされた。従来のコード補完ツール（GitHub Copilotなど）が「カーソル位置の次の行を予測する」のに対し、Claude Codeはプロジェクト全体のファイル構造、依存関係、コーディング規約を把握したうえで、複数ファイルにまたがる変更を自律的に実行する。

Anthropicの公式ブログによると、Claude Codeの主な特徴は以下のとおりだ。

特徴	説明
ターミナルネイティブ	IDE不要。既存のターミナルワークフローに統合できる
コードベース全体を理解	プロジェクトの構造、規約、依存関係を自動で把握
エージェント型	ファイル編集、コマンド実行、Git操作を自律的に行う
100万トークンのコンテキスト窓	大規模プロジェクトでも文脈を失わない
MCP対応	200以上の外部ツール・サービスと連携可能

開発者コミュニティでの評価も高い。2026年2月のRetool Developer Surveyによると、AIコーディングツールを利用する開発者のうち63%がClaude Codeを「メインツール」として使用しており、開発者満足度は46%でトップだった（2位のCursorは38%）。

なぜここまで支持されているのか。最大の理由は「コンテキスト理解の深さ」にある。Claude Codeは起動時にプロジェクトのディレクトリ構造をスキャンし、CLAUDE.mdという設定ファイルからプロジェクト固有のルールを読み込む。これにより、プロジェクトのコーディング規約に沿ったコードを最初から生成できるのだ。

料金プラン —— 無料では使えない、だがコスパは高い

Claude Codeを使うにはどれくらいのコストがかかるのか。結論から言えば、無料プラン（Free）では利用できない。最低でもProプラン（月額$20）が必要だ。

サブスクリプション料金

プラン	月額（USD）	月額目安（日本円）	Claude Code利用	利用量
Free	$0	無料	不可	—
Pro	$20	約3,000円	可	基準値（制限あり）
Max 5x	$100	約15,000円	可	Proの5倍
Max 20x	$200	約30,000円	可	Proの20倍

Anthropicの公式ヘルプセンターによると、Claude CodeとブラウザのClaudeは利用枠を共有している。つまり、Claude Codeでトークンを大量消費すると、ブラウザ版の残り回数も減る。日常的にClaude Codeを使う開発者にはMax 5x以上が推奨される。

API従量課金

サブスクリプションではなくAPIキーで利用することも可能だ。この場合、使った分だけの従量課金となる。

モデル	入力（100万トークンあたり）	出力（100万トークンあたり）	コンテキスト窓
Claude Opus 4.6	$5	$25	100万トークン
Claude Sonnet 4.6	$3	$15	100万トークン
Claude Haiku 4.5	$1	$5	20万トークン

Batch APIを利用すれば50%オフ、プロンプトキャッシュのヒット時は入力コストが最大90%オフになる。Anthropicの公式ドキュメントによると、開発者1人あたりのAPI利用コストは1日平均約$6（約900円）とされている。

インストールと初期設定 —— 5分で始められる

Claude Codeのセットアップは驚くほどシンプルだ。必要なのはNode.js 18以上とターミナルだけである。

インストール方法

最も推奨されるのはnpmによるグローバルインストールだ。

# npmでグローバルインストール（推奨）
npm install -g @anthropic-ai/claude-code

# インストール確認
claude --version

# 初回起動
claude

macOSまたはLinuxユーザーは、ネイティブインストーラーも利用できる。

# ネイティブインストーラー（macOS / Linux）
curl -fsSL https://claude.ai/install.sh | sh

Windowsユーザーは、WSL2（Windows Subsystem for Linux）環境で上記のコマンドを実行する必要がある。ネイティブWindows対応は2026年3月時点でまだ実現していない。

初回認証

初めてclaudeコマンドを実行すると、ブラウザが自動的に開いてOAuth認証画面が表示される。Anthropicアカウント（Pro以上）でログインすればセットアップ完了だ。APIキーで認証する場合は、環境変数ANTHROPIC_API_KEYを設定する。

# APIキーで認証する場合
export ANTHROPIC_API_KEY=sk-ant-xxxxx
claude

基本的な使い方 —— 対話モードとヘッドレスモード

Claude Codeの使い方は大きく2つに分かれる。対話的に会話しながら開発する「インタラクティブモード」と、スクリプトやCI/CDに組み込む「ヘッドレスモード」だ。

インタラクティブモード

ターミナルでclaudeと入力するだけで起動する。自然言語で指示を出すと、Claude Codeがファイルを読み、編集し、コマンドを実行する。

# プロジェクトディレクトリで起動
cd my-project
claude

# 例：バグ修正の依頼
> ログインフォームでメールアドレスのバリデーションが効いていない。修正して。

ヘッドレスモード（-p フラグ）

-pフラグを使うと、対話なしで単発の指示を実行できる。CI/CDパイプラインやシェルスクリプトからの呼び出しに最適だ。

# ヘッドレスモードで実行
claude -p "このプロジェクトのREADME.mdを更新して"

# JSON出力（パイプ処理向け）
claude -p "テストカバレッジを報告して" --output-format json

主要スラッシュコマンド

Claude Codeには便利なスラッシュコマンドが用意されている。

コマンド	説明
/init	CLAUDE.mdを自動生成する
/compact	会話履歴を要約してコンテキストを圧縮する
/clear	会話履歴を完全にリセットする
/review	現在のGit差分をレビューする
/teleport	別のディレクトリに作業コンテキストを移動する
/copy	最後の応答をクリップボードにコピーする
/cost	現在のセッションのトークン消費量を表示する

特に重要なのは/compactと/clearだ。Claude Codeは長い会話を続けるとコンテキスト窓を消費し、古い情報が押し出されて応答品質が低下する。タスクの切れ目で/clear、コンテキストが膨らんできたら/compactを使うのが鉄則だ。

CLAUDE.md —— プロジェクトの「憲法」

CLAUDE.mdは、Claude Codeの振る舞いを制御する設定ファイルだ。プロジェクトのルートに配置すると、Claude Codeは起動時にこのファイルを読み込み、記載されたルールに従ってコードを生成する。いわばプロジェクトの「憲法」のような存在だ。

CLAUDE.mdに書くべきこと

Anthropicの公式ドキュメントでは、以下の情報をCLAUDE.mdに記載することが推奨されている。

セクション	内容例
プロジェクト概要	技術スタック、フレームワーク、主要ライブラリ
ディレクトリ構成	app/, lib/, components/の役割
コマンド	ビルド、テスト、lint、デプロイの実行方法
コーディング規約	命名規則、インポートスタイル、エラーハンドリング方針
DB設計	テーブル名、カラム名の命名規則、注意点
環境変数	必要な環境変数の一覧（値は書かない）

ベストプラクティス

Anthropicの推奨によると、CLAUDE.mdは200行以内に収めるのが理想だ。長すぎるとコンテキスト窓を圧迫し、かえってパフォーマンスが落ちる。箇条書きや表を活用して簡潔にまとめることが重要だ。

CLAUDE.mdには階層構造がある。

配置場所	スコープ	用途
~/.claude/CLAUDE.md	全プロジェクト共通	個人の好み、共通コーディングスタイル
プロジェクトルート/CLAUDE.md	プロジェクト全体	プロジェクト固有の規約（Gitにコミット推奨）
.claude/CLAUDE.md	プロジェクト（個人用）	個人のプロジェクト固有設定（.gitignore推奨）

チーム開発では、プロジェクトルートのCLAUDE.mdをGitリポジトリにコミットし、チーム全員で共有するのがベストだ。これにより、誰がClaude Codeを使っても同じ規約に沿ったコードが生成される。

主要機能 —— 何ができるのか

Claude Codeは単なるチャットボットではない。ファイル操作、ターミナルコマンド実行、検索、Git操作、さらにはJupyter Notebookの編集まで、開発者のワークフロー全体をカバーする。

ファイル編集（Read / Write / Edit）

Claude Codeは3つのファイル操作ツールを持つ。

ツール	説明	使い分け
Read	ファイルの内容を読み取る	コードの理解、画像・PDFの読み取り
Write	ファイルを新規作成または完全上書き	新しいファイルの作成
Edit	ファイルの一部を差分で編集	既存ファイルの修正（推奨）

Editツールは「old_string → new_string」の差分置換で動作する。ファイル全体を書き直す必要がないため、大きなファイルでも効率的に編集できる。

ターミナルコマンド実行（Bash）

Claude Codeはターミナルコマンドを直接実行できる。npm install、git commit、テストの実行、ビルドなど、あらゆるコマンドが対象だ。ただし、セキュリティのためにサンドボックス内で実行され、危険な操作は事前に確認を求められる。

検索（Glob / Grep）

ツール	用途	例
Glob	ファイル名パターンで検索	**/*.tsxで全TSXファイルを探す
Grep	ファイル内容を正規表現で検索	function handleSubmitを含むファイルを探す

大規模なコードベースでも高速に検索できるため、「この関数はどこで使われている？」といった調査が瞬時に完了する。

Git操作の自動化

Claude Codeの真価はGitワークフローの自動化にある。コード修正からコミット、プルリクエストの作成まで、一連の流れを自然言語で指示できる。

> このバグを修正して、テストを通して、PRを作成して

この一言で、Claude Codeはバグの原因を特定し、修正を加え、テストを実行し、コミットメッセージを作成し、GitHubにプルリクエストを作成する。

Jupyter Notebook編集

Claude Codeは.ipynbファイルの読み書きにも対応している。データサイエンティストにとっては、ノートブックのセル単位での編集や、コード・マークダウン・出力の統合的な操作が可能だ。

Web検索・取得

Claude Codeにはリアルタイムの情報取得機能も備わっている。WebSearchツールで最新情報を検索し、WebFetchツールでURLのコンテンツを取得・分析できる。ドキュメントやAPIリファレンスの確認に活用できる。

MCP（Model Context Protocol）—— AIツール連携の新標準

MCPとは何か。Anthropicが2024年11月に策定したオープンプロトコルで、AIモデルと外部ツール・サービスをつなぐ「USBポート」のような規格だ。Claude CodeはMCPのファーストクラスサポートを備えており、200以上のMCPサーバーと連携できる。

MCPでできること

連携先	機能例
GitHub	PR作成、Issue管理、コードレビュー
Slack	メッセージ送信、チャンネル検索、スレッド読み取り
Notion	ページ作成・更新、データベース操作
Google Drive	ドキュメント検索・取得
Supabase	SQL実行、マイグレーション管理
Vercel	デプロイ、ログ取得、プレビュー管理
PostgreSQL / MySQL	データベースの直接操作
Figma	デザインデータの取得・コンポーネント生成

Deferred Loading（遅延読み込み）

MCPサーバーが増えると、ツール定義だけでコンテキスト窓を圧迫してしまう。Claude Codeはこの問題を「Deferred Loading（遅延読み込み）」で解決している。

Anthropicの技術ブログによると、この仕組みにより、MCPツール定義によるコンテキスト消費が95%削減された。具体的には、ツールの全定義をあらかじめ読み込むのではなく、必要になった時点でToolSearchコマンドを使って動的にロードする。200以上のツールが登録されていても、実際にコンテキストに載るのは使用中のツールだけだ。

MCPの設定方法

MCPサーバーはプロジェクトの.claude/settings.jsonで設定する。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-github"],
      "env": { "GITHUB_TOKEN": "ghp_xxxxx" }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-slack"],
      "env": { "SLACK_TOKEN": "xoxb-xxxxx" }
    }
  }
}

フック（Hooks）—— 自動化の拡張ポイント

Claude Codeのフック機能を使えば、ツール実行の前後に独自の処理を挟むことができる。2025年後半に導入されたこの機能は、チームの開発ワークフローを大幅にカスタマイズする力を持つ。

フックイベントの種類

Claude Codeには複数のフックイベントが用意されている。

イベント	タイミング	用途例
PreToolUse	ツール実行前	危険なコマンドのブロック、コード規約チェック
PostToolUse	ツール実行後	ログ記録、通知送信、自動フォーマット
Notification	通知発生時	Slackへの通知転送
Stop	応答完了時	結果のサマリー生成

特に強力なのはPreToolUseフックだ。このフックからは「block」を返すことができ、特定の操作を事前に阻止できる。たとえば、本番環境のデータベースへの書き込みコマンドをブロックしたり、特定のファイルパターンへの書き込みを禁止したりすることが可能だ。

ハンドラーの種類

フックのハンドラーは3種類ある。

ハンドラー	説明	用途
Command	シェルコマンドを実行	lintの自動実行、ログ出力
Prompt	AI にプロンプトを送信	コード品質の自動レビュー
Agent	サブエージェントを起動	複雑な検証タスクの委譲

設定場所

フックは.claude/settings.jsonまたは~/.claude/settings.jsonで設定する。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "handler": {
          "type": "command",
          "command": "echo 'Bash tool invoked' >> /tmp/claude-log.txt"
        }
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write",
        "handler": {
          "type": "command",
          "command": "npx prettier --write $CLAUDE_FILE_PATH"
        }
      }
    ]
  }
}

GitHub Actions連携 —— PRレビューとIssue対応の自動化

Claude CodeはGitHub Actionsとの統合により、CI/CDパイプラインにAIエージェントを組み込むことができる。Anthropicが公式に提供するclaude-code-actionを使えば、PRのレビューやIssueの対応を自動化できる。

主な機能

機能	説明
PRレビュー	コード変更を分析し、改善提案をコメント
Issue対応	Issueの内容を理解し、修正PRを自動作成
@claude メンション	PRやIssueで@claudeとメンションすると応答
CI統合	テスト失敗時に自動で修正を試みる

Anthropicの事例報告によると、claude-code-actionを導入した企業では、コードレビュー時間が平均40%短縮され、テストカバレッジが72%まで向上したという。

設定例

# .github/workflows/claude-review.yml
name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]
  issue_comment:
    types: [created]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          github_token: ${{ secrets.GITHUB_TOKEN }}

@claudeとメンションするだけでAIがPRの差分を読み、問題点を指摘し、場合によっては修正コミットまで作成する。チームの開発速度を底上げする強力なツールだ。

競合比較 —— Claude Code vs Cursor vs GitHub Copilot vs Windsurf

AIコーディングツールは群雄割拠の時代を迎えている。Claude Codeは競合と比べてどのような位置づけにあるのか。

項目	Claude Code	Cursor	GitHub Copilot	Windsurf
提供元	Anthropic	Cursor Inc.	GitHub (Microsoft)	Codeium
月額料金	$20〜$200（Pro/Max）	$20/月（Pro）	$10/月（Individual）	$15/月（Pro）
API従量課金	あり	なし	なし	なし
動作環境	ターミナル	専用IDE（VS Code fork）	VS Code拡張	専用IDE
コンテキスト窓	100万トークン	非公開（推定10万前後）	非公開	非公開
エージェント機能	フル対応	Agent Mode対応	Agent対応（限定的）	Cascade対応
MCP対応	ネイティブ（200+サーバー）	対応（限定的）	非対応	対応（限定的）
Git操作	完全自動化	部分対応	部分対応	部分対応
開発者満足度	46%	38%	32%	28%

2026年2月のRetool Developer Surveyによると、開発者満足度ではClaude Codeが46%でトップ、Cursorが38%で2位、GitHub Copilotが32%で3位だった。

Claude Codeの最大の強みは「100万トークンのコンテキスト窓」と「ターミナルネイティブの柔軟性」だ。一方、弱点はGUIがないこと。ターミナル操作に慣れていない開発者には、CursorやWindsurfのようなIDE型ツールのほうが直感的に使えるだろう。

選び方のガイドラインはシンプルだ。ターミナル派でエージェント機能をフル活用したいならClaude Code、GUI重視で統合開発環境が欲しいならCursor、既にVS Codeユーザーで手軽に始めたいならGitHub Copilot。自分のワークフローに合ったツールを選ぶことが最も重要だ。

実践テクニック集 —— 生産性を最大化する7つのTips

Claude Codeを日常的に使う中で蓄積された実践テクニックを紹介する。

1. コンテキストが80%を超えたら /compact

Claude Codeの/costコマンドでコンテキスト使用率を確認できる。80%を超えると応答品質が低下し始めるため、/compactで会話履歴を要約・圧縮するのが効果的だ。

2. タスク切り替え時は /clear

バグ修正から新機能実装に移る場合など、タスクの性質が変わる時は/clearで会話をリセットする。前のタスクのコンテキストが残っていると、関係のないファイルを参照してしまうことがある。

3. カスタムスラッシュコマンドを活用する

.claude/commands/ディレクトリにMarkdownファイルを配置すると、カスタムスラッシュコマンドとして利用できる。チームの定型作業（コードレビュー、リリースノート作成など）をテンプレート化すれば、品質とスピードの両立が可能だ。

<!-- .claude/commands/review.md -->
以下の観点でコードレビューを行ってください：
1. セキュリティ上の問題はないか
2. パフォーマンスのボトルネックはないか
3. テストカバレッジは十分か
4. 命名規則はプロジェクトの規約に沿っているか

4. サブエージェントに委譲する

複雑なタスクは、Claude Codeのサブエージェント機能を活用して分割統治する。たとえば「フロントエンドの修正」「バックエンドのAPI変更」「テストの追加」を並列で処理させることで、大幅な時間短縮が期待できる。

5. Worktree分離で安全に実験する

Git worktreeとClaude Codeを組み合わせると、メインブランチを汚さずにAIに自由に実験させることができる。/worktreeコマンドで隔離された作業環境を作成し、結果が良ければマージ、ダメなら破棄する。

6. CLAUDE.mdを定期的に更新する

プロジェクトが進化するにつれて、コーディング規約やディレクトリ構造も変わる。CLAUDE.mdが古い情報のままだと、Claude Codeが誤ったコードを生成する原因になる。月に1回はCLAUDE.mdの見直しを行うべきだ。

7. Extended Thinking を活用する

複雑なアーキテクチャ設計やデバッグには、Extended Thinking（拡張思考）モードが有効だ。Claude Codeは内部で段階的に推論を行い、より深い分析結果を返してくれる。--thinkフラグで有効化できる。

制限事項と注意点 —— 知っておくべきリスク

Claude Codeは強力なツールだが、万能ではない。導入前に理解しておくべき制限事項がある。

Proプランの利用制限

Proプラン（月額$20）はClaude Codeを利用できるが、利用量に制限がある。5時間ごとのローリングウィンドウと週次制限の2段構えで、ヘビーに使うと1日の中で制限に達することがある。開発者コミュニティでは「Proだと午前中で制限に引っかかることがある」という声も少なくない。

トークン消費の不透明さ

Claude Codeがバックグラウンドで消費しているトークン量は、/costコマンドである程度把握できるが、正確な残り利用量はわかりにくい。Anthropicが公式に「5時間あたりの利用上限」を公開しているものの、具体的なトークン数は明示されていない。

オフラインモードの不在

Claude Codeは完全にクラウド依存であり、インターネット接続がなければ一切使用できない。飛行機内やネットワークの不安定な環境での利用は不可能だ。

品質のばらつき

一部の開発者からは「以前のバージョンのほうが応答品質が高かった」という報告もある。大規模なモデルアップデート後に一時的に品質が低下するケースがあり、Anthropicも公式に品質改善の取り組みを続けていると表明している。

制限事項	影響度	対策
Proプランの利用制限	高	Max 5x以上にアップグレード or API従量課金
トークン消費の不透明さ	中	/costで定期的に確認、/compactで節約
オフラインモード不在	中	安定したネットワーク環境を確保
品質のばらつき	低〜中	重要な変更は必ず人間がレビュー

まとめ —— コードを「語る」時代へ

Claude Codeは、AIコーディングツールの概念を根本から変えた。コード補完の域を超え、プロジェクト全体を理解し、自律的にタスクを遂行するエージェントとして、開発者の生産性を飛躍的に向上させている。

インストールは5分で完了する。CLAUDE.mdでプロジェクトの「憲法」を定義すれば、AIはチームの一員のようにコーディング規約を守り、一貫性のあるコードを書く。MCPで外部ツールと連携し、GitHub Actionsでレビューを自動化し、フックでワークフローをカスタマイズする。

もちろん、利用制限や品質のばらつきといった課題もある。だが、毎月のように追加される新機能と改善を見れば、これらの課題が解消されるのは時間の問題だろう。

コードを書く時代から、コードを「語る」時代へ。エージェントAIが真のパートナーとなった時、プログラミングの定義そのものは変わるだろうか。

---

出典・参考

• Anthropic 公式ブログ — Claude Code
• Claude Code 公式ドキュメント
• Claude API Pricing
• Retool Developer Survey 2026
• npm — @anthropic-ai/claude-code
• GitHub — anthropics/claude-code
• Claude Help Center — Using Claude Code
• Anthropic — Model Context Protocol