「AIエージェント」タグの記事が1件件あります

こんにちは、箕浦です。

「このファイルをリファクタリングして」と伝えたら、関連ファイルを探し、コードを書き換え、テストを通すところまで勝手にやってくれる
それがAnthropicの自律型AIコーディングエージェント 「Claude Code」 です。

この記事では、導入手順から普段の使い方、知っておくと得する活用テクニックまで、2026年4月時点の情報をもとにまとめました。

第一章：Claude Codeとは？​

概要​

Claude Codeは、Anthropicが公開した 自律型のAIコーディングエージェント です。
コンピュータ上で直接コードを書き、実行し、デバッグまでこなします。

これまでのAIチャット（ChatGPTやGeminiなど）は「コードを生成して画面に表示する」だけで、コピー＆ペーストや実行はユーザー自身が行う必要がありました。
Claude Codeはそこから一歩踏み込み、ファイルの作成・編集・削除、ターミナルコマンドの実行、Gitの操作などを自律的に行います。

他のAIコーディングツールとの違い​

「GitHub Copilotやカーソル（Cursor）と何が違うの？」という疑問を持つ方も多いと思います。
主要ツールとの違いを表にまとめました。

最大の違いは 自律性の高さ です。
Claude Codeは「ここを直して」と伝えるだけで、関連するファイルを自分で探し、修正し、テストを実行して結果を確認するところまで一気に実行します。

料金プラン​

Claude Codeの利用には、以下のいずれかのプランが必要です（2026年4月時点）。

気軽に試す場合はProプラン、本格的に開発に組み込む場合はMaxプランまたはAPI利用がおすすめです。

第二章：Claude Codeの導入とインターフェース​

Claude Codeを利用するためのインターフェースは主に5つあります。
それぞれの導入手順と特徴を詳しく見ていきましょう。

1. CLI（コマンドラインインターフェース）​

全機能が使えて、CI/CDへの組み込みにも対応できる、一番柔軟な使い方です。

動作要件​

• OS: macOS / Linux / Windows（Git for Windowsが必要）
• Anthropicアカウント: Pro以上のプラン、またはAPIキー

インストール手順​

macOS / Linux / WSLの場合：

# 1. ネイティブインストーラーでインストール（推奨）
curl -fsSL https://claude.ai/install.sh | bash

# 2. プロジェクトディレクトリに移動
cd /path/to/your/project

# 3. Claude Codeを起動
claude

Windows PowerShellの場合：

# 1. ネイティブインストーラーでインストール
irm https://claude.ai/install.ps1 | iex

# 2. プロジェクトディレクトリに移動
cd C:\path\to\your\project

# 3. Claude Codeを起動
claude

ネイティブインストーラーを使うと、バックグラウンドで自動アップデートが行われるため、常に最新版を利用できます。

初回起動時にブラウザが開き、Anthropicアカウントでの認証が求められます。
認証が完了すると、ターミナル上で対話的にClaude Codeを利用できるようになります。

CLIの特徴​

• Claude Codeの 全機能にアクセス可能
• ローカルファイルの直接操作に最適
• パイプやリダイレクトなど、シェルとの連携が可能
• claude -p "質問" のようにワンショットで実行することも可能

2. デスクトップアプリ​

Claudeの公式デスクトップアプリ（macOS / Windows対応）内で利用できるモードです。

利用手順​

1. claude.ai からデスクトップアプリをダウンロード
2. アプリを起動し、ログイン
3. チャット画面の入力欄にある 「コード」ボタン をクリック
4. Claude Codeモードに切り替わる

デスクトップアプリの特徴​

• CLIよりも 視覚的で直感的 なインターフェース
• チャット形式で自然言語による指示が可能
• ファイルのドラッグ＆ドロップに対応
• ターミナル操作に慣れていなくても、チャット感覚で始められる

3. Webブラウザ​

ブラウザ版Claude（claude.ai）からもClaude Codeにアクセス可能です。

Webブラウザ版の特徴​

• GitHubリポジトリとの連携 が前提となる
• クラウド上の仮想環境（サンドボックス）で作業が実行される
• ローカル環境を汚さずに試せるので、まず雰囲気を見たい方にちょうどいい
• ただし、ローカルファイルへの直接アクセスは不可

4. VS Code拡張機能​

VS Code内でネイティブなGUIパネルとしてClaude Codeを利用できる 推奨インターフェース です。

