Claude Codeの使い方｜インストールから実践的な開発ワークフローまで完全ガイド

この記事でわかること

• Claude CodeはAnthropicが提供するターミナルベースのAIコーディングエージェントで、ファイル編集・コマンド実行・Git操作をAIが自律的に行える
• MCP（Model Context Protocol）でHubSpot・Slack・Notion等の外部サービスと直接連携でき、開発だけでなく業務自動化にも活用できる
• 実際の開発現場で毎日活用し、従来2週間かかった機能実装を2〜3日で完了するワークフローを確立できる

2025年2月にAnthropicがリリースしたClaude Codeは、ターミナル上で動作するAIコーディングエージェントです。CursorやWindsurfのようなGUIベースのAI IDEとは異なり、コマンドラインから直接AIと対話しながら開発を進めるスタイルが特徴です。

「AIにコードを任せる」Vibe Coding（バイブコーディング）の中でも、Claude Codeはプロフェッショナル向けのツールとして位置づけられています。ファイルの読み書き、ターミナルコマンドの実行、Git操作まで、開発に必要な作業をAIが自律的にこなします。

本記事では、Claude Codeをこれから使い始める方に向けて、インストールから実践的な開発ワークフローの構築まで、実体験をもとに解説します。

Claude Codeとは何か

Claude Codeは、Anthropicが開発したターミナルネイティブのAIコーディングエージェントです。一般的なチャットAIとは異なり、開発者のローカル環境に直接アクセスして作業を行える点が最大の特徴です。

従来のAIコーディングツールとの違い

Claude Codeの強みは「開発者のローカル環境をそのまま使える」ことです。新しいIDEに乗り換える必要がなく、普段使っているVSCodeやVimと併用しながら、重い実装作業をClaude Codeに任せるという使い分けが可能です。

Claude Codeが得意な作業

Claude Codeは以下のような作業で特に力を発揮します。

• 新機能の実装: 「ユーザー認証機能をNext.jsのApp Routerで実装して」のように自然言語で指示するだけで、複数ファイルにまたがる実装を自律的に進める
• リファクタリング: 「このコンポーネントをTypeScript化して、型定義も追加して」のように大規模な書き換えを一括処理
• バグ修正: エラーメッセージやログを渡すだけで、原因を特定し修正を提案・実行
• テスト作成: 既存コードを読み取って、テストケースを自動生成
• コードベース調査: 大規模プロジェクトの構造把握、依存関係の分析、特定パターンの検索

たとえば、フルスタックのWebアプリケーション開発で、フロントエンド・バックエンド・データベース設計をClaude Codeに指示しながら進めることで、従来の開発スピードと比較して3〜5倍の生産性向上を実現している企業も増えています。

インストールと初期設定

Claude Codeの導入は非常にシンプルです。Node.js環境があれば、数分で使い始められます。

前提条件

• Node.js 18以上がインストールされていること
• Anthropicアカウント（APIキー or MAXプラン契約）
• macOS、Linux、またはWSL2（Windows）

インストール手順

ターミナルを開いて、以下のコマンドを実行します。

npm install -g @anthropic-ai/claude-code

インストール完了後、プロジェクトディレクトリに移動してClaude Codeを起動します。

cd your-project-directory
claude

初回起動時にAnthropicアカウントとの認証が求められます。ブラウザが自動的に開くので、ログインして認証を完了してください。

料金プランの選択

Claude Codeの利用には2つの選択肢があります。

毎日の開発で大量のトークンを消費する場合、API従量課金だと月額$500〜$1,000相当になることもあります。日常的にClaude Codeを使う開発者にはMAXプランを強く推奨します。

CLAUDE.mdによるプロジェクト設定

Claude Codeの最も重要な設定ファイルが CLAUDE.md です。プロジェクトルートに配置することで、Claude Codeにプロジェクト固有のコンテキストを与えられます。

# プロジェクト仕様

