詳細セットアップとバージョン管理

この節で学ぶこと

この節では、Claude Code の動作環境から、5つのインストール方法、インストール後の確認・認証、そして自動更新とアンインストールまで、セットアップに必要な知識を一通り扱います。インストール方法によって、その後のアップデート運用が大きく変わります。

セットアップ全体の見取り図

クイックスタートがインストールから最初のセッションまでの最短ルートだとすると、この節はその後の運用（バージョン管理・チーム展開・撤去）まで含めた詳細版です。スマートフォンのアプリ配布に例えると分かりやすくなります。

どの方法を選ぶかは、この後の運用の手間に直結します。

動作環境

Claude Code は次の環境で動作します。

追加の依存関係として ripgrep（コード検索に使うツール）が必要ですが、通常は Claude Code に同梱されています。検索が失敗する場合はトラブルシューティングのページ（公開準備中）を参照してください。

インストール方法を選ぶ

下の図は5つのインストール方法と、自動更新の有無をまとめたものです。

※ Homebrew・WinGet は環境変数 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 で自動化できます（詳細はアップデートの仕組み）。

ネイティブインストール（推奨）

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

ネイティブインストールはバックグラウンドで自動的に最新版を保ちます。インストール後は、作業したいプロジェクトのディレクトリでターミナルを開き、claude と実行するとインタラクティブなセッションが開始します。

GUIを使いたい場合はデスクトップアプリも選べます。

Homebrew

brew install --cask claude-code

Homebrewには2つのcaskがあります。claude-code は安定版チャンネル（stable、最新から約1週間遅れで、重大な不具合を含むリリースをスキップ）を追跡し、claude-code@latest は最新チャンネル（latest）をリリース直後に受け取ります。Homebrewは自動更新しません。brew upgrade claude-code または brew upgrade claude-code@latest（インストールしたcaskに応じて）を実行してください。

WinGet

winget install Anthropic.ClaudeCode

WinGetも自動更新しません。定期的に winget upgrade Anthropic.ClaudeCode を実行してください。

Linuxパッケージマネージャ（apt / dnf / apk）

Debian/Ubuntu（apt）、Fedora/RHEL（dnf）、Alpine Linux（apk）向けに、署名済みリポジトリが公開されています。各リポジトリには stable（多くのユーザー向け）と latest の2チャンネルがあります。署名鍵のフィンガープリントは 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE です。これらのインストールはClaude Code経由では自動更新されず、通常のシステムアップグレード手順（apt upgrade、dnf upgrade、apk upgrade など）で更新します。

npm

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

npmパッケージは、公式インストーラーと同じネイティブバイナリを、プラットフォームごとのoptionalDependency（例: @anthropic-ai/claude-code-darwin-arm64）経由で取得し、postinstallでリンクします。インストール後の claude コマンド自体はNode.jsを呼び出しません。

Windows・Alpine Linuxでの注意点

Windowsのインストール先を選ぶ

ネイティブWindowsでは管理者権限は不要です。

Git Bashのパスを明示する例:

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

Alpine Linuxでの追加設定

AlpineなどmuslベースのディストリビューションはデフォルトでBashとcurlを含まないため、インストールコマンドがそのままだと not found エラーで失敗します。実行時には libgcc・libstdc++・ripgrep も必要です。

apk add bash curl libgcc libstdc++ ripgrep

Alpineでは ripgrep はcommunityリポジトリに含まれます。apk がパッケージを見つけられない場合は /etc/apk/repositories にcommunityリポジトリを追加し、apk update してから再試行します。パッケージ導入後は settings.json で USE_BUILTIN_RIPGREP を 0 に設定してください。

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

インストール後の確認

claude --version

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

より詳しい診断には claude doctor を使います。

claude doctor

claude doctor はセッションを開始せずに、インストール状態と設定に関する読み取り専用の診断（インストールの健全性、settings.json のバリデーションエラー、修正案付きの警告など）を出力します。

認証

Claude Codeの利用には認証が必要です。

アカウント種別ごとの詳細は認証を参照してください。

アップデートの仕組み

自動更新の対象と挙動

ネイティブインストールは起動時と実行中に定期的に更新を確認し、バックグラウンドでダウンロード・インストールします。反映されるのは次回起動時です。

パッケージマネージャ経由のインストールでは扱いが変わります。

リリースチャンネルを切り替える

autoUpdatesChannel 設定で、自動更新と claude update が追従するチャンネルを制御します。

/config の「Auto-update channel」から設定するか、settings.json に直接書きます。

{
  "autoUpdatesChannel": "stable"
}

Enterpriseの組織展開では、管理設定（managed settings、公開準備中）でリリースチャンネルを組織全体に強制できます。Homebrewはこの設定ではなくcask名（claude-code / claude-code@latest）でチャンネルを選びます。

最小バージョンを固定する

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

/config で "latest" から "stable" に切り替えると、現在のバージョンにとどまるかダウングレードを許可するか確認されます。「とどまる」を選ぶと、その時点のバージョンが minimumVersion に設定されます。"latest" に戻すと minimumVersion はクリアされます。

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

自動更新を無効化する

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

DISABLE_AUTOUPDATER はバックグラウンドの自動更新チェックだけを止めます。claude update や claude install による手動更新はそのまま動作します。手動更新も含めてすべての更新経路をブロックしたい場合は、環境変数 DISABLE_UPDATES を使います。これは、Claude Codeを自社の配布経路で配り、ユーザーに指定バージョンを使い続けさせたい場合に向いています。

手動でアップデートする

claude update

更新が実行されると Successfully updated from <旧バージョン> to version <新バージョン> と表示されます。すでに最新の場合は Claude Code is up to date (<バージョン>) と表示されます。Homebrew・WinGet・apkが管理しているインストールでは、代わりに Claude is up to date! と表示されます。

バージョン指定インストールとバイナリの検証（発展）

ネイティブインストーラーは、バージョン番号（例: 2.1.89）またはチャンネル名（latest / stable）を指定してインストールできます。インストール時に選んだチャンネルが、以後の自動更新のデフォルトになります。

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

アンインストール

インストール方法ごとに手順が異なります。ネイティブインストールの場合:

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

設定ファイルまで削除する場合は次を実行します。この操作はすべての設定・許可済みツール・MCPサーバー設定・セッション履歴を削除します。

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

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

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

つまずきポイント

• 参考（公式ではない）: チームに展開する場合、まず1人がネイティブインストールで動作確認し、その後 autoUpdatesChannel を "stable" に固定して展開すると、開発中の不具合を踏みにくくなります。

関連リンク

• クイックスタート（インストールから最初のセッションまでの最短ルート）: クイックスタート
• アカウント種別ごとの認証方法: 認証
• GUIで使いたい場合: デスクトップアプリのクイックスタート
• 権限モードとBashツールの関係: 権限モードを選ぶ
• サンドボックスの詳細: 第6章「サンドボックス」（公開準備中）
• 原文: Advanced setup

出典

• Advanced setup（取得日: 2026-08-18）