インストール手順​

1. VS Code 1.98.0以上を用意
2. 拡張機能マーケットプレイスで「Claude Code」を検索してインストール
3. Sparkアイコン（✱）をクリックしてClaude Codeパネルを開く

VS Code拡張の特徴​

• インラインdiff表示 でコード変更を視覚的にレビュー
• @ファイル名 でファイルや選択範囲を直接参照
• 複数タブ・複数ウィンドウで並列会話が可能
• CLI機能への統合ターミナルからのアクセスも可能

5. JetBrains IDEプラグイン​

IntelliJ IDEA、PyCharm、WebStormなど主要なJetBrains IDEで利用可能なプラグインです。

インストール手順​

1. Settings → Plugins から「Claude Code」を検索してインストール
2. IDEを再起動
3. 統合ターミナルで claude を実行

JetBrains版の特徴​

• IDEのdiffビューアでコード変更を表示
• 選択中のコードやエディタのコンテキストを自動共有
• IDE内の診断エラー（lint、構文エラー等）を自動共有

インターフェース選択のガイド​

第三章：Claude Codeの基本機能​

1. コンテキストウィンドウの管理​

Claude Codeを使いこなす上で 一番差がつくの がコンテキストウィンドウ（≒記憶容量）の管理です。

コンテキストウィンドウとは？​

AIモデルが一度に参照できる情報量の上限のことです。
Claude Codeでは作業中に以下の情報がコンテキストに蓄積されます。

• ユーザーとの会話履歴
• 読み込んだファイルの内容
• 実行したコマンドの結果
• AIが生成したコードや思考プロセス

この容量が上限に近づくと、古い情報が参照できなくなったり、回答の精度が低下します。

コンテキストを溢れさせないコツ​

1. タスク単位で/clearする: 1つの作業が完了したら会話をリセット
2. /compactで圧縮する: 途中経過は不要だが結論は保持したい場合に使用
3. 巨大なファイルを丸ごと読ませない: 必要な部分だけを指定して読み込ませる
4. 複雑なタスクは分割する: 1回のセッションで1つの明確な目標を設定

2. 基本的な操作と「Planモード」​

通常モードと Planモードの切り替え​

Claude Codeにはパーミッションモードという仕組みがあり、AIの自律度を段階的に制御できます。

Shift + Tab キーを押すと、有効化されているモードを順番に巡回します。

上記4モードの他に、CI/CD向けで許可済みツールのみ実行する dontAsk モードと、サンドボックス環境専用の bypassPermissions モードも存在します。

Planモードが有効なケース​

• 複数ファイルにまたがる大規模な変更
• アーキテクチャの設計判断が必要な作業
• 失敗するとリカバリが大変な操作（データベースのマイグレーション等）

実践例：Planモードの活用​

# Planモードで指示を出す例
> [Plan] React + TypeScriptで、ユーザーのTODOリストを管理するアプリを作ってください。
> 要件：
> - TODOの追加・削除・完了切り替えができること
> - ローカルストレージに保存すること
> - Tailwind CSSでスタイリングすること

Planモードでは、Claude Codeが以下のような計画を提示します。

計画:
1. プロジェクトの初期セットアップ（Vite + React + TypeScript）
2. Tailwind CSSの設定
3. TODOの型定義を作成
4. useLocalStorageカスタムフックを実装
5. TodoItemコンポーネントを作成
6. TodoListコンポーネントを作成
7. Appコンポーネントに統合
8. 動作確認

この計画でよろしいですか？

ユーザーが「OK」と返すと、計画に沿って順番に実装を進めます。

3. スラッシュコマンド一覧​

/ から始まるコマンドで様々な操作が可能です。
主要なコマンドをカテゴリ別にまとめました。

セッション管理​

情報・設定​

ファイル・コード操作​

4. CLAUDE.md（指示書ファイル）​

CLAUDE.mdは、プロジェクトごとのルールやコーディング規約、ユーザーの好みをAIに伝えるための 設定ファイル です。

CLAUDE.mdの配置場所と優先順位​

CLAUDE.mdは複数の場所に配置でき、すべてが読み込まれます。

CLAUDE.mdの記述例​

# プロジェクトルール

## コーディング規約

- TypeScriptを使用し、`any`型の使用を禁止する
- 関数コンポーネントとhooksパターンを使用する
- テストは必ずVitest + Testing Libraryで書く

