SpyBara
Go Premium

setup.md 2026-09-17 05:00 UTC to 2026-09-18 23:58 UTC

This page contains 1 addition and 1 deletion.

2026
Wed 9 22:58 Thu 10 23:00 Sat 12 03:02 Fri 18 23:58

高度なセットアップ

Claude Code のシステム要件、プラットフォーム固有のインストール、バージョン管理、およびアンインストール。

このページでは、システム要件、プラットフォーム固有のインストール詳細、更新、およびアンインストールについて説明します。初回セッションのガイド付きウォークスルーについては、クイックスタートを参照してください。ターミナルを使用したことがない場合は、ターミナルガイドを参照してください。

システム要件

Claude Code は以下のプラットフォームと構成で実行されます。

  • オペレーティングシステム:
    • macOS 13.0 以上
    • Windows 10 1809 以上または Windows Server 2019 以上
    • Ubuntu 20.04 以上
    • Debian 10 以上
    • Alpine Linux 3.19 以上
  • ハードウェア: 4 GB 以上の RAM、x64 または ARM64 プロセッサ
  • ネットワーク: インターネット接続が必要です。ネットワーク構成を参照してください。
  • シェル: Bash、Zsh、PowerShell、または CMD。
  • 場所: Anthropic サポート対象国

追加の依存関係

Claude Code をインストール

Claude Code をインストールするには、以下のいずれかの方法を使用してください。

macOS、Linux、WSL:

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

Windows PowerShell:

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

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

The token '&&' is not a valid statement separator というエラーが表示される場合は、CMD ではなく PowerShell を使用しています。'irm' is not recognized as an internal or external command というエラーが表示される場合は、PowerShell ではなく CMD を使用しています。PowerShell を使用している場合、プロンプトに PS C:\ と表示され、CMD を使用している場合は PS なしで C:\ と表示されます。

インストールコマンドが syntax error near unexpected token '<'、403、またはその他の curl エラーで失敗する場合は、インストールのトラブルシューティングを参照して、エラーを修正方法に照合し、代替インストール方法を確認してください。

Git for Windows は、Claude Code が Bash ツールを使用できるようにネイティブ Windows で推奨されます。Git for Windows がインストールされていない場合、Claude Code はシェルツールとして PowerShell を代わりに使用します。WSL セットアップは Git for Windows を必要としません。

また、Debian、Fedora、RHEL、Alpine で apt、dnf、または apk を使用してインストールすることもできます。

インストールが完了したら、作業するプロジェクトでターミナルを開き、Claude Code を起動します。

claude

Claude Code はターミナルで対話的なセッションを開きます。

インストール中に問題が発生した場合は、インストールとログインのトラブルシューティングを参照してください。

Windows でのセットアップ

Claude Code をネイティブに Windows で実行することも、WSL 内で実行することもできます。プロジェクトの場所と必要な機能に基づいて選択してください。

オプション 必須 サンドボックス 使用時期
ネイティブ Windows なし;Git for Windowsはオプション サポートされていません Windows ネイティブプロジェクトとツール
WSL 2 WSL 2 有効 サポートされています Linux ツールチェーンまたはサンドボックス化されたコマンド実行
WSL 1 WSL 1 有効 サポートされていません WSL 2 が利用できない場合

オプション 1: ネイティブ Windows

PowerShell または CMD からインストールコマンドを実行します。管理者として実行する必要はありません。Git for Windowsをインストールすることはオプションです。これにより Git Bash が提供され、Bash ツールが有効になります。

PowerShell または CMD からインストールするかどうかは、実行するインストールコマンドにのみ影響します。プロンプトは PowerShell では PS C:\Users\YourName> と表示され、CMD では PS なしで C:\Users\YourName> と表示されます。ターミナルが初めての場合は、ターミナルガイドで各ステップを説明しています。

インストール後、任意のターミナルから claude を起動します。

  • Git for Windows がない場合、Claude Code はPowerShell ツール経由でシェルコマンドを実行します。

  • Git for Windows がある場合、Claude Code はBash ツールに Git Bash を使用します。Claude Code が Git Bash を見つけられない場合は、settings.json ファイルでパスを設定します。

    {
      "env": {
        "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
      }
    }
    

