2026年のClaude Codeはインストール体験が大きく改善されました。ネイティブインストーラー(Node.js不要)がmacOS・Windows・Linuxに対応し、パッケージマネージャー(Homebrew・WinGet・apt/dnf公式リポジトリ)もサポートされています。このガイドでは全インストール方法、よくあるエラー、インストール後の初期設定を解説します。
まず確認:どの方法を選ぶか
- macOS / Linux: ネイティブインストーラー(curlコマンド1本)。2分で完了
- Windows: WinGetまたはネイティブインストーラー。2分で完了
- Node.jsを既に使っている場合:
npm install -g @anthropic-ai/claude-codeが使えます - Homebrewユーザー:
brew install claude-code(macOS / Linux)
どの方法でも同じバイナリがインストールされます。既存のツールチェーンに合わせて選択してください。
前提条件
インストール前に以下を確認してください。
アカウント
- 有料のClaudeプランが必要:Pro($20/月)、Max($100〜$200/月)、Team、Enterprise、またはConsole(APIアクセス付き)
- 無料のClaude.aiプランはClaude Codeに対応していません
システム要件
| OS | 最低バージョン | RAM |
|---|---|---|
| macOS | 13.0 Ventura | 4 GB(8 GB推奨) |
| Windows | 10 ビルド 1809(2018年10月アップデート) | 4 GB(8 GB推奨) |
| Linux | x86_64 または arm64、glibc 2.28以上 | 4 GB(8 GB推奨) |
macOS Big Sur(11)以前の場合はOSのアップグレードが必要です。
方法1:ネイティブインストーラー(推奨)
2026年の公式インストール方法です。Node.jsは不要で、npm のグローバル権限の問題も発生しません。
macOS
curl -fsSL https://claude.ai/install.sh | bash
確認:
claude --version
# claude-code 2.x.x
Linux(Debian / Ubuntu / Fedora / Arch)
curl -fsSL https://claude.ai/install.sh | bash
スクリプトがディストリビューションを検出して適切なパッケージ形式を使用します。エアギャップ環境では https://claude.ai/cli/latest/linux-x64 からバイナリを直接ダウンロードできます。
Windows
PowerShell:
iwr -useb https://claude.ai/install.ps1 | iex
または公式ドキュメントからインストーラー .exe をダウンロードしてダブルクリックします。
インストール後、claude コマンドがPATHに追加されるようにターミナルを再起動してください。
方法2:パッケージマネージャー
Homebrew(macOS / Linux)
brew install claude-code
公式の anthropic-experimental/claude フォーミュラをタップして、ネイティブインストーラーと同じバイナリをインストールします。
WinGet(Windows)
winget install Anthropic.ClaudeCode
WinGetがインストールパスとPATHの更新を自動で処理します。
apt(Debian / Ubuntu)
# Anthropicのaptリポジトリを追加
curl -fsSL https://claude.ai/keyring.gpg | sudo gpg --dearmor -o /usr/share/keyrings/anthropic.gpg
echo "deb [signed-by=/usr/share/keyrings/anthropic.gpg] https://claude.ai/apt stable main" | sudo tee /etc/apt/sources.list.d/anthropic.list
sudo apt update
sudo apt install claude-code
dnf(Fedora / RHEL)
sudo dnf config-manager --add-repo https://claude.ai/dnf/anthropic.repo
sudo dnf install claude-code
方法3:npm
Node.js(バージョン18以上)を既に使用していてnpm管理ツールが好みの場合:
npm install -g @anthropic-ai/claude-code
npmパッケージはプラットフォーム固有のオプション依存関係(@anthropic-ai/claude-code-darwin-arm64、@anthropic-ai/claude-code-linux-x64 など)経由で同じネイティブバイナリをインストールします。
⚠️ sudo は使わないこと
# これはやらないこと
sudo npm install -g @anthropic-ai/claude-code
sudo の使用は権限問題を引き起こしセキュリティリスクになります。npm install -g で権限エラーが出た場合は、npmのプレフィックスを設定してください:
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc # または ~/.bashrc
source ~/.zshrc
初回設定
インストール後、プロジェクトディレクトリで実行します:
cd /path/to/your/project
claude
初回起動時にClaude Codeは以下を実行します:
- ブラウザを開いてアカウント認証
~/.claude/設定ディレクトリの作成- プロジェクトコンテキストの検出
- インタラクティブセッションへの移行
インストール確認
claude --version
claude --help
バージョン出力とヘルプテキストが表示されればセットアップ完了です。
プロジェクト設定:AGENTS.md / CLAUDE.md
Claude Codeをフル活用するには、プロジェクトルートにルールファイルを設定します。
AGENTS.md の作成(複数ツール使用プロジェクトに推奨)
# AGENTS.md
## プロジェクトコンテキスト
- スタック: Next.js 15 + Postgres + Redis
- テストランナー: Vitest
- パッケージマネージャー: pnpm
## コマンド
- テスト実行: `pnpm test`
- 開発サーバー: `pnpm dev`
- ビルド: `pnpm build`
## 規約
- TypeScript strictモード
- APIルートはすべて `/app/api/*` に配置
- DBマイグレーションは `/migrations/` に配置
## 承認が必要な操作
- `/migrations/*` ファイルへのすべての変更
- データベーススキーマの変更
- 本番環境へのデプロイ
CLAUDE.md の作成(Claude Code固有)
CLAUDE.mdはClaude Code専用のルールファイルです。フォーマットはAGENTS.mdと同じですが、Claude Codeではこちらが優先されます。
詳細は AGENTS.md vs CLAUDE.md 使い分けガイド(2026年) を参照してください。
よくあるインストールエラー
claude: command not found(インストール後)
ターミナルを再起動してください。PATHの更新は新しいシェルで有効になります。それでも解決しない場合:
# claudeのインストール先を確認
which claude
# 空の場合、手動でPATHに追加
export PATH="$HOME/.claude/bin:$PATH"
EACCES 権限エラー(npm install -g)
npm prefixの設定なしにnpmを使用したためです。ネイティブインストーラーを使用するか(推奨)、上記のnpm prefix設定を行ってください。
macOS「開発者を確認できません」エラー
バイナリを右クリック→「開く」→確認をクリック。または:
sudo xattr -d com.apple.quarantine $(which claude)
Windows「コマンドが見つかりません」(WinGet後)
シェルを再起動するか新しいPowerShellウィンドウを開いてください。WinGetはPATHを更新しますが、既存のセッションには反映されません。
認証失敗 / ブラウザが開かない
手動認証:
claude /login
任意のブラウザで開けるURLが表示されます。
Linux glibc バージョンが古い
Claude Codeにはglibc 2.28以上が必要です。古いシステム(Ubuntu 18.04、RHEL 7)ではOSをアップグレードするか、コンテナ経由でインストールしてください:
docker run -it -v $(pwd):/work anthropic/claude-code:latest
Claude Codeのアップデート
ネイティブインストーラー
claude /update
またはインストールスクリプトを再実行——既存のインストールを検出してアップグレードします。
Homebrew
brew upgrade claude-code
npm
npm install -g @anthropic-ai/claude-code@latest
WinGet
winget upgrade Anthropic.ClaudeCode
設定ファイルリファレンス
インストール後、Claude Codeは以下のパスを使用します:
| パス | 用途 |
|---|---|
~/.claude/settings.json | グローバル設定 |
~/.claude/projects/<プロジェクト名>/ | プロジェクト別の状態 |
<プロジェクト>/.claude/settings.json | プロジェクト固有の設定 |
<プロジェクト>/CLAUDE.md または AGENTS.md | AI動作ルール |
インストール後にやること
- CLAUDE.mdまたはAGENTS.mdをプロジェクトルートに作成
- 簡単なタスクを試す:
claudeを起動して「このプロジェクトは何をしていますか?package.jsonとメインエントリポイントを読んでください」と聞いてみる - フックの設定: 自動化が必要な場合は Claude Codeフックガイド を参照
- エディタ統合の設定: VS Code拡張機能またはJetBrainsプラグイン
- ベストプラクティスを読む: Claude Code ベストプラクティス 2026
よくある質問
Claude Codeを使うには有料プランが必要ですか?
はい。最低限Claude Pro($20/月)が必要です。無料のClaude.aiプランはClaude Codeに対応していません。Proには使用量制限あり、Maxプラン($100〜$200/月)では1日の使用量が大きく増えます。
Node.jsなしでインストールできますか?
できます。ネイティブインストーラーまたはパッケージマネージャー(Homebrew・WinGet・apt・dnf)を使用してください。npmは必要ありません。
どのインストール方法を選べばよいですか?
macOSまたはLinuxの場合:ネイティブインストーラーまたはHomebrew。Windowsの場合:WinGet。npmでツールチェーンを管理している場合:npm。すべての方法で同じバイナリがインストールされます。
Claude Codeはオープンソースですか?
CLIは非公開ソースです。有料プランの利用規約により商用利用が許可されています。モデル(Claude)はオープンウェイトではありませんが、バンドルされたCLI経由でアクセスできます。
会社支給/管理デバイスで使えますか?
使えますが、IT部門のポリシーを確認してください。CLIはapi.anthropic.comへのアウトバウンドHTTPSリクエストを行います。企業プロキシの設定が必要な場合は export HTTPS_PROXY=... を実行してから起動してください。
サーバー(GUI なし)にインストールできますか?
できます。Claude Codeはヘッドレスで動作します。claude /login --no-browser で別デバイスで完了できる認証URLが表示されます。
アンインストール方法は?
claude --uninstall
またはパッケージマネージャー経由:
brew uninstall claude-code # Homebrew
winget uninstall Anthropic.ClaudeCode # WinGet
npm uninstall -g @anthropic-ai/claude-code # npm
その後、必要であれば ~/.claude/ を削除してください。
Claude Code CLIとIDE拡張機能の違いは?
CLIはターミナルで自律エージェントとして動作します。VS Code / JetBrainsプラグインはインラインサポートを提供し、エディタのUIと統合されます。多くのエンジニアは両方を使用しています——CLIは深い作業に、プラグインはインライン編集に。
まとめ
2026年のClaude Codeのインストールは全プラットフォームで安定しています:
- ✅ ネイティブインストーラーで2分以内
- ✅ パッケージマネージャー(Homebrew・WinGet・apt・dnf)対応
- ✅ Node.jsユーザー向けのnpmサポート
- ✅ どの方法でも同じバイナリ
- ⚠️
sudo npm install -gは避けること(セキュリティ/権限の問題)
インストール後の次のステップ:AGENTS.mdまたはCLAUDE.mdの作成、動作確認のための小さなタスク実行、ワークフロー用のフック設定。インストール自体は簡単な部分——本当の価値はプロジェクトをエージェントと上手く動くように設定することから生まれます。
実際のプロジェクトで使われているCLAUDE.md設定の例はギャラリーで165本以上公開しています。
関連記事
- AGENTS.md vs CLAUDE.md 使い分けガイド(2026年)
- Claude Code ベストプラクティス 2026
- Claude Code フックガイド
- Claude Code MCPセットアップガイド
- Claude Code VS Code 拡張機能 完全ガイド 2026 — @メンション・IDE MCP・チェックポイント・/mcp管理