Claude Codeの使い方を完全解説！インストールから料金・MCP連携まで

こんにちは。Osukeラーニング、おーすけです。

「Claude Codeって聞いたけど、具体的にどう使うの？」という疑問をお持ちの方へ。Claude Codeは、普通のチャットAIとは全く違う「自律型エージェント」として動き、コードの作成・編集・テスト・コミットまで一貫してこなしてくれるツールです。自然言語で「この機能を追加して」と言うだけで、プロジェクト全体を理解した上で複数ファイルを自動修正してくれます。この記事では、インストールから基本操作、料金プランの選び方、MCPによる外部連携まで、実践的な使い方を丁寧に解説します。

• Claude Codeの基本的な仕組みと従来AIとの違い
• インストール・初期設定から実際の使い方まで
• スラッシュコマンドとCLAUDE.mdによる効率化
• 料金プランの選び方・MCP連携・Cursorとの使い分け

Claude Codeの使い方を基礎から覚えよう｜インストールと初期設定

まずはClaude Codeがどんなツールなのかを正確に理解し、実際に使えるまでの環境構築を丁寧に解説します。最初の一歩を正しく踏み出すことが、快適な活用の土台になります。

Claude Codeとは何か？従来のAIツールとの決定的な違い

Claude CodeはAnthropic社が開発した「エージェント型AIコーディングツール」です。ChatGPTやClaude.aiのようなチャット型AIと根本的に異なる点は、「自律的に行動する」ことです。チャット型AIが「質問に答えるだけ」なのに対して、Claude Codeはローカルのファイルシステムを直接読み書きし、ターミナルコマンドを実行し、テストを走らせ、Gitコミットまで一気通貫でこなします。

具体的な違いを例で説明すると、「ログイン機能を実装して」と依頼した場合、チャット型AIはコードのサンプルを提案するだけです。Claude Codeは、プロジェクト全体の構造を読み取ってから、認証ロジックのファイルを作成し、ルーティングを更新し、テストを追加して、バグがあれば自分で修正するまでを自律的に実行します。開発者の役割は「どう作るか」を考えることから、「何を作るか」を指示してAIの出力をレビューすることへ変わります。

エージェント型のツールが従来と最も異なるのは「ループ構造」です。Claude Codeは①情報収集（コードベースの探索）→②アクション実行（コード編集・コマンド実行）→③結果検証（テスト・ビルドログ確認）というループをタスク完了まで繰り返します。途中でエラーが出れば自分でエラー内容を読んで修正案を実行します。一度「お願い」したら手放しで作業を進めてくれる、これが最大の特徴です。ターミナルベースのCLIツールなので、VS CodeやJetBrainsなど好みのエディタと並行して使えます。

インストールから起動まで：環境構築の完全手順

Claude CodeはNode.js環境で動くCLIツールです。インストールはシンプルで、基本的にnpmコマンド1行で完了します。インストールの前提条件として、Node.js（バージョン18以上を推奨）がインストールされていることを確認してください。ターミナルで`node –version`を実行して確認できます。Node.jsが入っていない場合はnodejs.orgの公式サイトからダウンロードしてください。

インストールのコマンドは`npm install -g @anthropic-ai/claude-code`です。これだけでClaude Codeがグローバルインストールされます。Windowsの場合はWingetから`winget upgrade Anthropic.ClaudeCode`でもインストールできます。Linuxではapt・dnf・apkなど主要パッケージマネージャーに対応しています。インストール後は作業したいプロジェクトのディレクトリに移動し、`claude`とだけ入力するとセッションが開始します。

初回起動時はブラウザが開いてAnthropicアカウントへのログインが求められます。アカウントはClaude ProまたはMaxのサブスクリプション、もしくはAnthropic ConsoleのAPIキーの3種類から選べます。個人開発者にはClaude Pro（月額20ドル）から始めるのが最もとっつきやすい方法です。ログインが完了すると認証情報がローカルに保存されるため、次回以降は`claude`コマンドを入力するだけで即座に作業を開始できます。アカウントを切り替えたい場合は`/login`コマンドをセッション内で実行します。

基本的な使い方：自然言語でコードを操作する感覚

Claude Codeが起動したら、普通の日本語（または英語）で指示を入力するだけです。コマンドの文法を覚える必要はありません。たとえば「src/components/Header.tsxのナビゲーションリンクにアクティブ状態のスタイルを追加して」と入力すると、Claude Codeはまず対象ファイルを読み取り、既存のコードを理解してから適切な変更を加えます。変更内容は実行前に「このように変更します。よろしいですか？」という形で確認を求めるため、意図せぬ変更が起きにくいです。