Git for Windows がインストールされている場合、PowerShell ツールは Bash と並行して利用可能です。claude.ai と Console アカウントではデフォルトで有効になっており、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry セッションでは CLAUDE_CODE_USE_POWERSHELL_TOOL=1 で有効になります。0 に設定してツールをオフにします。セットアップと制限については、PowerShell ツールを参照してください。

オプション 2: WSL

WSL ディストリビューションを開き、上記のインストール手順から Linux インストーラーを実行します。PowerShell または CMD からではなく、WSL ターミナル内で claude をインストールして起動します。

Alpine Linux と musl ベースのディストリビューション

Alpine およびその他の musl/uClibc ベースのディストリビューション上に Claude Code をインストールするには、インストールコマンド用に bash と curl が必要であり、実行時に libgcc、libstdc++、および ripgrep が必要です。Alpine はデフォルトで bash と curl を含まないため、ドキュメント化されたインストールコマンドは not found エラーで失敗します。これらをインストールするまで、ディストリビューションのパッケージマネージャーを使用してこれらのパッケージをインストールしてから、USE_BUILTIN_RIPGREP=0 を設定します。

この例は Alpine で必要なパッケージをインストールします。

apk add bash curl libgcc libstdc++ ripgrep

Alpine では、ripgrep はコミュニティリポジトリにあります。apk がパッケージが見つからないと報告する場合は、Alpine バージョンを使用して /etc/apk/repositories にコミュニティリポジトリを追加します。

echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories

apk update を実行してパッケージインデックスを更新し、apk add コマンドを再試行します。

次に、settings.jsonファイルで USE_BUILTIN_RIPGREP を 0 に設定します。

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

インストールを確認

インストール後、Claude Code が機能していることを確認します。

claude --version

正常にインストールされている場合は、2.1.211 (Claude Code) のようなバージョン番号が表示されます。

これが command not found または別のエラーで失敗する場合は、インストールとログインのトラブルシューティングを参照してください。

インストールと構成をより詳しく確認するには、claude doctorを実行します。

claude doctor

claude doctor は、セッションを開始せずに読み取り専用のインストールと設定の診断を出力します。これには、インストールの正常性、設定ファイルの検証エラー、および推奨される修正を含む警告が含まれます。

認証

Claude Code には、Pro、Max、Team、Enterprise、または Console アカウントが必要です。無料の claude.ai プランには Claude Code アクセスは含まれていません。Amazon Bedrock、Google Cloud の Agent Platform、またはMicrosoft Foundryなどのサードパーティ API プロバイダーで Claude Code を使用することもできます。

インストール後、claude を実行してブラウザーのプロンプトに従ってログインします。ANTHROPIC_API_KEY 環境変数が設定されている場合、Claude Code はブラウザーを開く代わりに、キーを承認するよう 1 回プロンプトを表示します。すべてのアカウントタイプとチームセットアップオプションについては、認証を参照してください。

Claude Code を更新

ネイティブインストールは自動的にバックグラウンドで更新されます。リリースチャネルを構成して、更新をすぐに受け取るか遅延安定スケジュールで受け取るかを制御することも、自動更新を完全に無効にすることもできます。Homebrew、WinGet、およびLinux パッケージマネージャーインストールは手動更新が必要です。

自動更新

Claude Code は起動時と実行中に定期的に更新をチェックします。更新はバックグラウンドでダウンロードおよびインストールされ、次に Claude Code を起動するときに有効になります。

claude doctor を実行して、最新の更新試行の結果を確認します。

macOS と Linux では、ネイティブインストーラーは ~/.local/bin/claude のランチャーを ~/.local/share/claude/versions/ へのシンボリックリンクとして管理します。そのランチャーを独自のスクリプトまたはシンボリックリンクに置き換えた場合、自動更新と claude update はそれをそのまま保持します。新しいバージョンは引き続き versions/ ディレクトリの下にインストールされ、ランチャーはどのバージョンを実行するかを決定します。v2.1.207 より前では、自動アップデーターは毎回の更新時にそのパスのカスタムランチャーを独自のシンボリックリンクに置き換えていました。

