08-01. Claude Code の世界観 — IDE 拡張ではなく CLI エージェント
この回のゴール
- Claude Code が IDE 拡張(Cursor、Copilot)とは別物であることを理解する
- 「ターミナルから動くエージェント」が成立する 3 つの前提(LLM の Tool 使用 / コードベースの構造化 / シェル環境の標準化)を腹落ちする
- 自分の PC に Claude Code を入れて、
claudeを起動して 1 つ質問する
1. なぜ「CLI エージェント」なのか?
IDE 拡張の限界
- Copilot / Cursor は「今カーソルがある場所」周辺の補完が中心
- マルチファイル変更・テスト実行・git 操作・依存関係調査などは IDE の外 での操作が必要
- → AI と人間の間で「コンテキストの受け渡し」が頻繁に発生
CLI エージェントの利点
- Bash / Read / Edit / Grep / WebFetch など、人間が普段ターミナルでやることを AI が直接 できる
- セッションの状態が シェルとしてそのまま 残る → 「テストを走らせて、結果見て、修正して、もう一度」が 1 ターン内で完結
- Unix 哲学(小さな道具を組み合わせる)と相性が良い
第6章で学んだ AI エージェント論との関係
| 第6章で学んだこと | Claude Code での具現化 |
|---|---|
| 計画 → 行動 → 観察 のループ | 標準で備わっている (ReAct + Extended Thinking) |
| ツール定義 (Function Calling) | Read/Edit/Bash/Grep 等が built-in |
| 状態管理 | セッション全体のメッセージ履歴 + ファイルシステムの状態 |
| 停止条件 | ユーザーの確認、タスク完了、エラー、リトライ上限 |
→ Claude Code = Anthropic 公式の AI エージェント実装。第6章の理論を「ローカルで実走できる形」にしたもの。
2. インストール (5 分)
注: バージョン 2.x 想定。詳細・最新手順は公式 docs.claude.com/claude-code を参照。
macOS / Linux
curl -fsSL https://claude.com/install.sh | bash
# または: npm install -g @anthropic-ai/claude-code
Windows
- WSL2 で上記と同じ
- もしくは公式の Windows インストーラ(時期により提供状況が変わる)
認証
claude
# 初回起動時に Anthropic Console (https://console.anthropic.com) でログイン
3. ハンズオン: 既存リポジトリで質問してみる
任意のリポジトリ(自分の小さい OSS でも、新規 git clone でも)で:
cd <your-repo>
claude
起動後、以下を順に投げる:
> このプロジェクトの構造を 3 行で説明して> 主要なエントリーポイントは?> テストはどう走らせる? まだなければ、どう追加するのが良い?
観察ポイント:
- Claude が Bash で ls を打つ / Read でファイルを開く / Glob で **/*.py する など、ツール使用の挙動
- Read したファイルが画面下部のステータスラインに表示される
- 質問に対して、Claude が自分で「次に何を見るか」を決めている こと
→ これが AI エージェント の正体。第6章で学んだ ReAct ループが目の前で動いている。
4. このアプリ上で見せる擬似ターミナル
(本アプリ実装時の方針)
- Claude Code の本物セッションをブラウザから呼ぶことは技術的にも安全的にも避ける
- 代わりに 疑似ターミナル UI で、上記のセッション例を録画ログとして再生
- 「ここで Claude が Bash(ls) を打ちました」「ここで Read(app.py) を実行しました」というアノテーション付き
5. 今回の限界 (notes に書く内容)
- インストールは済んだが、Claude は 現状「素のまま」 — このプロジェクトの規約や好みを知らない
- 同じことを聞いても毎セッション「最初から調査」してしまう
- 同じプロジェクトで何度も使うと、毎回同じ説明を Claude に渡す手間が出てくる
- → 次回 (08-02) で CLAUDE.md を導入し、「プロジェクトの記憶」を持たせる
参考
- 公式 Quickstart
- Claude Code 101 (Anthropic Academy)
- 姉妹サイト: claude-academy-japanese ch5-l1: Claude Codeとは — より初心者向けの導入はこちら