Claude Codeインストール完全ガイド｜3分で環境構築する全手順

Anthropic社が開発したターミナルベースのAIコーディングツール「Claude Code」。その性能の高さから多くのエンジニアに注目されていますが、「インストール方法がよくわからない」「環境構築でつまずいた」という声も少なくありません。

本記事では、Claude Codeのインストールから初回起動までの全手順を、Windows・Mac・Linux別に徹底解説します。プログラミング初心者でも確実に環境構築できるよう、各ステップを丁寧に説明します。

Claude Codeインストール前に確認すべき必要環境

Claude Codeをインストールする前に、まず自分の環境が要件を満たしているか確認しましょう。必要な環境を事前に把握しておくことで、インストール中のトラブルを防げます。

Claude Codeが動作するために必要な最低要件は以下のとおりです。最も重要なのがNode.jsのバージョンで、18以上が必須となっています。古いバージョンのNode.jsでは動作しないため、まずバージョンを確認してください。

ターミナル（コマンドプロンプト）でnode --versionと入力することで現在のバージョンを確認できます。v18.0.0以上が表示されれば問題ありません。v16以下が表示された場合、またはNode.jsが未インストールの場合は次のセクションの手順でインストールを行ってください。

また、Claude Codeを利用するにはAnthropicのアカウントが必要です。Claude ProまたはMax Planへの加入が必要で、無料プランではClaude Codeを利用できません。事前にanthropic.comでアカウントを作成し、有料プランに加入しておくとスムーズに進められます。

インターネット接続も必須です。Claude Codeはすべての処理をAnthropicのサーバー上で行うため、安定したインターネット接続が必要です。オフライン環境では利用できません。

項目	要件	確認コマンド
Node.js	18.0.0以上	`node --version`
npm	8.0.0以上	`npm --version`
OS	macOS 12+、Windows 10+、Ubuntu 20.04+	—
インターネット	常時接続が必要	—
Anthropicアカウント	Pro/Max Plan加入が必要	anthropic.com
ターミナル	bash/zsh/PowerShell対応	—

Node.jsのインストール方法（Windows・Mac・Linux別解説）

Node.jsが未インストール、またはバージョンが古い場合は、まずNode.jsのセットアップから始めます。OSによってインストール方法が異なりますので、ご自身の環境に合わせた手順をご確認ください。

Macの場合

Macでは、Homebrewを使ったインストールが最も簡単です。Homebrewが未インストールの場合は、公式サイトの手順に従ってHomebrewをインストールしてから、ターミナルでbrew install nodeを実行します。インストール完了後、node --versionでバージョンを確認してください。

複数のNode.jsバージョンを管理する必要がある場合は、nvmの利用が推奨されます。curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bashでnvmをインストールし、nvm install 20で最新のLTSバージョンをインストールできます。

Windowsの場合

Windowsでは、Node.js公式サイトからLTS版のインストーラをダウンロードして実行するのが最も確実です。インストーラの指示に従って進めるだけで、Node.jsとnpmが自動的にセットアップされます。インストール後はコマンドプロンプトを再起動してからnode --versionで確認してください。

Windows Subsystem for Linux（WSL2）を使用している場合は、Linux向けの手順が適用されます。WSL2環境ではLinuxと同様のコマンドが使えるため、後述のLinux向け手順を参照してください。

Linuxの場合

Ubuntuなどのdebian系ディストリビューションでは、aptを使ってインストールできます。curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -でリポジトリを追加し、sudo apt-get install -y nodejsでインストールを実行します。インストール後はnode --versionとnpm --versionで正常にインストールされたことを確認してください。

Claude CodeをnpmでインストールするOS別の手順

Node.jsの準備が整ったら、いよいよClaude Code本体のインストールです。インストールはnpmの1コマンドで完了するシンプルな手順です。

ターミナル（WindowsはコマンドプロンプトまたはPowerShell）を開き、以下のコマンドを実行します。

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

-gオプションはグローバルインストールを意味し、システム全体でclaudeコマンドが使えるようになります。インストールには数十秒から数分かかる場合があります。

インストール完了後、以下のコマンドでインストールが成功したことを確認します。

claude --version

バージョン番号が表示されれば、インストールは成功です。

よくあるエラーと対処法

MacでEACCES: permission deniedエラーが表示された場合は、npmのグローバルディレクトリの権限が問題です。sudo npm install -g @anthropic-ai/claude-codeでsudoを使ってインストールするか、nvmを使用してnpmのディレクトリを変更してください。

Windowsでcommand not foundと表示された場合は、環境変数のPATHにnpmのグローバルインストールディレクトリが追加されていない可能性があります。コマンドプロンプトを管理者として実行するか、Windowsの環境変数設定からPATHを確認してください。

プロキシ環境下での利用では、npmのプロキシ設定が必要です。npm config set proxy http://proxy.example.com:8080でプロキシを設定することで、インストールが可能になります。

Anthropicアカウントの作成と認証設定

Claude Codeのインストールが完了したら、次はAnthropicアカウントとの認証設定です。この手順はワンタイムで、一度設定すれば以降は自動的に認証が行われます。

まず、anthropic.comにアクセスしてアカウントを作成します。すでにClaudeを利用したことがある場合は既存のアカウントが使えます。アカウント作成後、Claude ProまたはMax Planに加入してください。無料プランではClaude Codeを利用できないため、この手順は必須です。

認証の設定はターミナルでclaudeコマンドを実行するだけです。

claude

初回起動時、自動的にブラウザが開いてAnthropicのログインページが表示されます。アカウントのメールアドレスとパスワードを入力してログインすると、認証コードがターミナルに返ってきます。

認証が完了すると、~/.claude/ディレクトリに認証情報が保存されます。これにより、次回以降は認証なしですぐにClaude Codeが起動します。認証情報は自動的に更新されるため、定期的な再認証も不要です。

API Keyを使った認証方法もあります。Anthropicのダッシュボードで発行したAPIキーを、環境変数ANTHROPIC_API_KEYに設定する方法です。CI/CDパイプラインや自動化スクリプトでClaude Codeを使う場合に適しています。

export ANTHROPIC_API_KEY="sk-ant-..."

初回起動と動作確認の方法

認証設定が完了したら、Claude Codeを実際に起動して動作を確認しましょう。初回起動では、いくつかの確認事項が表示されます。

任意のディレクトリに移動し、claudeコマンドを実行します。起動が成功すると、対話型のプロンプトが表示され、Claude Codeとの会話が始まります。

動作確認として、まず簡単なコマンドを試してみましょう。プロンプトに「こんにちは。Claude Codeのバージョンを教えてください」と入力してください。Claude Codeが応答を返せば、インストールと認証は正常に完了しています。

次に、実際のコーディングタスクで動作を確認します。テスト用のディレクトリを作成し、そのディレクトリでClaude Codeを起動してください。「簡単なHello Worldのコードを生成してください」と指示することで、ファイル生成機能が正常に動作するかを確認できます。

Claude Codeはコードを生成する前に、ファイルへの書き込み許可を確認するメッセージを表示します。yを入力するか、Enterキーを押すことで承認されます。ファイルが正常に生成されれば、すべての機能が正常に動作しています。

ヘルプコマンドも確認しておきましょう。/helpと入力することで、利用可能なすべてのコマンドとその説明が表示されます。

CLAUDE.mdファイルで初期設定をカスタマイズする

インストールが完了したら、プロジェクトの設定ファイルを作成しましょう。CLAUDE.mdは、Claude Codeに対してプロジェクト固有の情報や指示を伝えるための重要なファイルです。

プロジェクトのルートディレクトリにCLAUDE.mdファイルを作成し、以下のような情報を記載します。このファイルはMarkdown形式で記述でき、Claude Codeはセッション開始時に自動的に読み込みます。

記載すべき情報としては、使用技術スタック（言語、フレームワーク、ライブラリのバージョン）、コーディング規約（命名規則、インデント幅、コメントスタイル）、テストの方針（使用するテストフレームワーク、カバレッジ目標）、注意事項（使用を避けるべきパターンや依存関係）などが挙げられます。

CLAUDE.mdを充実させることで、Claude Codeはプロジェクトの文脈を深く理解し、より精度の高いコードを生成できます。また、Claude Codeが不要なファイル探索を行わなくなり、トークン消費の削減にもつながります。

ユーザー全体の設定は~/.claude/CLAUDE.mdに記載できます。ここには個人のコーディングスタイルや好みの設定を記述することで、すべてのプロジェクトに共通のルールを適用できます。

設定ファイル	場所	適用範囲
プロジェクト設定	./CLAUDE.md	特定のプロジェクトのみ
ユーザー設定	~/.claude/CLAUDE.md	すべてのプロジェクト
環境変数	.env / シェル設定	システム全体
APIキー	ANTHROPIC_API_KEY	認証情報

インストール後によくあるトラブルと解決策

Claude Codeのインストール後、環境によってはいくつかのトラブルが発生することがあります。よくある問題とその解決策を事前に把握しておきましょう。

「claude: command not found」エラー

グローバルインストールは成功しているのにclaudeコマンドが認識されない場合、npmのグローバルパスが環境変数PATHに含まれていない可能性があります。npm config get prefixでnpmのグローバルディレクトリを確認し、そのパスに/binを追加したものをPATHに追加してください。Macでは~/.zshrcや~/.bash_profileにexport PATH="$PATH:$(npm config get prefix)/bin"を追記してシェルを再起動すると解決します。

認証エラー「Authentication failed」

API KeyまたはOAuth認証に問題がある場合に発生します。claude logoutでログアウトし、claudeを再実行して認証をやり直してください。APIキーを使用している場合は、キーが正しく設定されているか確認してください。

「Rate limit exceeded」エラー

使用量の上限に達した場合に表示されます。しばらく待ってから再試行するか、上位のプランにアップグレードすることで解決します。大量のファイルを一度に処理しようとしている場合は、タスクを小分けにすることも有効です。

プロキシ環境でのネットワークエラー

企業のプロキシ環境下では、特別な設定が必要な場合があります。HTTPS_PROXY環境変数にプロキシのURLを設定することで解決することが多いです。

インストール完了後の最初のコマンド実践

インストールと設定が完了したら、実際にClaude Codeを使ってみましょう。まずは簡単なタスクから始めることで、ツールの感触をつかむことができます。

最初に試したいのが、既存のコードの説明依頼です。手元にあるコードファイルが存在するディレクトリでClaude Codeを起動し、「このプロジェクトの構成を説明してください」と入力してみてください。Claude Codeがディレクトリ構造を解析し、プロジェクトの概要を分かりやすく説明してくれます。

次に、新しいファイルの生成を試してみましょう。「TodoアプリのシンプルなHTMLファイルを作成してください」と入力すると、HTML・CSS・JavaScriptを含む完全なファイルが生成されます。生成前に内容の確認を求められるので、内容を確認してから承認してください。

バグ修正の依頼も効果的な使い方です。エラーが発生しているコードをClaude Codeに見せ、「このエラーを修正してください」と伝えるだけで、問題の特定と修正コードの提案を行います。

Git操作の自動化も試してみましょう。/commitコマンドを入力すると、変更内容を自動分析して適切なコミットメッセージを生成してくれます。コミットメッセージを考える手間が省け、作業効率が大幅に向上します。

Claude Code活用のご支援は日本AI/DX総合研究所へ

Claude Codeのインストールと基本設定が完了すれば、AIコーディングの世界への第一歩を踏み出したことになります。しかし、Claude Codeのポテンシャルを最大限に引き出すには、適切な活用方法の習得と、プロジェクトに合わせた設定の最適化が必要です。

日本AI/DX総合研究所（aidx-soken.com）では、Claude Codeを駆使したホームページ制作・SEO対策サービスを提供しています。AIコーディングの専門知識を持つエンジニアが、従来の制作会社では実現できないスピードと品質でWebサイトを構築します。

「Claude Codeを使ってみたいけれどどう活用すればいいか分からない」「AIを活用して自社のWebサイトを作りたい」「SEOに強いサイトをコスト効率よく制作したい」といったご要望がある方は、ぜひご相談ください。AI導入支援から実際の開発・運用まで、一貫してサポートします。初回1時間のご相談は無料で承っております。