## 技術スタック
- Next.js 15 (App Router)
- TypeScript 5.x
- Tailwind CSS
- Supabase (PostgreSQL)

## コーディング規約
- コンポーネントはfunctional componentのみ使用
- 状態管理はReact Server Componentsを優先
- APIルートは/app/api/配下に配置
- 日本語コメントを推奨

## ディレクトリ構造
- /app - ページとAPIルート
- /components - 共通コンポーネント
- /lib - ユーティリティ関数
- /types - 型定義

CLAUDE.mdに記述した内容は、Claude Codeが毎回の会話で自動的に読み込みます。プロジェクトの技術スタック、コーディング規約、ディレクトリ構造、注意事項を記載しておくことで、指示のたびに前提を説明する手間が省けます。

ターミナルでの基本操作

Claude Codeの操作は、ターミナル上での自然言語によるチャットが基本です。コマンド体系を覚える必要はなく、やりたいことを日本語で伝えるだけで作業が進みます。

基本的な指示の出し方

Claude Codeを起動したら、プロンプトに自然言語で指示を入力します。

> このプロジェクトの構造を説明して

> src/components/Header.tsxを修正して、ナビゲーションにドロップダウンメニューを追加して

> 直近のgit diffを確認して、変更内容をまとめてコミットして

Claude Codeはファイル操作やコマンド実行を行う前に、許可を求めてきます。内容を確認して y で承認するか、n で拒否するかを選べます。安全に使いたい場合はこの承認フローをそのまま使い、信頼できる作業なら --dangerously-skip-permissions オプションで自動承認も可能です。

スラッシュコマンド

Claude Codeにはいくつかの便利なスラッシュコマンドがあります。

特に /compact は長時間のセッションで重要です。会話が長くなるとコンテキストウィンドウが圧迫され、Claude Codeの応答精度が下がります。定期的に /compact を実行して会話を圧縮することで、精度を維持しながら作業を続けられます。

ヘッドレスモード（自動化）

Claude Codeは -p フラグでヘッドレスモード（非対話型）で実行できます。CI/CDパイプラインやスクリプトに組み込む際に便利です。

claude -p "package.jsonの依存関係を確認して、セキュリティ脆弱性のあるパッケージを一覧にして"

たとえば、MarkdownからHTMLへの一括変換や、CMS APIへの記事公開処理をClaude Codeのヘッドレスモードで自動化するといった活用が可能です。大量のコンテンツ資産を管理する上で、手作業では到底追いつかない処理をClaude Codeに任せることで、コンテンツ運用の効率が飛躍的に向上します。

MCP連携で開発を拡張する

Claude Codeの真価は、MCP（Model Context Protocol）による外部サービス連携にあります。MCPは、AIエージェントが外部ツールやデータソースにアクセスするための標準プロトコルで、Claude Codeはこれにネイティブ対応しています。

MCPの仕組み

MCPは「AIのUSBポート」と表現されることがあります。USBポートにマウスやキーボードを差し込むように、MCPサーバーをClaude Codeに接続することで、Slack・Notion・HubSpot・GitHub・freee等の外部サービスをAIが直接操作できるようになります。

AIエージェントの概念と企業活用でも解説しているとおり、AIエージェントの価値は「外部ツールを操作できること」にあります。MCPはその接続を標準化した仕組みです。

MCP設定の方法

Claude Codeの設定ファイル（~/.claude/settings.json またはプロジェクトの .claude/settings.json）にMCPサーバーを登録します。

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token"
      }
    },
    "notion": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-notion"],
      "env": {
        "NOTION_API_KEY": "your-notion-key"
      }
    }
  }
}

実践で使えるMCP連携例

以下は、実務で特に効果的なMCP連携の例です。

HubSpot MCP: CRMのコンタクト情報・商談データをClaude Codeから直接取得し、営業提案資料の自動生成に活用できます。「HubSpotからDeal ID 12345の情報を取得して、提案資料のテンプレートに反映して」のように指示するだけで、CRMデータを含む資料が自動生成されます。