カスタムランチャーを使用する場合、Claude Code はランチャーがどのバージョンを必要とするかを判断できないため、インストール済みのすべてのバージョンをディスク上に保持します。claude doctor はネイティブインストーラーが作成しなかったランチャーを報告します。

Claude Code にランチャーを再度管理させるには、~/.local/bin/claude を削除して claude update を実行します。

npm グローバルインストールが npm グローバルディレクトリが書き込み可能でないため自動更新できない場合、Claude Code は起動時に 1 回限りの通知を表示し、claude doctor は利用可能な修正を一覧表示します。詳細については、インストール中の権限エラーを参照してください。

リリースチャネルを構成

autoUpdatesChannel 設定を使用して、Claude Code が自動更新と claude update に従うリリースチャネルを制御します。

  • "latest"、デフォルト: リリースされるとすぐに新機能を受け取ります
  • "stable": 通常約 1 週間前のバージョンを使用し、大きな回帰を伴うリリースをスキップします

これを /config → 自動更新チャネル経由で構成するか、settings.json ファイルに追加します。

{
  "autoUpdatesChannel": "stable"
}

エンタープライズデプロイメントの場合、管理設定を使用して、組織全体で一貫したリリースチャネルを適用できます。

Homebrew インストールは、この設定ではなく cask 名でチャネルを選択します。claude-code は安定版を追跡し、claude-code@latest は最新版を追跡します。

最小バージョンをピン留め

minimumVersion 設定は下限を確立します。バックグラウンド自動更新と claude update は、この値より下のバージョンのインストールを拒否するため、"stable" チャネルに移動しても、既に新しい "latest" ビルドを使用している場合はダウングレードされません。

/config 経由で "latest" から "stable" に切り替えると、現在のバージョンに留まるか、ダウングレードを許可するかを選択するよう求められます。留まることを選択すると、minimumVersion がそのバージョンに設定されます。"latest" に戻すと、それがクリアされます。

settings.json ファイルに追加して、下限を明示的にピン留めします。

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

管理設定では、これはユーザーおよびプロジェクト設定がオーバーライドできない組織全体の最小値を適用します。

minimumVersion ピンは更新のみを制約します。Claude Code がバージョン範囲外で起動することを拒否するようにするには、代わりに管理設定の requiredMinimumVersion と requiredMaximumVersion を使用します。更新は requiredMaximumVersion の上限も尊重します。requiredMinimumVersionとrequiredMaximumVersionを参照してください。

自動更新を無効にする

settings.jsonファイルの env キーで DISABLE_AUTOUPDATER を "1" に設定します。

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

ネイティブまたは npm インストールで、claude doctor を実行して変更が有効になったことを確認し、Auto-updates 行が enabled ではなく disabled (set by env: DISABLE_AUTOUPDATER) を表示していることを確認します。

DISABLE_AUTOUPDATER はバックグラウンドチェックのみを停止します。claude update と claude install は引き続き機能します。手動更新を含むすべての更新パスをブロックするには、代わりに DISABLE_UPDATESを設定します。独自のチャネルを通じて Claude Code を配布し、ユーザーが提供するバージョンに留まる必要がある場合に使用します。

手動で更新

次のバックグラウンドチェックを待たずに更新をすぐに適用するには、以下を実行します。

claude update

更新がインストールされると、コマンドは Successfully updated from <old version> to version <new version> を報告します。既に最新バージョンを使用している場合は、Claude Code is up to date (<version>) を報告します。Homebrew、WinGet、または apk で管理されるインストールは、代わりに Claude is up to date! を報告します。

高度なインストールオプション

これらのオプションは、バージョンピニング、Linux パッケージマネージャー、npm、およびバイナリ整合性の検証用です。

