SpyBara
Go Premium

setup.md 2026-06-16 21:57 UTC to 2026-06-17 17:02 UTC

28 added, 6 removed.

2026
Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

高度なセットアップ

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 をインストール

To install Claude Code, use one of the following methods:

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

If you see The token '&&' is not a valid statement separator, you're in PowerShell, not CMD. If you see 'irm' is not recognized as an internal or external command, you're in CMD, not PowerShell. Your prompt shows PS C:\ when you're in PowerShell and C:\ without the PS when you're in CMD.

Git for Windows is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.

You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine.

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

claude

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

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_CODE_USE_POWERSHELL_TOOL=1 を設定するか、オプトアウトするには 0 を設定します。セットアップと制限については、PowerShell ツールを参照してください。

オプション 2: WSL

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

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

Alpine およびその他の musl/uClibc ベースのディストリビューション上のネイティブインストーラーには、libgcclibstdc++、および ripgrep が必要です。ディストリビューションのパッケージマネージャーを使用してこれらをインストールしてから、USE_BUILTIN_RIPGREP=0 を設定します。

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

apk add libgcc libstdc++ ripgrep

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

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

インストールを確認

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

claude --version

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

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

claude doctor

認証

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

インストール後、claude を実行してブラウザーのプロンプトに従ってログインします。すべてのアカウントタイプとチームセットアップオプションについては、認証を参照してください。

Claude Code を更新

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

自動更新

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

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

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 がバージョン範囲外で起動することを拒否するようにするには、代わりに管理設定の requiredMinimumVersionrequiredMaximumVersion を使用します。更新は requiredMaximumVersion の上限も尊重します。利用可能な設定を参照してください。

自動更新を無効にする

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

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

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

手動で更新

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

claude update

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

これらのオプションは、バージョンピニング、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

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

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

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

Debian および Ubuntu 用です。以下のコマンドは stable チャネルを構成します:

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
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

信頼する前に GPG キーフィンガープリントを検証します。gpg --show-keys /etc/apt/keyrings/claude-code.asc31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE を報告する必要があります。

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

npm でのインストール

Claude Code をグローバル npm パッケージとしてインストールすることもできます。パッケージには Node.js 18 以上が必要です。

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

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

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

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

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

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

マニフェスト署名を検証

ステップ 1~3 には、gpgcurl を備えた 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.jsonplatforms.<platform>.checksum の下にリストされている値と比較します。

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