指示を出す際のコツは「具体的であること」です。「この機能を改善して」より「ユーザーがログアウトボタンをクリックしたとき、セッションを削除してトップページにリダイレクトする機能を追加して」の方が、期待通りの結果が得られます。複数ステップのタスクも一度に依頼できます。「認証機能を実装して。①JWTトークン生成②ミドルウェアで検証③ログアウト時にトークン無効化までお願い」というように、箇条書きで要件を整理して伝えると精度が上がります。

エラーが出たときや、AIが意図とは違う方向に進み始めたときは、Escキーで即座に実行を停止できます。2回連続で押すと直前の入力を修正できます。また、Plan Mode（Shift + Tab 2回）を使うと、実際のコード変更の前に「これから行う変更計画」だけを先に提示させることができます。複雑な変更の場合は先に計画を確認してから実行を許可する、というフローが安全で効率的です。ターミナルに画像をドラッグ＆ドロップすると、UIデザイン画像やエラースクリーンショットをAIに渡してコンテキストとして使えます。

スラッシュコマンド一覧：セッションを効率的に制御する

Claude Codeには、セッション内で使えるスラッシュコマンドが多数用意されています。これらを使いこなすことで、トークンの節約・作業の効率化・コスト管理が大幅に改善します。最もよく使うのは`/clear`と`/compact`です。`/clear`は会話履歴（コンテキスト）をリセットします。まったく別のタスクを始めるときや、前の作業が残っていてAIが混乱している場合に使います。`/compact`は会話履歴を要約してコンテキストを軽くします。セッションが長くなってトークン消費を抑えたいときに効果的です。

`/cost`コマンドは現在のセッションのトークン使用量とコストを表示します。使いすぎを防ぐのに役立ちます。`/model`コマンドでAIモデルを切り替えられます。普段はSonnet（速くてコスパ良い）で、複雑なアーキテクチャ設計のときだけOpus（最高精度）を使うという使い分けができます。`/init`コマンドはプロジェクトのルートで実行するとCLAUDE.mdを自動生成してくれます。`/review`コマンドは指定したプルリクエストや差分のコードレビューを依頼できます。

`/pause`と`/resume`はセッションの一時停止・再開に使います。大きなタスクを途中で中断してから翌日続きを再開する場合に便利です。`/mcp`コマンドはMCPサーバーの状態確認と管理ができます。`/help`は利用可能な全コマンドのヘルプを表示するので、「このコマンドなんだっけ」というときに使います。タブキーはファイル名やコマンドの自動補完に対応しており、長いファイルパスを手入力する手間を省けます。これらのショートカットを組み合わせることで、日々の作業の速度と快適さが体感として変わります。

CLAUDE.mdでプロジェクトを賢くするカスタマイズ術

Claude Codeをプロジェクトの真のパートナーにするために欠かせないのがCLAUDE.mdファイルです。これはプロジェクトのルートディレクトリに置くマークダウンファイルで、Claude Codeが起動時に自動的に読み込む「プロジェクトの憲法」として機能します。このファイルに書いた情報はすべてのセッションでAIの前提知識になるため、毎回同じ説明を繰り返す手間がなくなります。

CLAUDE.mdに書くべき内容は以下の通りです。①プロジェクト概要と使用技術（言語・フレームワーク・主要ライブラリ）、②コーディングスタイルの規約（インデントはタブかスペースか、命名規則、好みのデザインパターンなど）、③ビルド・テスト・リントのコマンド（npm testやmake buildなど）、④避けるべきアンチパターン（プロジェクトで禁止しているライブラリや過去に問題になった手法）、⑤PRレビュー前のチェックリスト。このファイルを丁寧に書くと、Claude Codeが「プロジェクトの事情をよく知る熟練の開発者」のように振る舞うようになります。

CLAUDE.mdの初期作成は`/init`コマンドで自動生成できます。AIがプロジェクトを分析して雛形を作ってくれるため、それを手で編集していく形が効率的です。モノレポ構成の場合は、ルートに共通規約のCLAUDE.mdを置き、各サブディレクトリにモジュール固有のCLAUDE.mdを置くことで、上位と下位のルールを組み合わせて適用させることができます。CLAUDE.mdはプロジェクトと一緒に進化させるドキュメントなので、新しいルールや知見が増えたら随時追記していく習慣を持つと、使えば使うほど精度が上がっていきます。