特定のバージョンをインストール

ネイティブインストーラーは、特定のバージョン番号またはリリースチャネル(latest または stable)を受け入れます。インストール時に選択したチャネルが自動更新のデフォルトになります。詳細については、リリースチャネルを構成を参照してください。

最新バージョンをインストールするには(デフォルト):

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

安定版をインストールするには:

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

特定のバージョン番号をインストールするには:

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

インストールされたバージョンを確認するには、claude --version を実行します。このコマンドは、2.1.89 (Claude Code) など、渡した正確なバージョンを出力します。

Linux パッケージマネージャーでのインストール

Claude Code は署名付き apt、dnf、および apk リポジトリを公開しています。各リポジトリは 2 つのチャネルを提供します。stable は通常約 1 週間前のバージョンを提供し、大きな回帰を伴うリリースをスキップします。latest はリリースが出荷されるとすぐにすべてのリリースを提供します。以下のコマンドは stable チャネルを構成します。これはほとんどのユーザーに適しています。各タブは latest リポジトリ URL も表示します。パッケージマネージャーのインストールは Claude Code を通じて自動更新されません。更新は通常のシステムアップグレードワークフローを通じて提供されます。

すべてのリポジトリは Claude Code リリース署名キーで署名されています。キーを信頼する前に、各タブで説明されているとおりに検証してください。

Debian および Ubuntu 用です。以下のインストールコマンドは curl で署名キーをダウンロードし、gpg で検証します。新しい Debian および Ubuntu インストールには curl と gpg が含まれていない場合があります。いずれかのコマンドが command not found を報告する場合は、まず両方をインストールしてください:

sudo apt install curl gnupg

署名キーをダウンロードします:

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
-o /etc/apt/keyrings/claude-code.asc

このダウンロードが失敗した場合、後で apt update が NO_PUBKEY BAA929FF1A7ECACE で失敗します。キーがダウンロードされ、Anthropic に属していることを確認してから続行します:

gpg --show-keys /etc/apt/keyrings/claude-code.asc

gpg が出力するフィンガープリントは 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE である必要があります。gpg がファイルを開けない、または有効な OpenPGP データが含まれていないと報告する場合、ダウンロードが失敗したか、間違ったコンテンツが返されました。ネットワークが downloads.claude.ai に到達できることを確認してから、ダウンロードコマンドを再実行します。

stable チャネルでリポジトリを登録してインストールします:

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

代わりに latest チャネルを使用するには、URL パスとスイート名の両方が変わります。この deb 行を使用します:

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list

後で更新するには、sudo apt update && sudo apt upgrade claude-code を実行します。

npm でのインストール

Claude Code をグローバル npm パッケージとしてインストールすることもできます。v2.1.198 以降、npm パッケージには Node.js 22 以上が必要です。古い Node.js バージョンでは、npm はインストール中に失敗するのではなく EBADENGINE 警告を出力します。インストールは完了し、パッケージがランタイムで Node.js を使用しないネイティブバイナリをダウンロードするため、claude は引き続き実行されます。

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

npm パッケージは、スタンドアロンインストーラーと同じネイティブバイナリをインストールします。npm は @anthropic-ai/claude-code-darwin-arm64 などのプラットフォーム固有のオプション依存関係を通じてバイナリをプルし、postinstall ステップがそれを所定の位置にリンクします。インストールされた claude バイナリ自体は Node を呼び出しません。

サポートされている npm インストールプラットフォームは darwin-arm64、darwin-x64、linux-x64、linux-arm64、linux-x64-musl、linux-arm64-musl、win32-x64、および win32-arm64 です。パッケージマネージャーはオプション依存関係を許可する必要があります。インストール後にバイナリが見つからない場合は、トラブルシューティングを参照してください。

npm インストールをアップグレードするには、npm install -g @anthropic-ai/claude-code@latest を実行します。npm update -g は避けてください。これは元のインストールからの semver 範囲を尊重し、最新リリースに移動しない可能性があります。

バイナリ整合性とコード署名

