Claude Codeとは?— ターミナルに住むAI開発パートナー
Claude Codeは、Anthropicが開発・提供するAIネイティブなコマンドラインインターフェース(CLI)ツールです。単なるコード補完ツールではなく、ファイルの読み書き、コード生成・編集、Git操作、テスト実行、ブラウザプレビュー、外部API連携までを自律的に実行するAIエージェントとして動作します。
2025年2月にプレビュー版がリリースされ、2026年4月現在ではCLI版に加えて**デスクトップアプリ(Mac/Windows)、Webアプリ(claude.ai/code)、IDE拡張(VS Code/JetBrains)**の4形態で利用可能になっています。
何が根本的に違うのか?
「AIにコードを書いてもらう」ツールは多数ありますが、Claude Codeが根本的に異なるのは実行環境です。
【従来のAIコーディングツール】
ユーザー → AIに質問 → 回答を読む → 手動でコピペ → 手動でテスト
【Claude Code】
ユーザー → 自然言語で指示 → AIがファイルを直接編集 → AIがビルド実行 → AIがテスト実行 → AIがデプロイ
つまり、Claude Codeは「コードを提案するAI」ではなく、「コードを書いて実行するAI」です。あなたのパソコン上で、あなたの代わりにターミナルを操作し、エディタでファイルを編集し、Gitでコミットし、サーバーにデプロイします。
主要AIコーディングツール 機能比較表
| 比較項目 | ChatGPT Code Interpreter | GitHub Copilot | Cursor | Claude Code |
|---|---|---|---|---|
| 実行環境 | クラウドサンドボックス | エディタ内補完 | エディタ内(AIペイン) | ローカルマシン全体 |
| ファイル操作 | アップロード限定 | 開いたファイルのみ | プロジェクト内 | 全ファイルシステム |
| Git操作 | 不可 | 限定的 | 限定的 | commit/push/PR作成/rebase |
| 外部サービス連携 | プラグイン経由 | なし | なし | MCP無制限拡張 |
| ターミナルコマンド | Python限定 | 不可 | 一部対応 | npm/docker/curl等すべて |
| 複数ファイル同時編集 | 不可 | 1ファイル | プロジェクト内 | プロジェクト横断 |
| ブラウザプレビュー | 不可 | 不可 | 不可 | スクリーンショット+DOM解析 |
| コンテキスト | 128K〜 | ファイル単位 | プロジェクト | 最大1Mトークン(Opus) |
| 自律実行 | 不可 | 不可 | 限定的 | 完全自律(サブエージェント) |
実際の動作イメージ — ターミナルセッション例
Claude Codeを起動して「このプロジェクトにダークモードを追加して」と指示した場合、以下のような流れで自律的に作業が進みます。
$ claude
╭──────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code! │
│ │
│ /help for help, /model to change models │
╰──────────────────────────────────────────────╯
> このプロジェクトにダークモードを追加して
● Exploring codebase structure...
Read: src/app/layout.tsx
Read: src/app/globals.css
Read: tailwind.config.js
Read: src/components/layout/Header.tsx
● I'll add dark mode support. Here's my plan:
1. tailwind.config.jsにdarkMode: 'class'を追加
2. globals.cssにダークテーマのCSS変数を定義
3. ThemeToggleコンポーネントを作成
4. layout.tsxにテーマプロバイダーを追加
5. Headerにトグルボタンを配置
● Editing tailwind.config.js... [Y/n]
ここでユーザーがYを押すと(または自動承認設定なら自動で)、Claude Codeが実際にファイルを編集していきます。1つの指示で5つのファイルを整合性を保ちながら同時に修正し、最後にビルドが通ることまで確認します。
インストール方法 — 5分で完了する初期セットアップ
前提条件
| 項目 | 要件 | 確認コマンド |
|---|---|---|
| Node.js | 18以上(推奨: v20 LTS) | node --version |
| OS | macOS / Linux / Windows(WSL2) | — |
| ターミナル | bash / zsh / PowerShell | — |
| アカウント | Anthropic(APIキーまたはPro/Max/Team) | — |
ステップ1: インストール
# npmでグローバルインストール
npm install -g @anthropic-ai/claude-code
# バージョン確認
claude --version
# Claude Code v1.x.x
よくあるエラーと対処法:
# エラー: permission denied
# 対処: npxで実行するか、nvm経由のNode.jsを使う
npx @anthropic-ai/claude-code
# エラー: command not found
# 対処: PATHが通っていない。以下で確認
which claude
# npmのグローバルパスを確認
npm config get prefix
ステップ2: 認証
# 初回起動 — ブラウザで認証フローが開始
claude
# APIキーを直接指定する場合
export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude
初回起動時にブラウザが自動で開き、Anthropicアカウントでのログインを求められます。Pro/Max/Teamプランに加入済みなら、その場で認証が完了します。
APIキーを使う場合は環境変数に設定してから起動します。.bashrcや.zshrcに追記しておくと便利です。
# ~/.zshrc に追記(永続化)
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-..."' >> ~/.zshrc
source ~/.zshrc
ステップ3: プロジェクトで起動
# 必ずプロジェクトのルートディレクトリで起動する
cd ~/my-project
claude
# ワンライナーで質問を投げることも可能
claude "package.jsonの依存関係を確認して"
料金プラン比較 — どれを選ぶべきか?
| プラン | 月額 | トークン上限 | Claude Code利用 | おすすめユーザー |
|---|---|---|---|---|
| API(従量課金) | $3/MTok入力, $15/MTok出力(Opus) | 無制限(残高次第) | APIキー必要 | 自動化パイプライン、CI/CD |
| Pro | $20 | 制限あり | 利用可能 | 個人の軽い利用 |
| Max 5x | $100 | Proの5倍 | 大容量 | 開発者の日常利用(推奨) |
| Max 20x | $200 | Proの20倍 | 最大容量 | ヘビーユーザー、チームリード |
| Team | $30/人 | 組織管理付き | 全機能 | 企業導入 |
コスト比較の実例:
- API従量課金でOpus 4.6を1日8時間ヘビーに使うと、1日あたり約$30〜80(月$600〜1,600)
- Max 5x($100/月)なら同程度の利用が固定費で収まる
- 結論: 週に数回以上使うなら、Max 5xが圧倒的にコスパが良い
初期設定の詳細 — Claude Codeを「自分仕様」にする
設定ファイルの3層構造
Claude Codeの設定は3つのレベルで管理されます。下位の設定が上位を上書きします。
Level 1: グローバル設定(全プロジェクト共通)
~/.claude/
├── settings.json ← 全プロジェクト共通の設定
├── keybindings.json ← キーバインド
└── projects/
└── {hash}/
└── CLAUDE.md ← プロジェクト別のAI記憶
Level 2: プロジェクト設定(Git管理して共有)
{project}/.claude/
├── settings.json ← このプロジェクト固有の設定
├── launch.json ← 開発サーバー設定
└── commands/
├── deploy.md ← /deploy カスタムスキル
└── blog.md ← /blog カスタムスキル
Level 3: プロジェクトルートの指示書
{project}/CLAUDE.md ← AIへの永続的な指示書
{project}/.claudeignore ← AIにアクセスさせないファイル
CLAUDE.md — AIへの永続的な指示書(最重要ファイル)
CLAUDE.mdはプロジェクトルートに配置する「AIへの指示書」です。会話をリセットしても、Claude Codeは毎回この内容を自動で読み込みます。チームで共有する場合はGit管理します。
何を書くべきか:
# プロジェクトルール
## 技術スタック
- Next.js 14, App Router, TypeScript
- Tailwind CSS 3 (tailwind.config.js, NOT .ts)
- Node.js v20.20.1 via nvm
- 静的エクスポート (output: 'export')
- Cloudflare Pages でホスティング
## ビルドとデプロイ
- ビルド: `npm run build`
- デプロイ: `npx wrangler pages deploy out --project-name my-project`
- 開発サーバー: `npm run dev` (port 3000)
## コーディング規約
- 関数名はcamelCase、コンポーネントはPascalCase
- 日本語のコメント推奨
- console.logは本番コードに残さない
- importは自動ソートに任せる
## ファイル構成ルール
- src/components/ — Reactコンポーネント(UI/機能別サブフォルダ)
- src/lib/ — ユーティリティ関数・定数(constants.ts が単一ソース)
- src/app/ — App Routerのページ
- content/blog/ — MDXブログ記事
## 禁止事項
- node_modulesを直接編集しない
- .envファイルをコミットしない
- mainブランチに直接pushしない
- 料金データはconstants.tsの値を必ず参照する(直書き禁止)
- 既存ファイルを不必要に書き換えない
## ブログ記事の品質基準
- 1記事8,000文字以上
- FAQ 3問以上
- 比較表を1つ以上含める
- 内部リンク3本以上、サービスページへのCTA必須
よくある失敗:
- CLAUDE.mdを書かずに使い始める → 毎回同じ説明を繰り返す羽目に
- 技術スタックを書かない → TypeScriptなのにJavaScriptで書いてくる
- 禁止事項を書かない → .envを誤ってGit管理してしまう
settings.json — 権限と自動化の制御
{
"permissions": {
"allow": [
"Read",
"Edit",
"Write",
"Glob",
"Grep",
"Bash(npm run build)",
"Bash(npm run dev)",
"Bash(npm run lint)",
"Bash(npm test*)",
"Bash(npx wrangler pages deploy*)",
"Bash(git status)",
"Bash(git diff*)",
"Bash(git log*)",
"Bash(git add*)",
"Bash(git commit*)",
"Bash(git push*)",
"Bash(ls *)",
"Bash(wc *)"
],
"deny": [
"Bash(rm -rf *)",
"Bash(sudo *)",
"Bash(chmod 777 *)",
"Bash(curl * | bash)",
"Bash(git push --force*)",
"Bash(git reset --hard*)"
]
},
"env": {
"ANTHROPIC_MODEL": "claude-sonnet-4-6"
}
}
allowとdenyの設計思想:
allow: 毎回確認ダイアログを出さずに自動実行するコマンドdeny: どんな指示でも絶対に実行させないコマンド- どちらにも入っていないコマンド: 実行前にユーザーに確認を求める
チームで使う場合のパターン:
// .claude/settings.json(リポジトリにコミット)
{
"permissions": {
"allow": [
"Read", "Glob", "Grep",
"Bash(npm run *)",
"Bash(git status)", "Bash(git diff*)", "Bash(git log*)"
],
"deny": [
"Bash(rm -rf *)",
"Bash(sudo *)",
"Bash(git push --force*)"
]
}
}
ビルドやGit操作は許可し、破壊的コマンドを明示的にブロックします。新メンバーがClaude Codeを使い始めても、危険な操作が実行されることはありません。
.claudeignore — 機密ファイルの保護
# .claudeignore
.env
.env.*
credentials/
secrets/
*.pem
*.key
*.p12
.git/hooks/
node_modules/
これにより、Claude Codeは指定されたファイルを一切読み取れなくなります。APIキーや秘密鍵が誤って共有されるリスクを根本から排除します。
基本操作 — 日常的に使う操作の完全リファレンス
起動オプション
# 標準起動(対話モード)
claude
# 質問を直接渡す(ワンショット)
claude "このプロジェクトの構成を説明して"
# パイプで入力(ファイル内容を渡す)
cat error.log | claude "このエラーの原因を分析して"
# モデル指定(デフォルトはSonnet)
claude --model claude-opus-4-6
# レジューム(前回の会話を続ける)
claude --resume
モデル選択ガイド
| モデル | 用途 | 速度 | 精度 | コスト |
|---|---|---|---|---|
| Haiku 4.5 | 簡単な質問、ファイル検索 | 最速 | 中 | 最安 |
| Sonnet 4.6 | 日常のコーディング(デフォルト) | 速い | 高 | 中 |
| Opus 4.6 | 複雑な設計、大規模リファクタ | 遅い | 最高 | 高 |
| Opus 4.6(1Mコンテキスト) | 巨大プロジェクトの全体把握 | 遅い | 最高 | 最高 |
実践的な使い分け:
/model sonnet→ 通常の開発作業、ファイル編集、テスト作成/model opus→ アーキテクチャの設計、難しいバグの調査、30ファイル以上に影響する大規模変更- 1つの会話内でモデルを切り替えることも可能。最初にOpusで設計→Sonnetで実装が効率的
スラッシュコマンド完全一覧
| コマンド | 説明 | 使用頻度 |
|---|---|---|
/help | ヘルプ表示 | 初回のみ |
/clear | 会話履歴をリセット(ファイル変更は残る) | 高 |
/compact | 会話を要約して圧縮(コンテキスト節約) | 高 |
/model [name] | モデルを切り替え | 中 |
/cost | 現在のセッションのトークン消費量とコスト | 中 |
/memory | メモリファイルを編集(長期記憶) | 中 |
/init | CLAUDE.mdを対話的に生成 | 初回のみ |
/permissions | 権限設定を表示・変更 | 低 |
/review | コードレビューを実行 | 中 |
/pr | Pull Request作成ワークフロー | 中 |
/fast | Fast Mode切替(同モデルで高速出力) | 高 |
コンテキストウィンドウの管理 — 長時間セッションで必須のテクニック
Claude Codeは会話が長くなるとコンテキストウィンドウ(AIが一度に把握できる情報量)の上限に近づきます。
症状: 「さっき修正したファイルの内容を忘れている」「同じ質問を繰り返す」
対処法:
> /compact
✓ 会話を要約しました(52,000トークン → 8,000トークン)
> /clear
✓ 会話をリセットしました(CLAUDE.mdとメモリは保持)
/compact: 会話内容を要約圧縮。作業の連続性は保たれる/clear: 完全リセット。新しいタスクに取りかかるときに使う
ベストプラクティス:
- 1タスク完了ごとに
/compact - まったく別の作業に移るときは
/clear - 大規模な作業はCLAUDE.mdに中間成果を書かせてから
/clear
メモリシステム — AIの長期記憶
Claude Codeには、会話をまたいで情報を保持する「メモリ」機能があります。
メモリの仕組み
~/.claude/projects/{project-hash}/memory/
├── MEMORY.md ← インデックスファイル
├── user_role.md ← ユーザー情報
├── feedback_testing.md ← フィードバック記録
├── project_deadline.md ← プロジェクト情報
└── reference_linear.md ← 外部参照情報
Claude Codeは会話中に学んだことを自動でメモリに保存し、次回の会話で参照します。
保存される情報の例:
- 「このユーザーはデータサイエンティストだ」→ 次回から技術的に深い回答
- 「テストはモックを使わず実DBで」→ 次回のテスト作成時に自動適用
- 「マージフリーズは4月5日から」→ PR作成時に警告
手動でメモリを操作:
> /memory
# メモリファイルがエディタで開く
> このプロジェクトのデプロイ先はCloudflare Pagesだと覚えて
✓ メモリに保存しました
MCP(Model Context Protocol)— Claude Codeの真の力
MCPはClaude Codeの最も革新的な機能です。外部サービスとの連携を追加することで、ターミナルから出ずにあらゆるツールを操作できるようになります。
MCPの仕組み
┌─────────────────┐
│ Claude Code │
│ (AIエージェント) │
└────────┬────────┘
│ MCP Protocol (JSON-RPC)
┌────┴────┐
│ │
┌───┴───┐ ┌──┴────┐ ┌─────────┐ ┌──────────┐
│GitHub │ │Slack │ │Google │ │Ahrefs │
│MCP │ │MCP │ │Analytics│ │MCP │
│Server │ │Server│ │MCP │ │Server │
└───┬───┘ └──┬───┘ └────┬────┘ └────┬─────┘
│ │ │ │
┌───┴───┐ ┌──┴───┐ ┌───┴────┐ ┌───┴──────┐
│GitHub │ │Slack │ │GA4 │ │Ahrefs │
│API │ │API │ │API │ │API │
└───────┘ └──────┘ └────────┘ └──────────┘
MCPサーバーは「Claude Codeと外部サービスの間を翻訳する通訳者」です。Claude Codeが「Slackで#generalチャンネルの最新メッセージを検索して」と言うと、MCP Server for SlackがSlack APIを呼び出して結果を返します。
MCPサーバーの追加方法
~/.claude/settings.json(グローバル)または.claude/settings.json(プロジェクト別)に追記します。
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
}
},
"slack": {
"command": "npx",
"args": ["-y", "@anthropic/mcp-slack"],
"env": {
"SLACK_BOT_TOKEN": "xoxb-xxxx",
"SLACK_TEAM_ID": "T01234567"
}
},
"google-analytics-ga4": {
"command": "npx",
"args": ["-y", "mcp-google-analytics-ga4"],
"env": {
"GA4_PROPERTY_ID": "properties/12345678",
"GA4_CREDENTIALS": "/path/to/service-account.json"
}
}
}
}
設定後、Claude Codeを再起動するだけ。 インストールは不要です(npxが自動でダウンロード)。
主要MCPサーバーカタログ(2026年4月時点)
開発系
| MCPサーバー | できること | 認証に必要なもの |
|---|---|---|
| GitHub | Issue/PR作成・レビュー・マージ、コード検索 | Personal Access Token |
| GitLab | GitHubと同等の機能(GitLab向け) | GitLab Token |
| Linear | Issueの作成・更新・検索 | Linear API Key |
| Sentry | エラー取得・分析 | Sentry Auth Token |
| Docker | コンテナの起動・停止・ログ取得 | Docker socket |
コミュニケーション系
| MCPサーバー | できること | 認証に必要なもの |
|---|---|---|
| Slack | チャンネル検索・メッセージ送信 | Bot Token + Team ID |
| Gmail | メール検索・下書き作成 | OAuth2 credentials |
| Google Calendar | 予定の確認・作成 | OAuth2 credentials |
マーケティング・分析系
| MCPサーバー | できること | 認証に必要なもの |
|---|---|---|
| Google Analytics (GA4) | レポート取得・イベント分析 | Service Account JSON |
| Google Search Console | 検索パフォーマンス分析・URL検査 | OAuth2 credentials |
| Ahrefs | キーワード調査・被リンク分析・競合調査 | Ahrefs API Key |
| Lighthouse | Core Web Vitals測定・パフォーマンス分析 | なし(ローカル実行) |
| Stripe | 決済データ取得・サブスク管理 | Stripe API Key |
データベース系
| MCPサーバー | できること | 認証に必要なもの |
|---|---|---|
| PostgreSQL | SQLクエリ実行・スキーマ確認 | 接続文字列 |
| MySQL | SQLクエリ実行・スキーマ確認 | 接続文字列 |
| SQLite | ローカルDBのクエリ | ファイルパス |
| Cloudflare D1 | エッジDBのクエリ | API Token |
ストレージ系
| MCPサーバー | できること | 認証に必要なもの |
|---|---|---|
| Google Drive | ファイル検索・内容読み取り | OAuth2 credentials |
| Notion | ページ検索・読み取り・作成 | Integration Token |
| Confluence | ページ検索・読み取り | API Token |
| Box | ファイル検索・読み取り・アップロード | OAuth2 credentials |
実践例: MCP連携で何ができるか
例1: SEO分析→記事改善→デプロイの全自動化
> Ahrefsで競合のキーワードを分析して、
GSCで自サイトのCTRが低いキーワードを抽出して、
該当記事のタイトルを最適化して、
ビルドしてデプロイして
● Ahrefs MCP → 競合キーワード取得(3秒)
● GSC MCP → CTR低下キーワード5件特定(2秒)
● 5記事のfrontmatter編集(10秒)
● npm run build 実行(30秒)
● wrangler pages deploy 実行(15秒)
✓ 完了。5記事のタイトルを最適化しデプロイしました。
例2: 日次レポートの自動生成
> GA4の昨日のデータとGSCの直近7日データを取得して、
マーケティングSlackチャンネルにレポートを投稿して
● GA4 MCP → PV/UU/直帰率取得
● GSC MCP → クリック数/表示回数/平均順位
● Slack MCP → #marketing に投稿
✓ 完了。レポートを#marketingに投稿しました。
例3: バグ報告→調査→修正→PR作成
> Sentryの最新エラーを確認して、原因を調査して修正して、PRを作って
● Sentry MCP → "TypeError: Cannot read property 'map' of undefined" 取得
● ファイル調査 → src/components/BlogList.tsx L42
● 修正: nullチェックを追加
● git checkout -b fix/blog-list-null-check
● git commit → git push
● GitHub MCP → PR作成 → URL返却
✓ PR: https://github.com/xxx/yyy/pull/123
MCPサーバーのトラブルシューティング
| 症状 | 原因 | 対処法 |
|---|---|---|
| MCP接続タイムアウト | npxの初回ダウンロードに時間がかかる | 一度npx -y @modelcontextprotocol/server-xxxを手動実行 |
| 認証エラー | envのトークンが無効 | トークンの有効期限・スコープを確認 |
| ツールが表示されない | settings.jsonの構文エラー | `cat ~/.claude/settings.json |
| MCPが起動後すぐ終了 | Node.jsバージョン不一致 | node --versionで18以上を確認 |
スキル(Skills)— 繰り返し作業をワンコマンド化する
スキルとは
スキルは、繰り返し行うワークフローをMarkdownファイルに定義し、/コマンド名で呼び出せるようにする機能です。
.claude/commands/
├── blog.md → /blog で呼び出し
├── seo.md → /seo で呼び出し
├── deploy.md → /deploy で呼び出し
└── review-pr.md → /review-pr で呼び出し
スキルの作成方法(実例付き)
例: /deploy スキル
---
description: ビルドしてCloudflare Pagesにデプロイする
---
## 手順
1. `npm run build` を実行
2. ビルドが成功したら `npx wrangler pages deploy out --project-name my-project` を実行
3. デプロイURLを報告
## エラー時
- ビルドエラー: エラー内容を表示し、修正を提案
- デプロイエラー: Cloudflare API Tokenの有効性を確認するよう案内
例: /blog スキル(SEO特化ブログ自動生成)
---
description: ブログ記事を4本自動生成しデプロイする
---
## 前提
- Ahrefs MCPで最新のキーワードデータを取得する
- GSC MCPでサイトの現在の検索パフォーマンスを確認する
- 4カテゴリ: MEO対策(shobai-ai), AI研修(ai-training), 動画制作(video), AIO対策(aio)
## 記事の品質基準
- 1記事8,000文字以上
- frontmatter必須: title, date, category, description, tags, faq(3問以上)
- 比較表を1つ以上含める
- 内部リンク3本以上 + サービスページへのCTA
- 料金データはsrc/lib/constants.tsの値を正確に引用する
## 手順
1. Ahrefs MCPでキーワード調査
2. GSC MCPで既存記事のパフォーマンス確認
3. content/blog/ に4つのMDXファイルを作成
4. npm run build でビルド確認
5. デプロイ
6. GSC MCPで新記事のインデックス登録を申請
## ファイル命名規則
- {category}-{連番}.mdx (例: shobai-ai-48.mdx)
- 連番は既存の最大値 + 1
このスキルを作成しておけば、ターミナルで/blogと入力するだけで、キーワード調査→記事4本生成→ビルド→デプロイ→インデックス登録まで全自動で実行されます。
ユーザー固有スキル vs プロジェクトスキル
| 配置場所 | スコープ | Git管理 | 用途 |
|---|---|---|---|
~/.claude/commands/ | 全プロジェクト共通 | しない | 個人の汎用ワークフロー |
.claude/commands/ | このプロジェクトのみ | する | チーム共有ワークフロー |
フック(Hooks)— イベント駆動の自動化
フックの仕組み
フックは「特定のイベントが発生したとき、指定したスクリプトを自動実行する」仕組みです。
// settings.json
{
"hooks": {
"PreToolUse": [
{
"matcher": "Write|Edit",
"command": "echo '⚠️ ファイル変更を検知'"
}
],
"PostToolUse": [
{
"matcher": "Edit",
"command": "cd /path/to/project && npx eslint --fix ${CLAUDE_FILE_PATH} 2>/dev/null || true"
}
],
"Notification": [
{
"command": "terminal-notifier -title 'Claude Code' -message '${CLAUDE_NOTIFICATION_MESSAGE}'"
}
],
"Stop": [
{
"command": "/path/to/post-stop-check.sh"
}
]
}
}
フックの種類と使い分け
| フック名 | 発火タイミング | 用途 | 環境変数 |
|---|---|---|---|
PreToolUse | ツール実行の直前 | 危険操作の検知・ブロック | CLAUDE_TOOL_NAME, CLAUDE_FILE_PATH |
PostToolUse | ツール実行の直後 | Lint自動実行、通知 | CLAUDE_TOOL_NAME, CLAUDE_FILE_PATH |
Notification | 通知発生時 | Slack通知、音声通知 | CLAUDE_NOTIFICATION_MESSAGE |
Stop | 会話停止時 | 品質チェック、レポート生成 | なし |
実践的なフック設定例
例1: ファイル編集後にESLint + Prettierを自動実行
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"command": "cd /path/to/project && npx eslint --fix ${CLAUDE_FILE_PATH} && npx prettier --write ${CLAUDE_FILE_PATH} 2>/dev/null || true"
}
]
}
}
例2: コード変更があるのにdevサーバーが未起動なら警告
{
"hooks": {
"Stop": [
{
"command": "if git diff --name-only | grep -q 'src/'; then lsof -i :3000 > /dev/null 2>&1 || echo 'WARNING: Code was edited but no dev server is running.'; fi"
}
]
}
}
例3: デプロイ完了時にSlackに通知
{
"hooks": {
"PostToolUse": [
{
"matcher": "Bash(npx wrangler*)",
"command": "curl -s -X POST -H 'Content-type: application/json' --data '{\"text\":\"✅ デプロイ完了: '$(date)'\"}' $SLACK_WEBHOOK_URL"
}
]
}
}
launch.json — ブラウザプレビュー連携
Claude Codeは開発サーバーを起動し、ブラウザプレビューを取得・検証する機能を持っています。
設定方法
.claude/launch.jsonを作成します。
{
"version": "0.0.1",
"configurations": [
{
"name": "nextjs",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"port": 3000
},
{
"name": "vite",
"runtimeExecutable": "npx",
"runtimeArgs": ["vite", "--port", "5173"],
"port": 5173
}
]
}
プレビューで何ができるか
設定後、Claude Codeに「プレビューを確認して」と言うと:
- preview_start — 開発サーバーを自動起動
- preview_screenshot — ページのスクリーンショットを撮影
- preview_snapshot — アクセシビリティツリー(DOM構造のテキスト表現)を取得
- preview_console_logs — ブラウザコンソールのエラーを確認
- preview_click / preview_fill — ボタンクリックやフォーム入力をシミュレート
- preview_inspect — CSSプロパティの値を検証
- preview_eval — JavaScriptをブラウザ上で実行してデバッグ
> トップページのCTAボタンが正しく表示されているか確認して
● preview_start → Next.js Dev Server起動(port 3000)
● preview_screenshot → トップページのスクリーンショット取得
● preview_snapshot → DOM構造確認(CTAリンク存在)
● preview_click → CTAボタンをクリック
● preview_console_logs → エラーなし
✓ CTAボタンは正常に表示・動作しています。
nvm環境での注意点:
nvm経由でNode.jsを使っている場合、npmが直接実行できないことがあります。その場合はruntimeExecutableにフルパスを指定します。
{
"version": "0.0.1",
"configurations": [
{
"name": "nextjs",
"runtimeExecutable": "/Users/username/.nvm/versions/node/v20.20.1/bin/node",
"runtimeArgs": [
"node_modules/next/dist/bin/next",
"dev",
"/path/to/project"
],
"port": 3000
}
]
}
エージェントモード — 並列処理と自律実行
サブエージェントの仕組み
Claude Codeは複雑なタスクを分割し、複数のサブエージェントを並列で起動して処理を高速化します。
ユーザー: 「SEO分析してブログ4本書いてデプロイして」
│
├── [並列] Explore Agent: コードベース構造調査
├── [並列] Ahrefs Agent: キーワード調査
├── [並列] GSC Agent: パフォーマンスデータ取得
│
├── [統合] データ分析・記事プランニング
│
├── [並列] 記事1: MEO記事生成
├── [並列] 記事2: AI研修記事生成
├── [並列] 記事3: 動画記事生成
├── [並列] 記事4: AIO記事生成
│
├── [順次] npm run build
├── [順次] wrangler pages deploy
└── [順次] GSCインデックス登録
独立した調査タスクは並列で走り(3秒で完了)、依存関係のあるタスク(ビルド→デプロイ)は順序を守って実行されます。
バックグラウンドエージェント
時間のかかるリサーチをバックグラウンドで走らせ、別の作業を並行して進めることもできます。
> Lighthouseで全ページのパフォーマンスを分析して(バックグラウンドで)
● Agent started in background...
> [別の作業を続行]
> ブログ記事のタイポを修正して
● Editing content/blog/ai-training-29.mdx...
🔔 Background agent completed: Lighthouse analysis
Performance: 72/100, LCP: 2.8s, CLS: 0.05
Worktree(ワークツリー)モード
Git worktreeを使って、メインブランチに影響を与えずに実験的な変更をエージェントに任せることができます。エージェントが変更に満足すれば、そのブランチをマージするかどうかをユーザーが判断します。
IDE統合 — VS Code / JetBrains
VS Code拡張
Claude Codeは公式のVS Code拡張を提供しています。
インストール:
- VS Code拡張マーケットプレイスで「Claude Code」を検索
- インストール
- コマンドパレットから「Claude Code: Open」
特徴:
- エディタのサイドパネルでClaude Codeと対話
- 選択したコードを右クリック →「Claude Codeに質問」
- ターミナルの出力をそのままClaude Codeに渡せる
- エディタの変更とClaude Codeの変更がリアルタイム同期
JetBrains拡張
IntelliJ IDEA、WebStorm、PyCharm等のJetBrains IDEでも利用可能です。
セキュリティ — 企業利用で押さえるべきポイント
データ保護の仕組み
| 利用形態 | データの学習利用 | データの保持 | 備考 |
|---|---|---|---|
| APIキー | なし | 30日間ログ保持 | 入出力はモデル学習に使われない |
| Pro/Max | なし | 30日間ログ保持 | 個人利用向け |
| Team | なし | 管理者設定に準拠 | 組織レベルのポリシー適用 |
| Enterprise | なし | カスタム設定 | SSO, SCIM, 監査ログ |
セキュリティチェックリスト
| チェック項目 | 推奨設定 | 理由 |
|---|---|---|
| .claudeignoreの設定 | .env, credentials/, *.pem を除外 | 機密情報のAI送信を防止 |
| denyリストの設定 | rm -rf, sudo, git push --force | 破壊的操作を防止 |
| CLAUDE.mdのGit管理 | する | チーム全員に同じルールを適用 |
| APIキーの管理 | 環境変数 or Secrets Manager | コードにハードコードしない |
| Teamプランの利用 | 企業は推奨 | 組織レベルの監査ログ |
トラブルシューティング集
よくある問題と解決策
Q: Claude Codeが応答しなくなった
# プロセスを確認
ps aux | grep claude
# 再起動
claude --resume # 前回の会話を再開
Q: 「permission denied」で操作が拒否される
# settings.jsonのallowリストを確認
cat ~/.claude/settings.json
# 一時的に許可
> /permissions
# 対話的に許可を追加
Q: MCPサーバーが接続できない
# MCPサーバーを手動テスト
npx -y @modelcontextprotocol/server-github
# 環境変数を確認
echo $GITHUB_TOKEN
# settings.jsonの構文チェック
python3 -m json.tool < ~/.claude/settings.json
Q: コンテキストウィンドウが上限に達した
> /compact # 会話を圧縮
> /model sonnet # より効率的なモデルに切替
> /clear # 完全リセット(最終手段)
Q: ビルドが通らないコードを生成してくる
# CLAUDE.mdに以下を追記:
## 必須ルール
- コード変更後は必ず `npm run build` を実行して成功を確認すること
- TypeScriptの型エラーは放置しないこと
導入効果 — 数値で見る生産性向上
当社のAI研修でClaude Codeを導入した企業の実績データです(2025年10月〜2026年3月、受講企業15社の平均)。
| 業務 | 導入前 | 導入後 | 改善率 | 備考 |
|---|---|---|---|---|
| コードレビュー | 1PR 45分 | 1PR 12分 | 73%削減 | GitHub MCP連携 |
| ブログ記事作成 | 1本 4時間 | 1本 30分 | 87%削減 | /blogスキル利用 |
| バグ調査 | 平均 2時間 | 平均 20分 | 83%削減 | 1Mコンテキスト活用 |
| デプロイ作業 | 手動 30分 | 自動 1分 | 97%削減 | /deployスキル利用 |
| SEO分析レポート | 半日 | 15分 | 96%削減 | Ahrefs+GSC MCP連携 |
| テストコード作成 | 1関数 20分 | 1関数 3分 | 85%削減 | テストパターン自動生成 |
| ドキュメント更新 | 1ページ 1時間 | 1ページ 10分 | 83%削減 | Notion MCP連携 |
ROI試算
| 項目 | 金額 |
|---|---|
| Claude Code Max 5x(月額) | $100(約15,000円) |
| エンジニア1名の時給(仮) | 5,000円 |
| 月間削減時間(実績平均) | 40時間 |
| 月間削減額 | 200,000円 |
| ROI | 約13倍 |
まとめ — Claude Codeで変わる開発ワークフロー
Claude Codeは「AIにコードを書いてもらうツール」ではなく、開発・分析・デプロイ・マーケティングを横断する自律型AIエージェントです。
導入ロードマップ
| フェーズ | 期間 | やること | 効果 |
|---|---|---|---|
| Phase 1 | 1日目 | インストール + CLAUDE.md作成 | 基本操作の習得 |
| Phase 2 | 1週目 | settings.jsonの権限設定 + allowリスト調整 | 確認ダイアログの削減 |
| Phase 3 | 2週目 | GitHub MCP追加 + /deployスキル作成 | Git操作とデプロイの自動化 |
| Phase 4 | 1ヶ月目 | 業務固有のスキル3〜5個作成 | 定型作業の完全自動化 |
| Phase 5 | 2ヶ月目 | フック設定 + チーム展開 | 品質チェックの自動化 |
始め方チェックリスト
-
npm install -g @anthropic-ai/claude-codeでインストール -
claudeで初回起動 → 認証完了 - プロジェクトルートに
CLAUDE.mdを作成 -
.claudeignoreで機密ファイルを除外 -
settings.jsonのallowリストに日常コマンドを追加 - GitHub MCPを1つ追加して動作確認
-
/deployスキルを1つ作成 - チームメンバーに
.claude/ディレクトリを共有
Claude Codeの導入・活用・チーム展開でお困りの方は、当社のAI研修で実践的なハンズオントレーニングを提供しています。企業の業務フローに合わせたカスタムスキルの設計から、MCPサーバーの構築、セキュリティ設計までを支援します。
関連記事:
