Claude Codeのインストールとセットアップ完全ガイド(2026年版)

macOS・Linux・WindowsへのClaude Codeインストール手順を徹底解説。ネイティブインストーラー・npm・Homebrew・認証・MCP設定・AnyCap連携まで完全網羅。

by AnyCap

開発者ターミナルに表示されたClaude Code CLIのインストール画面(ダークモニターに緑色の成功メッセージ)


Claude CodeはAnthropicが提供するターミナルベースのAIコーディングエージェントです。 コードベースを読み込み、実際のファイルを編集し、シェルコマンドを実行し、gitを管理する——すべてコマンドラインから行えます。ブラウザタブも、コピペも不要です。

このガイドでは、すべてのインストール方法(ネイティブ、npm、Homebrew)、認証、設定、そして最も重要な——インストール後に何をすべきかを解説します。Claude Codeを単なるコーディングアシスタントから、画像生成・動画・Web検索・クラウドストレージを備えたフルマルチモーダルエージェントへと変貌させる方法を紹介します。


前提条件

インストール前に以下を確認してください:

  • OS: macOS 13以降(Ventura)、Ubuntu 20.04以降 / Debian 10以降、またはWSL搭載のWindows 10(1809以降)
  • RAM: 最小4 GB、大規模コードベースには8 GB推奨
  • インターネット接続: AIの処理はすべてAnthropicのクラウドインフラで実行されます——接続なしではClaude Codeは動作しません
  • Anthropicアカウント: Claude Pro(月額$20)、Max(月額$100〜200)、Teams、Enterprise、またはConsole(API)アカウント。無料のClaude.aiプランはClaude Codeに対応していません。プランの選び方についてはClaude Code料金プラン比較をご覧ください。
  • ターミナル: Bash、Zsh、またはPowerShell
  • Node.js 18以降: npmインストール方法を使用する場合のみ必要

GPUは不要です。お使いのマシンは軽量CLIクライアントを実行するだけで、AIの計算処理はすべてサーバーサイドで行われます。


ステップ1: Node.jsのインストール(npmメソッドのみ)

ネイティブインストーラーを使用する場合——現在Anthropicが推奨する方法——このステップは完全にスキップできます。ネイティブインストーラーは依存関係がゼロです。

npmをご利用の方は、Nodeのバージョンを確認してください:

node --version

v18.0.0以上が表示された場合は、ステップ2に進んでください。それ以下の場合は、nvm(Node Version Manager)でインストールして権限エラーを回避しましょう:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

ターミナルを閉じて再度開いた後:

nvm install 22
nvm use 22
node --version  # Should show v22.x.x

Node.js 22は現在のLTSリリースで、Claude Codeと問題なく動作します。


ステップ2: Claude Codeのインストール

3つのインストール方法があります。1つを選んでください。

オプションA: ネイティブインストーラー(推奨)

依存関係ゼロ。バックグラウンドで自動更新。Anthropicが主にテストしサポートしている方法です。

macOSおよびLinux:

curl -fsSL https://claude.ai/install.sh | bash

Windows(PowerShell、管理者として実行):

irm https://claude.ai/install.ps1 | iex

インストーラーはclaudeバイナリをPATHに追加し、自動更新を設定します。開始から終了まで1分以内です。

オプションB: Homebrew(macOS / Linux)

brew install --cask claude-code

注意点:Homebrewでのインストールは自動更新されません。定期的にbrew upgrade claude-codeを実行してください。

オプションC: npm

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

sudoは使用しないでください。 EACCES権限エラーが発生した場合、解決策はnvmです——npmをrootで実行することではありません。rootが所有するnpmディレクトリは連鎖的な権限問題を引き起こします。

確認

インストールが成功したか確認します:

claude --version

完全な環境診断のために:

claude doctor

ステップ3: 認証

claude

初回起動時、Claude CodeはOAuth認証のためにブラウザを開きます。Anthropicアカウントにサインインし、CLIを承認すれば接続完了です。

認証オプション

ブラウザOAuth(デフォルト): 個人のマシンに最適。Pro、Max、Teams、Enterpriseアカウントに対応。承認後、セッショントークンがローカルに保存されます。

APIキー(CI/CDおよびヘッドレス環境): ブラウザが使用できないサーバー、コンテナ、パイプラインの場合:

export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude

キーはconsole.anthropic.comで生成してください。API使用はAnthropicの標準レートでトークンごとに課金されます。サブスクリプションとAPI課金の詳細な比較については、Claude Code料金ガイドをご覧ください。

どちらの課金モデルを選ぶ? サブスクリプション(Pro/Max)は日常使いにシンプルで、月額プランにClaude Codeが含まれます。API課金は変動的または自動化されたワークロードに対してきめ細かい制御が可能です。


ステップ4: 最初のClaude Codeセッション

任意のプロジェクトディレクトリに移動:

cd ~/my-project
claude

Claude Codeはプロジェクト構造を読み込み、インタラクティブなREPLを起動します。まずは低リスクなものから始めましょう:

> Explain the architecture of this project

ファイルをスキャンし、スタックを特定し、構造的な概要を提供します。次に実際の変更を伴うものを試してみましょう:

> Add input validation to the user registration form

Claude Codeは関連するファイルを特定し、変更を提案し、確認を待ちます。変更を受け入れる前にdiffビューで各変更を確認できます——ファイルを盲目的に上書きすることはありません。

インタラクティブモードに入らずに単発のタスクを実行するには、-p(print)フラグを使用します:

claude -p "Write unit tests for the auth module"

タスクを実行し、結果を出力して終了します。スクリプトやCI/CDパイプラインに最適です。


ステップ5: Claude Codeの設定

モデルの選択

Claude Codeはデフォルトで最新の利用可能なモデルを使用します。上書きするには:

# デフォルトモデルを設定
claude config set model claude-opus-4-7

# または単一セッションの場合
claude --model claude-sonnet-4-6

権限

Claude Codeはファイルの書き込みやコマンドの実行前に確認を求めます。特定のプロジェクトで信頼している場合:

claude config set permissions.auto-accept-edits true

スピード向上に役立ちます。本番コードを扱う場合はあまり適していません。すべての権限モード、サブエージェント、フックの詳細については、Claude Code高度な機能ガイドをご覧ください。

プロジェクトレベルの設定

チームで共有する設定(このファイルをコミット)のため、プロジェクトルートに.claude/settings.jsonを作成します:

{
  "permissions": {
    "allow": ["read", "write", "shell"],
    "deny": ["shell:rm -rf *"]
  },
  "model": "claude-sonnet-4-6",
  "environment": {
    "NODE_ENV": "development"
  }
}

コミットすべきでない個人的な上書き設定には、.claude/settings.local.jsonを使用します。

CLAUDE.md

最も影響力のある設定です。プロジェクトルートにCLAUDE.mdファイルを作成して、Claudeに永続的なコンテキストを提供します:ビルドコマンド、コーディング規約、アーキテクチャの決定事項。Claude Code内で/initを実行すると自動生成され、その後カスタマイズできます。

優れたCLAUDE.mdは簡潔です——50〜100行を目指してください。各行について「これを削除するとClaudeがミスをするか?」と問いかけてみましょう。そうでなければ、削除してください。


プラットフォーム別の手順

macOS

Apple Silicon(M1〜M4)とIntel Macの両方に対応しています。ネイティブインストーラーが最もクリーンな方法です:

curl -fsSL https://claude.ai/install.sh | bash

Linux

Ubuntu 20.04以降、Debian 10以降、およびほとんどの最新ディストリビューションで動作します。macOSと同じネイティブインストーラーを使用します。古いディストリビューションの場合は、nvmでnpmを使用してください。

Windows

オプション1: ネイティブPowerShellインストーラー

irm https://claude.ai/install.ps1 | iex

オプション2: WSL(完全なLinux互換性のために推奨)

wsl --install
# 再起動後、WSLターミナルで:
curl -fsSL https://claude.ai/install.sh | bash

Docker

FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code

実行時は、APIキーを環境変数として渡してください——イメージに組み込まないでください。

CI/CD(GitHub Actionsの例)

- name: AI Code Review
  run: |
    npx @anthropic-ai/claude-code -p "Review this PR for bugs" --output-format json
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

IDE統合

Claude Codeはターミナルファーストですが、IDEプラグインでネイティブのdiff表示が可能です。

VS Code: 拡張機能パネルから「Claude Code」をインストール、または:

code --install-extension anthropic.claude-code

JetBrains: 設定 → プラグイン → Marketplace → 「Claude Code」を検索 → インストール。変更はIDEのネイティブdiffビューアーに表示されます。


インストール後:Claude Codeにエージェント機能を追加する

ほとんどのセットアップガイドはここで終わります。Claude Codeはインストールされ、認証され、動作しています——しかし、基本CLIが提供できるもの(ファイル編集、シェルコマンド、git操作)に限定されています。

Claude Codeがデフォルトでできないこと:

  • 画像の生成または写真の編集
  • 動画の作成または分析
  • ライブWebの検索
  • クラウドストレージへのファイルの保存と取得
  • Webへのコンテンツの公開

これらの機能にはMCPサーバー(Model Context Protocol)が必要です。MCPはAIエージェントが外部ツールに接続できるオープンスタンダードです。Claude CodeはMCPをネイティブでサポートしており——サーバーを設定すると、Claudeが直接呼び出すことができます。完全なガイドについては、MCPでClaude Codeに機能を追加するガイドをご覧ください。

最速の方法:AnyCap Agent CLI

個々のMCPサーバーを1つずつ設定する代わりに、単一のCLIでClaude Codeにフルセットのエージェント機能を提供できます:

npx -y skills add anycap-ai/anycap -a claude-code

これによりAnyCap のエージェント機能ランタイムがインストールされ、Claude Codeが以下にアクセスできるようになります:

機能 内容
画像生成 テキストプロンプトから画像を作成・編集 「ランディングページのヒーロー画像を生成して」
動画生成 テキストや画像から動画を制作 「製品デモのウォークスルー動画を作成して」
Web検索 ライブインターネットを検索・クロール 「最新のAPI変更を調査して」
クラウドストレージ ファイルのアップロード、共有、取得 「プロジェクトのアセットを保存して共有リンクを生成して」
Web公開 コンテンツをWebに展開 「変更ログをWebページとして公開して」

1つのCLI。1つの認証フロー。すべての機能。 画像生成、動画、検索、ストレージのための個別のAPIキーを管理する必要はありません——AnyCap がシングルインストールですべてを処理します。MCP統合の詳細(手動サーバー設定オプションを含む)については、MCP機能ガイドをご覧ください。

手動MCP設定

MCPサーバーを個別に設定したい場合は、プロジェクトルートの.mcp.jsonに追加します:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"]
    }
  }
}

またはインタラクティブに追加します:

claude mcp add github -- npx -y @modelcontextprotocol/server-github
claude mcp list
claude mcp get github

トラブルシューティング

問題 解決策
「command not found: claude」 新しいターミナルウィンドウを開く。それでも解決しない場合は、インストーラーを再実行するかPATHを確認する。
Node.jsが古すぎる nvm install 22 && nvm use 22
npm EACCESエラー 絶対にsudoを使わない。nvmを使用する。
認証のためにブラウザが開かない APIキーを使用: export ANTHROPIC_API_KEY=sk-ant-...
インストール中のネットワークエラー プロキシ設定を確認。npmレジストリを設定: npm config set registry https://registry.npmjs.org/
Claude Codeの動作が遅い AnthropicのAPIへのネットワーク遅延。status.anthropic.comを確認。VPNが有効な場合は切断する。

手動デバッグに時間をかける前にclaude doctorを実行してください——ほとんどの設定問題を自動検出します。


Claude Codeを最新の状態に保つ

ネイティブインストーラー: 更新は自動的に行われます。操作不要。claude --versionでバージョンを確認できます。

npm: npm update -g @anthropic-ai/claude-code

Homebrew: brew upgrade claude-code


次のステップ

Claude Codeがインストールされました。次にやること:

  1. CLAUDE.mdを生成する — Claude Code内で/initを実行して、永続的なプロジェクトコンテキストを設定します。
  2. エージェント機能を追加する — AnyCap をインストールして、Claude Codeに画像生成、動画、検索、ストレージを追加します。MCP機能ガイドをご覧ください。
  3. 実際のタスクを試す — 通常20分かかる作業を選んで、Claudeがどう処理するか確認してみましょう。

関連記事

Claude Codeは、ツールを変えることなく開発ワークフローにAIを取り込む最速の方法です。一度セットアップすれば、その違いはすぐに実感できます。