各リリースは、すべてのプラットフォームバイナリの SHA256 チェックサムを含む manifest.json を公開します。マニフェストは Anthropic GPG キーで署名されているため、マニフェスト上の署名を検証することで、それが列挙するすべてのバイナリを推移的に検証します。

マニフェスト署名を検証

ステップ 1~3 には、gpg と curl を備えた POSIX シェルが必要です。Windows では、Git Bash または WSL で実行します。ステップ 4 には PowerShell オプションが含まれています。

1

公開鍵をダウンロードしてインポート

リリース署名キーは固定 URL で公開されています。

curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import

インポートされたキーのフィンガープリントを表示します。

gpg --fingerprint security@anthropic.com

出力にこのフィンガープリントが含まれていることを確認します:

31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE
2

マニフェストと署名をダウンロード

VERSION を検証するリリースに設定します。

REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"
3

署名を検証

マニフェストに対して分離された署名を検証します。

gpg --verify manifest.json.sig manifest.json

有効な結果は Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>" を報告します。

gpg は新しくインポートされたキーに対して WARNING: This key is not certified with a trusted signature! も出力します。これは予想されています。Good signature 行は暗号化チェックが成功したことを確認します。ステップ 1 のフィンガープリント比較はキー自体が本物であることを確認します。

4

バイナリをマニフェストに対して確認

バイナリの SHA256 チェックサムを manifest.json の platforms.<platform>.checksum の下にリストされている値と比較します。以下のコマンドは、現在のディレクトリに claude バイナリがあることを想定しています。代わりにインストールされたネイティブバイナリを検証するには、~/.local/share/claude/versions/VERSION に対してコマンドを実行します。VERSION をステップ 2 で設定したリリースに置き換えます。

sha256sum claude

プラットフォームコード署名

署名付きマニフェストに加えて、個別のバイナリはサポートされている場所でプラットフォーム固有のコード署名を実行します。

  • macOS: "Anthropic PBC" によって署名され、Apple によって公証されています。codesign --verify --verbose ./claude で検証します。
  • Windows: "Anthropic, PBC" によって署名されています。Get-AuthenticodeSignature .\claude.exe で検証します。
  • Linux: バイナリは個別にコード署名されていません。claude-code-releases バケットから直接ダウンロードするか、ネイティブインストーラーを使用する場合は、上記のマニフェスト署名で整合性を検証します。apt、dnf、または apkでインストールする場合、パッケージマネージャーはリポジトリ署名キーを使用して署名を自動的に検証します。

Claude Code をアンインストール

Claude Code を削除するには、インストール方法の指示に従ってください。アンインストール後も claude が実行される場合は、2 番目のインストールまたは古いインストーラーからの残存シェルエイリアスがある可能性があります。競合するインストールを確認を参照して、それを見つけて削除してください。

ネイティブインストール

Claude Code バイナリとバージョンファイルを削除します:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Homebrew インストール

インストールした Homebrew cask を削除します。安定版 cask をインストールした場合:

brew uninstall --cask claude-code

最新版 cask をインストールした場合:

brew uninstall --cask claude-code@latest

WinGet インストール

WinGet パッケージを削除します:

winget uninstall Anthropic.ClaudeCode

apt / dnf / apk

パッケージとリポジトリ構成を削除します:

sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

npm

グローバル npm パッケージを削除します:

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

構成ファイルを削除

VS Code 拡張機能、JetBrains プラグイン、および Desktop アプリも ~/.claude/ に書き込みます。それらのいずれかがまだインストールされている場合、ディレクトリは次回実行時に再作成されます。Claude Code を完全に削除するには、これらのファイルを削除する前に、VS Code 拡張機能、JetBrains プラグイン、および Desktop アプリをアンインストールしてください。

Claude Code の設定とキャッシュされたデータを削除するには:

# ユーザー設定と状態を削除
rm -rf ~/.claude
rm ~/.claude.json

# プロジェクト固有の設定を削除(プロジェクトディレクトリから実行)
rm -rf .claude
rm -f .mcp.json