## コミットメッセージ

- Conventional Commitsの形式に従う
- 日本語で記述する

## プロジェクト構成

- src/components: UIコンポーネント
- src/hooks: カスタムフック
- src/utils: ユーティリティ関数
- src/types: 型定義

## 注意事項

- 回答は必ず日本語で行うこと
- 既存のコードスタイルを尊重すること

/init コマンドを実行すると、Claude Codeがプロジェクトの構成を分析し、適切なCLAUDE.mdを自動生成してくれます。

5. 5つの主要拡張機能​

Claude Codeには機能を広げる5つの仕組みがあります。それぞれ見ていきましょう。

(1) MCP（Model Context Protocol）​

外部ツールやサービスとClaude Codeを連携 させるためのプロトコルです。

具体的な連携例：

• GitHub MCP: Issue・PRの作成、レビューコメントの投稿
• データベースMCP: PostgreSQLやMongoDBのクエリ実行
• Slack MCP: チャンネルへのメッセージ送信
• ブラウザMCP: Webページの取得・スクレイピング
• AWS MCP: AWSドキュメントの参照

MCPを設定することで、Claude Codeが 開発に必要な外部サービスに直接アクセス できるようになります。

(2) Skills​

Skillsは、特定のタスクに関する 詳細な手順書・マニュアル をClaude Codeに読み込ませる仕組みです。

例えば：

• UIデザインのガイドライン
• テストの書き方のベストプラクティス
• コードレビューのチェックリスト

SKILL.md というファイルに手順を記述し、特定のタスクが要求されたときに自動で読み込まれるよう設定できます。

(3) Hooks​

Hooksは、Claude Codeの特定のイベントに対して 自動で実行される処理 を定義する仕組みです。 現在20以上のフックイベントが用意されています。主要なものを紹介します。

例：タスク完了時に通知音を鳴らす設定

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "afplay /System/Library/Sounds/Glass.aiff"
          }
        ]
      }
    ]
  }
}

(4) Subagent​

Subagentは、メインのClaude Codeセッションから 特定のタスクに特化した子AI を呼び出す仕組みです。

• 大量のコード検索を並列で行う
• 独立したリサーチタスクを委託する
• 複雑な作業を分割して効率化する

メインのコンテキストを汚さずに別タスクを実行できるのが便利な点です。

(5) Plugins​

Pluginsは、上記のMCP・Skills・Hooksなどを 1つのパッケージにまとめて配布 する仕組みです。
チームや組織で共通の設定を簡単に共有できます。

第四章：実践テクニック​

1. 効果的なプロンプトの書き方​

Claude Codeへの指示は、具体的に書くほど意図どおりの結果になります。

悪い例：

ログイン機能を作って

良い例：

Next.js App Routerでメールアドレスとパスワードによるログイン機能を実装してください。
- 認証にはNextAuth.jsを使用
- バリデーションはzodで行う
- エラーメッセージは日本語で表示
- ログイン成功後は/dashboardにリダイレクト

2. タスクの分割戦略​

大きな機能を一度に依頼するより、小さなタスクに分割して段階的に進める ほうがうまくいきます。

Step 1: データベースのスキーマ定義 → /clear
Step 2: APIエンドポイントの実装 → /clear
Step 3: フロントエンドのUI実装 → /clear
Step 4: テストの追加 → /clear
Step 5: 統合テストとバグ修正

各ステップの完了後に /clear でコンテキストをリセットし、次のステップに集中させます。

3. よくあるトラブルと対処法​

まとめ​

Claude Codeは更新ペースが速く、頻繁に新機能が追加されています。
この記事で紹介した内容をまとめると：

• Claude Codeとは: ファイル操作やコマンド実行まで自律的に行うAIコーディングエージェント
• 5つの利用方法: CLI、VS Code、JetBrains、デスクトップアプリ、Webブラウザ
• コンテキスト管理が鍵: /clear と /compact を活用して精度を保つ
• Planモード: 大規模な変更前には必ず計画を立てさせる
• CLAUDE.md: プロジェクトルールを記述して一貫性のある出力を得る
• 拡張機能: MCP・Skills・Hooks・Subagent・Pluginsで機能を拡張

Proプラン（月$20）から始められます。公式ドキュメント（code.claude.com/docs）に目を通して、まずは小さなタスクから試してみてください。