Claude Codeの使い方を深める｜料金・MCP連携・Cursorとの比較

基本操作を覚えたら、次は料金プランの最適化・外部ツールとの連携・他ツールとの使い分けという「もっと使いこなすための知識」を押さえましょう。

料金プランの選び方：Pro・Max・APIの使い分けガイド

Claude Codeの利用には大きく「サブスクリプション」と「API利用（従量課金）」の2系統があります。個人開発者の大半はサブスクリプションが最もコスパが良く、Claude Pro（月額20ドル・約3,000円）から始めるのが王道です。Proプランは1回の5時間枠でおよそ45通程度のメッセージが可能で、集中した作業だと数時間で到達することもあります。「試しに使ってみたい」「週に数回コードの相談をしたい」レベルの利用に適しています。

毎日ガッツリAIを使う本格的な開発者にはClaude Max 5x（月額100ドル・約15,000円）がおすすめです。Proの5倍の使用枠があり、フルに毎日使っても余裕があります。さらにヘビーに使う場合はClaude Max 20x（月額200ドル）でProの20倍の枠を確保できます。大規模なリファクタリングや自動化ワークフローを常時動かす場合はMaxプランが圧倒的にお得です。APIを直接使って全速力で作業した場合、月のコストが15,000ドル以上に達することもあるため、Max 20xが1/70以下のコストになる計算です。

API利用（従量課金）はAnthropicConsoleのAPIキーで利用する形式で、CI/CDパイプラインや自動化スクリプトでの活用に適しています。Sonnet 4.6の場合、100万入力トークンあたり3ドル・100万出力トークンあたり15ドルというレートです。プロンプトキャッシュを活用すると同じコードベースを繰り返し読み込む際に最大90%割引になるため、大規模プロジェクトでも経済的に使えます。自分の開発スタイルを振り返り「週に何時間AIを使うか」で最適プランを判断してください。

MCPで外部ツールと連携：GitHub・Slack・ブラウザ操作

Claude Codeの能力をローカル環境の外に拡張する鍵が「MCP（Model Context Protocol）」です。MCPはAIツールと外部データソース・サービスを繋ぐ標準規格で、Claude Codeをハブとしてあらゆるツールを統合できます。MCPサーバーを追加することで、自然言語の指示だけで外部ツールを操作できるようになります。たとえばGitHub Issuesと連携すると「チケット#123の内容でバグ修正して、完了したらコメントを投稿して」という指示が通ります。Slack連携ではチームへの通知やDMの送信もできます。

開発者に特に便利なMCP連携の例をいくつか挙げます。Playwright連携では、ブラウザを実際に起動してWebアプリを操作し、表示崩れのチェックやE2Eテストの自動生成ができます。Google Drive・Docs・Sheets連携では設計ドキュメントをAIに読ませたり、テスト結果をスプレッドシートに書き込んだりが自然言語で完結します。Web検索（Serena）連携では、開発中に直面した未知ライブラリのエラーをリアルタイムで検索して解決策を見つけ、コードに反映するまでを自動で行います。

MCPサーバーの追加は`claude mcp add`コマンドで行います。Playwrightなら`claude mcp add playwright -s project — npx -y @playwright/mcp@latest`です。設定はプロジェクトごとの`.mcp.json`やユーザー共通の`~/.claude.json`に保存されます。上級者向けの活用法として、Claude Code同士を複数連携させる「多段エージェント構成」があります。リーダーエージェントが複数の専門エージェントに指示を出してドキュメント一括生成や全ファイルリファクタリングをこなす、というSF的なワークフローが実現できます。MCPの公式レジストリから様々なサーバーを探して試してみることをおすすめします。

Cursorとの比較と最強の併用ワークフロー

AIコーディングツールの分野でClaude Codeの最大のライバルと言われるのが「Cursor」です。CursorはVS CodeベースのIDEに強力なAI補完が統合されており、インライン編集やリアルタイム補完の快適さが魅力です。Claude Codeとの最大の違いは「複数ファイルにまたがる自律的な大規模変更が得意かどうか」にあります。Claude Codeはプロジェクト全体を深く広く読み取り、長時間かかる大規模タスクを自律的に完遂します。Cursorは今開いているファイルを重視した効率的な節約型で、ちょっとした補完や細かい修正を素早く行う日常的な作業に光ります。