Slack MCP: Slackチャンネルのメッセージ検索、投稿、スレッドの読み取りをClaude Codeから操作できます。「#devチャンネルで直近1週間のエラー報告を要約して」のような使い方が可能です。

会計ソフトMCP: 会計データの取得・分析をClaude Codeから実行できます。「今月の売上実績と先月比を出して」と指示するだけで、APIからデータを取得して集計します。

Notion MCP: プロジェクトドキュメントの検索・更新をClaude Codeから行えます。タスクの進捗更新やドキュメントの自動生成に活用できます。

MCPによって、Claude Codeは「コードを書くだけのツール」から「業務プロセス全体を支援するエージェント」へと進化します。開発者以外のビジネスパーソンにとっても、MCPを設定すれば日常業務の自動化に活用できるのがClaude Codeの大きな魅力です。

実践的な開発ワークフロー

Claude Codeを最大限に活用するには、単発の指示ではなく、一連の開発フローとして組み込むことが重要です。ここでは実践で効果が高いワークフローを紹介します。

ワークフロー1: 機能実装の流れ

1. 要件をCLAUDE.mdまたは会話で共有
2. Claude Codeにコードベースを分析させる
3. 実装方針のすり合わせ（Claude Codeが提案 → 人間が判断）
4. Claude Codeが実装を開始（ファイル作成・編集・テスト）
5. 動作確認（人間がブラウザで確認）
6. 修正点をフィードバック
7. Claude Codeがgit commit → PR作成

ポイントは「3. 実装方針のすり合わせ」です。いきなり「実装して」と指示するのではなく、まず方針を提案させ、人間が判断してからGOを出すことで、手戻りを大幅に減らせます。

ワークフロー2: バグ修正の流れ

1. エラーメッセージまたは再現手順をClaude Codeに共有
2. Claude Codeがコードベースを調査（grep、ファイル読み取り）
3. 原因の特定と修正案の提示
4. 人間が確認してOKなら修正を実行
5. テストを実行して修正を検証

Claude Codeはエラーメッセージからの原因特定が非常に得意です。ブラウザのコンソールエラーやサーバーログをそのまま貼り付けるだけで、関連するファイルを自動で探索し、修正案を提示してくれます。

ワークフロー3: コードレビューの流れ

1. PRのdiff内容をClaude Codeに渡す
2. セキュリティ・パフォーマンス・可読性の観点でレビュー
3. 改善案を具体的なコード付きで提案

PRを作成した後にClaude Codeでセルフレビューを行い、明らかな問題を事前に潰す運用が効果的です。これにより、人間によるレビューの負担が軽減され、レビュー品質も向上します。

生産性を最大化するTips

指示は具体的に: 「いい感じにして」ではなく「レスポンシブ対応でブレークポイントは768pxと1024pxで、モバイルではハンバーガーメニューにして」のように具体的に指示するほど精度が上がります。

コンテキストを与える: CLAUDE.mdに技術スタックや規約を書いておくのはもちろん、関連する設計ドキュメントや参考URLを会話中に渡すことで、的確な実装につながります。

段階的に進める: 大きな機能は一度に実装させず、「まずデータモデルを設計して」「次にAPIルートを実装して」「最後にフロントエンドを作って」と段階的に進めると、品質が安定します。

/compactを活用する: 長時間の開発セッションでは30〜60分ごとに /compact を実行して、コンテキストウィンドウを最適化します。

Claude Codeを使う際の注意点

Claude Codeは強力なツールですが、適切に使わないとトラブルの原因になります。実際の開発現場で得られた教訓をもとに、注意点を解説します。

セキュリティに関する注意

Claude Codeはローカルファイルへのアクセス権限を持ちます。以下の点に注意してください。

