株式会社課題解決プラットフォーム
AI研修2026-04-04最終更新: 2026-04-049分で読めます

Claude Code完全ガイド【2026年4月版】初期設定から応用・スキルまで徹底解説

Claude CodeAnthropicCLIMCP生成AI開発ツールAI研修Claudeターミナル自動化
上田拓哉

上田拓哉

監修

株式会社課題解決プラットフォーム 代表取締役

複数事業の経営を通じてAI活用を推進。ChatGPT・Claude・Geminiを自社業務に導入し、50社以上のAI研修を監修。現場目線のAI導入支援を行う実践者。

著者プロフィール →

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 InterpreterGitHub CopilotCursorClaude 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.js18以上(推奨: v20 LTS)node --version
OSmacOS / 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$100Proの5倍大容量開発者の日常利用(推奨)
Max 20x$200Proの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メモリファイルを編集(長期記憶)
/initCLAUDE.mdを対話的に生成初回のみ
/permissions権限設定を表示・変更
/reviewコードレビューを実行
/prPull Request作成ワークフロー
/fastFast 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サーバーできること認証に必要なもの
GitHubIssue/PR作成・レビュー・マージ、コード検索Personal Access Token
GitLabGitHubと同等の機能(GitLab向け)GitLab Token
LinearIssueの作成・更新・検索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
LighthouseCore Web Vitals測定・パフォーマンス分析なし(ローカル実行)
Stripe決済データ取得・サブスク管理Stripe API Key

データベース系

MCPサーバーできること認証に必要なもの
PostgreSQLSQLクエリ実行・スキーマ確認接続文字列
MySQLSQLクエリ実行・スキーマ確認接続文字列
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に「プレビューを確認して」と言うと:

  1. preview_start — 開発サーバーを自動起動
  2. preview_screenshot — ページのスクリーンショットを撮影
  3. preview_snapshot — アクセシビリティツリー(DOM構造のテキスト表現)を取得
  4. preview_console_logs — ブラウザコンソールのエラーを確認
  5. preview_click / preview_fill — ボタンクリックやフォーム入力をシミュレート
  6. preview_inspect — CSSプロパティの値を検証
  7. 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拡張を提供しています。

インストール:

  1. VS Code拡張マーケットプレイスで「Claude Code」を検索
  2. インストール
  3. コマンドパレットから「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 11日目インストール + CLAUDE.md作成基本操作の習得
Phase 21週目settings.jsonの権限設定 + allowリスト調整確認ダイアログの削減
Phase 32週目GitHub MCP追加 + /deployスキル作成Git操作とデプロイの自動化
Phase 41ヶ月目業務固有のスキル3〜5個作成定型作業の完全自動化
Phase 52ヶ月目フック設定 + チーム展開品質チェックの自動化

始め方チェックリスト

  • npm install -g @anthropic-ai/claude-code でインストール
  • claude で初回起動 → 認証完了
  • プロジェクトルートにCLAUDE.mdを作成
  • .claudeignoreで機密ファイルを除外
  • settings.jsonのallowリストに日常コマンドを追加
  • GitHub MCPを1つ追加して動作確認
  • /deployスキルを1つ作成
  • チームメンバーに.claude/ディレクトリを共有

Claude Codeの導入・活用・チーム展開でお困りの方は、当社のAI研修で実践的なハンズオントレーニングを提供しています。企業の業務フローに合わせたカスタムスキルの設計から、MCPサーバーの構築、セキュリティ設計までを支援します。

AI研修・導入支援の詳細はこちら →

関連記事:

📌 この記事のポイント

Anthropic公式のCLIツール「Claude Code」の初期設定からMCPサーバー連携、スキル作成、フック自動化まで完全解説。ターミナルからファイル編集・Git操作・API連携・ブラウザプレビューを一括実行。開発者・非エンジニアの両方に向けた実践ガイド。

この記事は株式会社課題解決プラットフォーム2026-04-04に公開し、2026-04-04に内容を更新しました。内容の正確性を定期的に確認しています。最新の情報についてはお問い合わせください。

よくある質問

Q.Claude Codeは無料で使えますか?

Claude Code自体のCLIツールは無料でインストールできますが、利用にはAnthropicのAPIキーまたはClaude Pro/Max/Teamプランが必要です。APIキーの場合はトークン従量課金、Pro/Maxプランの場合は月額サブスクリプションに含まれます。2026年4月時点でMax(月額$100/$200)が大量利用に最適です。

Q.Claude CodeとChatGPTのCode Interpreterの違いは?

最大の違いは実行環境です。ChatGPTのCode Interpreterはサンドボックス内で限定的にPythonを実行しますが、Claude Codeはローカルマシン上で動作し、実際のファイルシステム、Git、npm、Docker、データベース等すべてにアクセスできます。また、MCPサーバーでSlack・GitHub・Google Drive等の外部サービスとリアルタイム連携できる点が根本的に異なります。

Q.プログラミング経験がなくても使えますか?

基本操作(ターミナルの起動・コマンド入力)ができれば利用可能です。Claude Codeは自然言語で指示を出し、ファイル作成・編集・実行をAIが代行します。ただし、生成されたコードの妥当性を判断するための基礎知識があると効果的です。当社のAI研修では非エンジニア向けのClaude Code活用コースも提供しています。

Q.社内の機密コードをClaude Codeに読ませても大丈夫?

Anthropicの利用規約上、APIキー利用の場合はプロンプトデータがモデル学習に使用されません(2026年4月時点)。企業利用では、.claudeignoreファイルで機密ファイルを除外し、環境変数やAPIキーを含むファイル(.env等)へのアクセスを制限することを推奨します。Teamプランではさらに組織レベルのデータ保護ポリシーが適用されます。

Q.MCPサーバーとは何ですか?

MCP(Model Context Protocol)はAnthropicが策定したオープンプロトコルで、AIモデルと外部ツール・データソースを標準化された方法で接続します。MCPサーバーを追加すると、Claude CodeからSlack検索・GitHub操作・Google Analytics取得・データベースクエリなどを自然言語で実行できるようになります。JSON設定ファイルに追記するだけで導入できます。

CONTACT

無料30分で課題を棚卸し
→ 最適な打ち手をご提案

課題が整理されていなくても構いません。「何から手をつけていいかわからない」状態から一緒に始めます。

お気軽にお問い合わせください。費用が合わなければお断りいただけます。まず話を聞くだけでもOKです。

お問い合わせフォーム

※ 1〜2営業日以内にご連絡します。