Claude Code: Claude Code 入門と仕組み
最終更新:2026-08-31
Claude Code は Anthropic の AI コーディング Agent です。チャットボットではなく、ファイルの読み取り、テストの実行、コードの修正、フィードバックに基づく反復を自律的に行えるインテリジェントな存在です。

💡 ヒント: Claude Code の核心的な違いは「Agent」であり「Chat」ではありません。チャットツールは質問に答えますが、Agent は自律的に操作を実行します — ファイルの読み取り、コマンドの実行、コードの修正、結果の検証を一つの完結した作業ループで行います。
📋 前提条件: 事前知識は不要ですが、基本的なコマンドラインの知識があると役立ちます
1. 学ぶ内容
- Claude Code の位置づけ:Agent であり Chat ではない
- ローカルコードリポジトリでの動作方法
- コアアーキテクチャと権限モデル
- 従来の AI コーディングツールとの比較
- ユースケースと制限
コード例の出力について
本コースのコード例は決定性/非決定性分離パターンを採用しています。これはAIエージェントツールチュートリアルの業界ベストプラクティスです:
| マーカー | 意味 | あなたの出力 |
|---|---|---|
| 出力: | 決定的な結果(インストール、設定、カウントなど) | 例とほぼ一致するはず |
| インタラクションフロー: | エージェントの動作フロー(LLM呼び出し、ツール選択など) | 実際のテキストは異なるが、フローは類似 |
| 検証方法: | 演習結果の確認方法 | 記載された手順に従って確認 |
💡 なぜ違うのか? 従来のプログラミング:
1 + 1 = 2(常に同じ)。AIエージェントツール:agent.chat("コードを分析") = ???(毎回異なる)。これはAIエージェントツールの本質的な特性であり、バグではありません。
2. 実際のチームのストーリー
(1) 課題:AI コーディングツールの効率ボトルネック
Alice は中規模インターネット企業のテックリードです。彼女のチームは様々な AI コーディングツールを試しました:
- ChatGPT: 回答の質は良いが、コードをプロジェクトに手動でコピペする必要がある
- GitHub Copilot: オートコンプリートは便利だが、局所的な補完のみでプロジェクト全体を理解できない
- Cursor: IDE 統合は良いが、複雑なリファクタリングの Agent 能力が限定的
プロダクトマネージャーの Bob の要求は増え続けています:
「認証モジュール全体を Session から JWT に移行する必要がある。20 以上のファイルが関係し、すべてのテストが通ることを確認して。」
(2) Claude Code の解決策
Alice は Claude Code をインストールし、1つのコマンドで移行を開始しました:
BASH
claude "Migrate the authentication module from Session to JWT, ensure all tests pass"
Claude Code は自律的に以下を完了しました:
- プロジェクト構造を読み取り、すべての認証関連ファイルを特定
- 認証ロジックを1つずつ修正
- テストスイートを実行
- 失敗結果に基づいてコードを修正
- すべてのテストが通るまで反復
TEXT
📖 参照専用
Files modified: 23
Tests run: 47
Tests passed: 47
Iterations: 3
Time: ~8 minutes
3. Claude Code とは
(1) コア定義
Claude Code はローカルコードリポジトリで直接動作するコマンドライン AI Agentです:
| 特徴 | 説明 |
|---|---|
| 位置づけ | AI コーディング Agent、チャットツールではない |
| 環境 | ローカルターミナル / IDE ターミナル |
| 作業スタイル | ファイル読み取り → 分析 → 修正 → 検証 → 反復 |
| 権限モデル | 高い権限、ファイルの読み書きとコマンド実行が可能 |
| モデル | Claude Sonnet / Opus |
(2) Agent と Chat の本質的な違い
graph LR
A[ユーザーの指示] --> B[Chat モード]
A --> C[Agent モード]
B --> B1[回答を生成]
B1 --> B2[ユーザーが手動実行]
C --> C1[意図を理解]
C1 --> C2[コンテキストを読み取り]
C2 --> C3[操作を実行]
C3 --> C4[結果を検証]
C4 --> C5{成功?}
C5 -->|いいえ| C2
C5 -->|はい| C6[結果を報告]
| 次元 | Chat ツール | Agent(Claude Code) |
|---|---|---|
| インタラクション | Q&A | 自律的反復 |
| コード操作 | コードスニペットを出力 | プロジェクトファイルを直接修正 |
| コンテキスト | ユーザーが手動で提供 | プロジェクトファイルを自動読み取り |
| 検証 | ユーザーが手動で検証 | テスト/コマンドを自動実行 |
| エラー処理 | ユーザーが自己修正 | 自己修正して再試行 |
▶ 例1:Chat と Agent の比較
BASH
# Chat アプローチ:ユーザーは複数ステップが必要
# 1. AI にバグ修正方法を聞く
# 2. コードをコピー
# 3. ファイルにペースト
# 4. テストを実行
# 5. テストが失敗、ステップ1に戻る
# Agent アプローチ:1つのコマンドで全て完了
claude "Fix the null pointer exception in user.service.ts, ensure tests pass"
4. Claude Code の仕組み
(1) ワークフロー
Claude Code の作業ループ:
graph TB
U[ユーザー入力] --> P[意図解析]
P --> R[プロジェクトコンテキストを読み取り]
R --> A[操作を計画]
A --> E[操作を実行]
E --> V[結果を検証]
V --> S{成功?}
S -->|はい| RPT[結果を報告]
S -->|いいえ| A
(2) 権限とセキュリティ
Claude Code は高い権限を持ちますが、多層的なセキュリティ制御を提供します:
| 権限レベル | 範囲 | 確認方法 |
|---|---|---|
| Read | プロジェクトファイルの読み取り | 自動許可 |
| Write | プロジェクトファイルの修正 | 初回確認 / 自動 |
| Execute | シェルコマンドの実行 | 確認が必要(自動設定可能) |
| Network | パッケージのインストール、API へのアクセス | 確認が必要 |
▶ 例2:Claude Code の作業プロセス
BASH
$ claude "Create date.ts under src/utils/ with common date formatting functions and tests"
# Claude Code の自律的な作業プロセス:
# 1. src/utils/ ディレクトリ構造を読み取り中...
# 2. スタイル統一のため既存の utils を読み取り中...
# 3. src/utils/date.ts を formatDate(), relativeTime() 等と共に作成
# 4. src/utils/__tests__/date.test.ts を作成
# 5. 実行中: npm test -- src/utils/__tests__/date.test.ts
# 6. 2つのテストが失敗... エッジケースを修正
# 7. 実行中: npm test -- src/utils/__tests__/date.test.ts
# 8. 6つのテストがすべて合格 ✓
5. 他の AI コーディングツールとの比較
| ツール | タイプ | 作業範囲 | Agent 能力 | モデル |
|---|---|---|---|---|
| Claude Code | CLI Agent | プロジェクト全体 | 強い | Claude |
| GitHub Copilot | IDE プラグイン | 単一ファイル補完 | 弱い | GPT シリーズ |
| Cursor | IDE + Agent | IDE 内 | 中程度 | マルチモデル |
| Aider | CLI Agent | プロジェクト全体 | 中程度 | マルチモデル |
| Codex CLI | CLI Agent | プロジェクト全体 | 強い | GPT シリーズ |
| OpenCode | CLI Agent | プロジェクト全体 | 中程度 | マルチモデル |
▶ 例3:Alice のツール評価
PYTHON
def evaluate_tool(tool_name, agent_score, scope_score, multi_file):
score = agent_score * 0.4 + scope_score * 0.3 + (1 if multi_file else 0) * 0.3
return round(score, 2)
tools = {
"Claude Code": {"agent": 9, "scope": 9, "multi_file": True},
"Copilot": {"agent": 3, "scope": 4, "multi_file": False},
"Cursor": {"agent": 6, "scope": 7, "multi_file": True},
"Aider": {"agent": 7, "scope": 8, "multi_file": True},
}
for name, scores in tools.items():
result = evaluate_tool(name, scores["agent"], scores["scope"], scores["multi_file"])
print(f"{name}: {result}")
6. 総合例:プロジェクトレベルのリファクタリング
BASH
# シナリオ:Alice が Express プロジェクトを Fastify に移行する必要がある
$ claude "Migrate the entire project from Express to Fastify:
1. Replace all route definitions
2. Update middleware syntax
3. Modify startup script
4. Ensure all tests pass
5. Update package.json dependencies"
# Claude Code が自律的に実行:
# → 45ファイルで Express パターンをスキャン中...
# → ルート定義を変換中(32ルート)...
# → ミドルウェアを更新中(8ファイル)...
# → テストスイートを実行: 89/89 合格 ✓
# → package.json を更新中...
# → Express 依存関係を削除中...
# → 最終テスト実行: 89/89 合格 ✓
❓ よくある質問
Q Claude Code と Claude.ai の違いは?
A Claude.ai は Web チャットインターフェースで、テキスト回答のみを出力します。Claude Code は CLI Agent で、コードプロジェクトを直接操作できます。両者は同じ基盤モデルを使用しますが、インタラクションモードは全く異なります。
Q Claude Code は私のコードを密かにアップロードしますか?
A Claude Code は推論のために Anthropic API にコードコンテキストを送信しますが、Anthropic は API データをモデルトレーニングに使用しないと主張しています。機密プロジェクトの場合は、ローカルモデルソリューションの検討を推奨します。
Q インターネットなしで Claude Code を使えますか?
A いいえ。Claude Code は Anthropic API への接続が必要で、オフラインでは動作しません。
Q Claude Code はどのプログラミング言語をサポートしていますか?
A 理論上すべての言語をサポートします — あらゆるテキストファイルの読み書きとシェルコマンドの実行が可能です。TypeScript/Python/Go などの主要言語で最も良いサポートを提供します。
Q Claude Code と Aider はどちらが良いですか?
A Claude Code は統合度が高く Agent 能力が強いですが、Claude モデルのみサポートします。Aider は複数モデルをサポートし、より柔軟です。マルチモデルサポートと IDE 統合の必要性に応じて選択してください。
Q Claude Code はプログラマーに取って代わりますか?
A いいえ。Claude Code は加速ツールであり、反復作業や既知パターンの実装に優れていますが、アーキテクチャ設計、要件分析、複雑な判断には人間が必要です。
📖 まとめ
- Claude Code は Agent ツールであり、チャットツールではない — コア能力は自律的なコード操作
- 作業ループ:読み取り → 分析 → 実行 → 検証 → 反復
- 高い権限と多層セキュリティ制御、自動/手動確認の設定が可能
- CLI ベースで IDE に依存せず、ターミナルで直接動作
- マルチファイルリファクタリング、バグ修正、テスト作成などの複雑なタスクに最適
📝 練習問題
- 基本 (⭐): Claude Code と ChatGPT のコーディング支援における3つのコアな違いを挙げてください。
- 応用 (⭐⭐): あなたのプロジェクトに適した AI コーディングツールを1つ選び、その理由を書いてください(比較表を参照)。
- 高度 (⭐⭐⭐): どのタスクが Claude Code に適し、どのタスクが Copilot に適するかを指定するワークフローを設計し、判断基準を含めてください。