• .envファイルや認証情報が含まれるファイルをgit commitさせない（CLAUDE.mdに「.envはコミットしないこと」と明記しておく）
• 本番環境への直接操作は避け、開発環境・ステージング環境で作業する
• --dangerously-skip-permissionsは信頼できる作業でのみ使用する

コスト管理

API従量課金の場合、大規模なコードベースの分析で予想以上にトークンを消費することがあります。

• /costコマンドで定期的にトークン使用量を確認する
• 大規模な分析は対象ディレクトリを絞って指示する（「src/components/配下だけ分析して」）
• 毎日使う場合はMAXプランへの切り替えを検討する

品質の担保

AIが生成したコードをそのまま本番に出すのはリスクがあります。

• Claude Codeの実装結果は必ず人間がレビューする
• テストの自動実行をワークフローに組み込む
• 「動いているからOK」ではなく、エッジケースやエラーハンドリングも確認する

Claude Codeが生成したコードに対して、必ず手動でのブラウザ確認とテスト実行を行うことが重要です。AIの生産性向上と人間による品質担保のバランスが、AI駆動開発を成功させるポイントです。

よくある質問

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

Claude Code自体のインストールは無料です。ただし、利用にはAnthropicのAPIキー（従量課金）またはClaude MAXプラン（月額$100〜$200）が必要です。API従量課金の場合、1時間の開発セッションで$5〜$15程度のコストが目安です。

Q. プログラミング初心者でも使えますか？

基本的なターミナル操作（cd、ls等）とNode.jsのインストールができれば、Claude Codeの導入自体は可能です。ただし、生成されたコードの妥当性を判断するためには、プログラミングの基礎知識があるほうが安全に使えます。プログラミング未経験の方は、まずCursorやBolt.newなどGUIベースのツールから始めることを推奨します。

Q. CursorやWindsurfとどちらを選ぶべきですか？

両方を併用するのがおすすめです。Claude Codeは大規模なリファクタリング、複数ファイルにまたがる実装、Git操作、MCP連携が得意です。Cursorはコード補完やファイル単位の編集が直感的です。普段の細かい修正はVSCodeで行い、大きな機能実装やリファクタリングはClaude Codeで行うという使い分けが効果的です。

Q. Claude CodeでMCPを使うには何が必要ですか？

MCPサーバーの設定と、接続先サービスのAPIキーが必要です。SlackならSlack Bot Token、NotionならNotion API Key、HubSpotならHubSpot Private App Tokenといった具合です。設定ファイル（settings.json）にMCPサーバーの情報を記述すれば、Claude Codeの起動時に自動で接続されます。

Q. チーム開発でClaude Codeを使う際のベストプラクティスは？

CLAUDE.mdをGitリポジトリにコミットし、チーム全員で共有するのが基本です。コーディング規約・ディレクトリ構造・禁止事項をCLAUDE.mdに記載しておくことで、誰がClaude Codeを使っても一貫したコードが生成されます。また、Claude Codeが作成したPRには必ず人間のレビューを挟むルールを設けることを推奨します。

まとめ：AI駆動開発を始めよう

Claude Codeは、ターミナルから直接AIと対話しながら開発を進められる画期的なツールです。ファイル操作、コマンド実行、Git操作、MCP連携による外部サービスとの統合まで、開発ワークフロー全体をAIが支援します。

プロダクト開発からコンテンツ管理、営業資料の自動生成まで、幅広い業務でClaude Codeは活用できます。

AI駆動開発に取り組むことで、少人数でも大きな成果を出すことが可能です。まずはClaude Codeをインストールして、小さなプロジェクトから試してみてください。

株式会社StartLinkでは、Claude CodeやHubSpotを活用したAI駆動の業務改革を支援しています。CRM導入からAI活用戦略まで、一気通貫でサポートいたします。

AI駆動開発の導入やCRM戦略についてご相談がございましたら、お気軽にStartLink公式サイトよりお問い合わせください。