専門家が推奨する最強のワークフローは「Cursorで日常・Claude Codeで大規模」という役割分担の明確な併用です。新機能のアーキテクチャ設計や複数ファイルにまたがる大規模な実装はClaude Codeに任せ、その土台の上で変数名の変更・細かなロジック調整・CSSの微調整はCursorのTab補完とインライン編集で快適に作業します。複雑なバグでどこに原因があるか分からない場合はClaude Codeにプロジェクト全体をスキャンさせ、変更後のコードレビューやGitコミットもClaude Codeに依頼します。

コスト面では、Cursorはクレジットベースで日常の補完ツールとして使う分はコスパが良い反面、Claude Codeはメッセージ数ベースで重い作業ほどコストがかかります。「軽い補完はCursor・重い自動化はClaude Code」という棲み分けを意識すると、両方のツールのコストを抑えながら最大の生産性を得られます。この組み合わせにより、個人の開発能力をチーム数人分にまで引き上げることが現実的に可能です。

安全な運用のためのセキュリティと注意事項

Claude Codeはファイルシステムへのフルアクセス権限を持って動作するため、強力さゆえのリスクを理解しておく必要があります。まず「機密情報の漏洩リスク」です。.envファイルやAPIキーが書かれたファイルをAIが読み込んで、それをコンテキストとしてサーバーに送信してしまうリスクがあります。対策として`.claudeignore`ファイルや`permission.deny`設定で、機密ファイルの読み取りを明示的に禁止しましょう。.gitignoreに倣って機密ファイルを除外するパターンを設定しておくのが基本です。

次に「破壊的なコマンドの実行リスク」です。AIが誤って`rm -rf`のような致命的なコマンドを提案したり、不完全なコードで本番データベースを操作するリスクがあります。`npm install`・`sudo`・`git push`などの重要な操作については必ず自動承認をオフにして、人間が目視で確認してから実行するよう設定してください。また、AIが「修正しました」と報告しながら実際にはファイルを書き換えていないケースや、既存の機能を意図せず壊してしまうケースもあります。AIが生成したコードは「常にバグや脆弱性を含んでいる可能性がある」という前提でレビューし、自動テストでの検証を必須にしましょう。

使用制限（レートリミット）にも注意が必要です。Proプランでも大規模なリファクタリングを行うと数十分〜数時間で「5時間待ち」の状態になることがあります。長い作業を中断させないために、タスクを細分化し、こまめに`/clear`でコンテキストをリフレッシュする工夫が効果的です。また、VPN経由でのアクセスや不自然な大量リクエストはアカウント停止のリスクがあるため、利用規約をしっかり確認した上で適切に使いましょう。AIを信頼しつつも最終的な判断と責任は自分が持つ、という姿勢が安全な運用の基本です。

Claude Codeの使い方まとめと今後の活用ステップ

Claude Codeの使い方を総まとめします。基本的な流れは「①プロジェクトディレクトリで`claude`を起動→②自然言語で具体的に指示→③Plan Modeで確認→④実行を承認→⑤結果をレビュー」です。この流れをスムーズにするために、CLAUDE.mdでプロジェクトの規約をAIに事前共有し、スラッシュコマンドでセッションを管理する習慣を付けましょう。`/clear`でコンテキストをリフレッシュし、`/compact`でトークン節約をしながら、`/cost`でコストを可視化することで、効率よく費用を管理できます。

料金プランはまずPro（月額約3,000円）から試して、毎日フルで使いたくなったらMaxへのアップグレードを検討してください。CursorやGitHub Copilotなどの他ツールとの併用は「大規模・複雑＝Claude Code」「細かい補完・日常＝Cursor」という役割分担で使い分けると、コストとパフォーマンスのバランスが最適化されます。MCPを活用して外部ツールと連携させると、コードを書くだけでなくチームへの通知やドキュメント更新まで自動化できる領域が広がります。

Claude Codeは使い始めてから理解が深まるツールです。最初は小さなタスク（既存コードのリファクタリングや単純なバグ修正）から試して感覚を掴み、慣れてきたら機能の新規実装や大規模なアーキテクチャ変更にも挑戦してみてください。CLAUDE.mdを育て続け、自分のプロジェクトに最適化されたAIエージェントを作り上げていくプロセスは、開発の効率化と同時に「AIとの協業」という新しい働き方を体験することでもあります。最新情報は公式ドキュメントでご確認ください。Claude Codeとともに、あなたの開発生産性を次のレベルへ引き上げてみてください。