Deep Dive / 2025–2026
Claude Code
完全解説
AIとターミナルが融合した新世代の開発環境。階層アーキテクチャから設計思想、スキル・MCP・サブエージェントまで体系的に理解する。
01
What is Claude Code
Claude Code とは何か
Claude Code は、Anthropic が2025年2月にリリースしたエージェント型コーディングツールです。単なるチャットボットではなく、ファイルの読み書き・コマンド実行・gitワークフロー管理を、自然言語の指示だけで自律的に行えるAIエージェントです。
従来のAIコーディングアシスタントが「コード補完」や「提案」を行うのに対し、Claude Code は「実行する」ツールです。コードベース全体を把握した上で、複数ファイルをまたいで変更を加え、テストを走らせ、コミットメッセージを書き、PRを作成することができます。
従来のAIツール
GitHub Copilot など
- 次の行を補完・提案する
- 人間が毎ステップを指示
- IDEのパネルに常駐
- 単一ファイル中心
- 提案→人間が採用/却下
VS
Claude Code
エージェント型
- 高レベルの目標から自律実行
- ステップを自分で計画・判断
- ターミナル・IDE・Web に対応
- コードベース全体を横断
- 実行→結果確認→修正のループ
できること
コード理解
既存コードベースの構造解析・説明
実装
機能追加・バグ修正・リファクタ
テスト
テスト作成・実行・検証
git連携
コミット・ブランチ・PR作成
外部連携
Slack・Jira・DBなどMCP経由
02
Architecture & Layers
Claude との
階層的な違い
「Claude」と「Claude Code」は、しばしば混同されます。正確に言うと、これらは同じAIモデルを基盤にしながら、異なるレイヤーで動作するプロダクトです。以下の図は、Anthropicのプロダクト階層を視覚的に示しています。
Claude モデル（LLM）
Claude Sonnet / Opus / Haiku。言語理解・推論の基盤。API経由でのみアクセス可能。
Foundation
↕
Claude.ai / Claude アプリ
一般ユーザー向けチャットUI。ブラウザ・モバイル・デスクトップ。ファイルアップロード・Artifacts・Projectsなどを提供。
Chat Interface
↕
Anthropic API
開発者向けの直接アクセス。Messages API・Function Calling・Streaming・Files API・MCP Connectorなど。
Developer API
↕
Claude Code（CLI / Agent）
ターミナル・IDE・Web上で動くエージェントツール。コードベースへの直接アクセス、コマンド実行、MCP、Skills、Hooksなどを統合。
Agentic Tool
↕
プロジェクト環境（ファイルシステム・git・外部ツール）
実際のコードリポジトリ、シェル環境、CI/CD、外部SaaSツール。Claude Codeが直接操作する実世界。
Real World
階層ごとの本質的な違い
| プロダクト | 主なユーザー | 操作の主体 | ファイルシステムへのアクセス |
|---|---|---|---|
| Claude.ai | 一般ユーザー | 常に人間 | なし（添付ファイルのみ） |
| Anthropic API | 開発者 | 開発者が制御 | APIクライアント次第 |
| Claude Code | エンジニア | AIが自律実行 | ✓ 直接読み書き・実行 |
ポイント： Claude.ai では「Claudeに相談してコードを書いてもらい、自分でファイルにペーストする」のに対し、Claude Code では「Claudeが自分でファイルを開いて編集し、テストを実行し、コミットまでする」という根本的な違いがあります。
03
Design Philosophy
なぜターミナルが
必要なのか
Claude Code がターミナル（CLI）を基盤に設計されている理由は、AIエージェントとしての本質的な要件にあります。GUIのチャット画面では実現できない、システムへの直接アクセスが必要だからです。
claude — プロジェクトルート
$ claude
✓ Claude Code を起動しました
✓ CLAUDE.md を読み込みました
✓ MCP サーバー接続: GitHub, Slack
Human: 認証周りのバグを直してPRを出してほしい
Claude: # コードを調査します
→ grep -r “auth” src/ を実行
→ src/auth/jwt.ts を読み込み
→ 問題箇所を特定: line 47
→ src/auth/jwt.ts を編集
→ npm test を実行 → 全テスト通過
→ git commit -m “fix: JWT expiry validation”
→ gh pr create –title “Fix JWT validation”
✓ PR #234 を作成しました
ターミナルが必要な3つの理由
システムへの直接アクセス
ファイルの読み書き、シェルコマンドの実行、プロセス管理。これらはブラウザのサンドボックス環境では根本的に不可能です。ターミナルはOSへの直接ゲートウェイです。
あらゆる開発ツールとの統合
git、npm、Docker、テストランナー、linter、CI/CDパイプライン——すべてはCLIで動きます。ターミナルを通じることで、AIがこれら全ツールを直接操作できます。
自律的な実行ループ
「実行→観察→修正」のループをAIが自力で回すには、コマンドを自由に実行できる環境が不可欠です。これがエージェントとしての核心であり、ターミナルがその実現手段です。
設計思想： Claude Code はターミナルに「住む」ことで、開発者の環境と完全に統合されます。VS Code拡張・JetBrains Plugin・デスクトップアプリ・Webでも動作しますが、いずれも同じCLIエンジンを基盤とし、CLAUDE.md・設定・MCPサーバーが共通で使われます。
04
Glossary & Concepts
重要用語・概念集
Claude Code を理解するには、いくつかの固有の概念を整理する必要があります。以下は、最も重要な用語を体系的にまとめたものです。
CLAUDE.md
プロジェクトへの永続メモリファイル
プロジェクトのルートに置くMarkdownファイル。セッション開始時に毎回読み込まれ、コーディング規約・アーキテクチャの決定・使用ライブラリ・レビューチェックリストなどを記述しておく。「このプロジェクトのAIへの引き継ぎ書」として機能する。
スキル（Skills）
自動的に呼び出される専門知識のカプセル
SKILL.md ファイルと関連リソースで構成されるフォルダ。タスクの内容に応じてClaudeが自動で検出・読み込み、適用する。「Excelファイルを扱う」「社内ドキュメントを書く」など、再利用可能な手順と知識を封じ込める仕組み。スラッシュコマンドとの違いは、自動的に起動される点。
MCP
Model Context Protocol — 外部ツール接続の標準規格
AIとGitHub・Slack・Jira・データベースなどの外部システムをつなぐオープンプロトコル（2024年11月登場）。MCPサーバーを設定することで、Claude Code が外部サービスのデータを読み書きできる。「AIのUSB-C規格」とも呼ばれる。スキルが「どう使うか」の知識なら、MCPは「つなぐ先」のインフラ。
サブエージェント
（Subagent）
（Subagent）
独立したコンテキストを持つ専門AI
メインのClaude Codeセッションから呼び出される、独立したAIエージェント。それぞれが別のコンテキストウィンドウ・ツール権限・システムプロンプトを持つ。例：コードレビュー専用エージェントには「読み取り権限のみ」を与えてセキュリティを確保。並列作業や役割分担に使う。
フック（Hooks）
アクションのライフサイクルに挿入するシェルコマンド
Claude Codeが特定のアクション（ファイル編集後・コミット前など）を実行した際に自動で走るシェルコマンド。例：「ファイル編集後に自動でlintを実行」「コミット前にテストが必ず通ることを確認」。ルールの強制やルーティンの自動化に使う。
スラッシュコマンド
（/commands）
（/commands）
人間が明示的に呼び出すワークフローショートカット
/review-pr・/deploy-staging のように、チームで共有・再利用できるカスタムワークフロー。スキルとの違いは、人間が意図的に呼び出す点。よく使う手順を1コマンドに凝縮する。
プラグイン
設定・スキル・コマンド・フックのパッケージ
CLAUDE.md・スキル・スラッシュコマンド・フックをまとめて配布・インストールできる仕組み。チーム全体の設定を統一したり、コミュニティのワークフローを取り込むのに使う。
Planモード
実行前に計画をレビューするモード
Claude Code が実際にファイルを変更・コマンド実行する前に、「こういう手順でやります」という計画を提示し、人間がレビュー・承認できるモード。大きな変更を行う前の安全弁として機能する。
ワークツリー
（Worktrees）
（Worktrees）
並列エージェントのための隔離されたgit環境
gitのworktree機能を使い、複数のClaude Codeエージェントが独立したブランチで同時並行作業できる環境。エージェント間の干渉を防ぎつつ、並列開発を実現する。
コンテキストウィンドウ
AIが一度に「覚えていられる」情報量
Claude Codeが一セッションで参照できる情報の上限。大きなコードベースや長いセッションでは、コンテキストが枯渇しないよう管理が必要。Claude Pro は標準、Claude Max は最大100万トークンのコンテキストウィンドウを使用可能。
スキル vs MCP：使い分けの原則
スキル（Skills）
「どうやるか」の知識
- 手順・ルール・ベストプラクティス
- 指示をコンテキストに注入
- タスク内容で自動起動
- プログラム実行は不要
- Markdownファイルで定義
×
MCP
「どこにつなぐか」のインフラ
- 外部システムへのアクセス
- データ取得・更新・操作
- サーバー設定が必要
- GitHub・Slack・DBなど
- アクセス権限の管理
アナロジー： ハードウェアストアで棚を修理しようとしているとします。MCPは「店の全在庫（道具）へのアクセス」、スキルは「熟練店員がどう使うかを教えてくれる専門知識」。両方揃って初めて仕事が完結します。
05
Ecosystem Overview
エコシステム全体像
Claude Code は単体のCLIツールにとどまらず、複数の実行環境と拡張機構を持つ包括的なエコシステムを形成しています。
Claude Code エンジン
（共通の実行基盤）
実行環境
ターミナル CLI
VS Code / Cursor
JetBrains IDE
デスクトップアプリ
Webブラウザ
拡張機構
CLAUDE.md
（プロジェクト記憶）
（プロジェクト記憶）
Skills
（専門知識）
（専門知識）
MCP
（外部接続）
（外部接続）
Subagents
（並列処理）
（並列処理）
Hooks
（自動化）
（自動化）
Plugins
（配布）
（配布）
CI/CD・チーム連携
GitHub Actions
@claude タグ
@claude タグ
GitLab CI/CD
Slack連携
マルチエージェントとWorktreesによる並列開発
2025年末から2026年にかけて、Agent Teams（エージェントチーム）機能が拡充されました。複数のClaude Codeインスタンスを同時に起動し、それぞれが別々のgit worktreeで独立したタスクを処理します。メインエージェントがオーケストレーターとなり、専門サブエージェントにタスクを委譲・統合するアーキテクチャが構築できます。
重要： すべての実行環境（ターミナル・VS Code・Web・デスクトップ）は同一のClaude Codeエンジンを共有します。CLAUDE.md、MCP設定、Skillsはすべての環境で同期して動作します。
06
Getting Started
始め方と実践
インストール
Claude Code のインストールには Node.js が必要です。CLIツールとして各プラットフォームのパッケージマネージャーで配布されています。
# macOS — Homebrew
brew install anthropic/claude-code/claude-code
# Windows — WinGet
winget install Anthropic.ClaudeCode
# Linux — npm (※npmは非推奨になりつつある)
npm install -g @anthropic-ai/claude-code
# プロジェクトで起動
cd my-project && claude
注意： 初回起動時にClaudeアカウントでのログインが求められます。インタラクティブな使用には Claude Pro または Max プランが必要です。APIキーで利用するBedrock/Vertexとの接続にはAnthropicコンソールアカウントが必要です。
CLAUDE.md の書き方
プロジェクトルートに CLAUDE.md を作成し、Claudeへの恒久的な指示を記述します。
# CLAUDE.md — このプロジェクトについて
## コーディング規約
– TypeScript 5.x を使用
– 関数は必ずJSDocコメントを付ける
– テストは Vitest で書く
## アーキテクチャ
– src/features/ に機能ごとにフォルダを切る
– ビジネスロジックは src/domain/ に置く
## ワークフロー
– コミット前に npm test を必ず実行する
– PRを出す前に私にレビューを求める
実践的なワークフロー例
CLAUDE.md設定
規約・構造をファイルに記述
MCP接続
GitHub/Slack等をつなぐ
Skills追加
チーム固有の手順をスキル化
Hooks設定
lint・test を自動実行
エージェント実行
自然言語で指示→自律実行
プランと費用
| プラン | Claude Code | コンテキスト | 主な用途 |
|---|---|---|---|
| Claude Pro | ✓（制限あり） | 標準 | 個人・小規模プロジェクト |
| Claude Max | ✓（大容量） | 最大100万トークン | 大規模コードベース・ヘビーユース |
| API（従量課金） | ✓（APIキー） | モデル依存 | CI/CD・自動化・企業統合 |
まとめ： Claude Code は「AIとの会話」から「AIによる自律実行」へのパラダイムシフトを体現するツールです。ターミナルを基盤とした設計・CLAUDE.mdによる記憶・Skills/MCP/サブエージェントによる拡張性が組み合わさって、従来の開発ワークフローを根本から変える可能性を持っています。最初の一歩は、既存プロジェクトで
claude を起動し、「このコードベースを説明して」と話しかけるところから始まります。