Claude Codeインストールガイド: irmスクリプト、npmセットアップ、https://claude.ai/install.ps1スクリプト

はじめに

Claude Codeは私のAI支援コーディングのためのお気に入りのコマンドラインツールです。Windows、macOS、Linuxのいずれでも、複数のオプションでインストールは簡単です：

• ネイティブバイナリ（推奨）：Linux/macOSの場合 curl -fsSL https://claude.ai/install.sh | bash
• Windows PowerShell：Windowsユーザーの場合 irm https://claude.ai/install.ps1 | iex
• npm グローバルインストール：Node.js環境の場合 npm install -g @anthropic-ai/claude-code

このガイドでは、各インストール方法を詳しく説明し、さらにclaude doctorコマンドを使用した一般的な問題の診断と修正についてのトラブルシューティングも扱います。

推奨：ネイティブバイナリ

2025年現在、Claudeはnode.jsやbun.jsを含む複数のランタイムで利用可能です。Anthropicはネイティブバイナリインストールの使用を推奨しています。この方法はパッケージマネージャーの競合を避け、最も安定しています。

ネイティブバイナリのインストール

1. インストールスクリプトを実行：

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

2. シェル設定をリロード：

   source ~/.bashrc
   # または zsh ユーザーの場合：
   source ~/.zshrc

3. インストールを確認：

   claude --version
   claude doctor

以上です！Claude Codeは~/.claude/bin/claudeまたは~/.local/bin/claudeにインストールされているはずです。

トラブルシューティング：壊れたインストールの修正

セグメンテーションフォールトエラーなどClaude Codeで問題が発生している場合、混合または古いインストールがある可能性があります。私のように最初からClaudeを使用している場合、node.jsまたはbun.jsバージョンもインストールされているかもしれません。以下はその修正方法です：

claude doctorで現在のインストールを診断

claude doctorコマンドはトラブルシューティングの最初のステップです。インストールを分析し、潜在的な問題を報告します。

claude doctor

claude doctorがチェックすること

claude doctorコマンドは以下を検査します：

• インストール方法：ネイティブバイナリ、npm、Bun、またはHomebrew
• バージョン情報：現在のバージョンと更新状況
• 自動更新機能：更新を適用できるかどうか
• 検索機能：ripgrepが適切にバンドル/インストールされているか
• パス設定：ClaudeがPATHに正しく設定されているか
• 実行パス：実際に実行されているバイナリ

一般的な問題のある出力

claude doctorの出力で以下の警告サインに注意：

• unknown (2.0.0) - バージョン検出が失敗、おそらく混合インストール
• Bun、npm、Node.js間のパスの混在
• 呼び出しパスと実行パスの相違
• 自動更新が無効または失敗
• 検索ステータスがエラーを表示

また、競合する可能性のある複数のインストールを確認：

which -a claude

すべての既存インストールを削除

# Bunインストールを削除
bun uninstall -g @anthropic-ai/claude-code
rm -f ~/.bun/bin/claude

# npm/Node.jsインストールを削除
npm uninstall -g @anthropic-ai/claude-code

# nvm固有のインストールを削除
# 持っている各nvmのNodeバージョンを確認
nvm list
# 各バージョンに切り替えてアンインストール
nvm use <version>
npm uninstall -g @anthropic-ai/claude-code

Brew Uninstall Claude Code

HomebrewでClaude Codeをインストールした場合：

# HomebrewからClaude Codeをアンインストール
brew uninstall claude-code

# キャッシュファイルをクリーンアップ
brew cleanup claude-code

brew経由でアンインストールした後、より良い自動更新サポートのためにネイティブバイナリインストールに切り替えることができます。

ステップ3：設定とキャッシュをクリア

残っている設定ファイルを削除：

# Claude Code設定ディレクトリを削除
rm -rf ~/.claude-code
rm -rf ~/.config/claude-code
rm -rf ~/.cache/claude-code

ステップ4：新しいネイティブバイナリインストール

ネイティブバイナリをインストール：

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

ステップ5：修正を確認

インストール後、すべてが動作していることを確認：

# バージョンを確認
claude --version

# 診断を実行
claude doctor

健全なインストールは以下を表示するはずです：

• Version: native (2.0.x以上)
• Config install method: native
• Auto-updates: enabled
• Search: OK (bundled)

代替インストール方法

ネイティブバイナリが推奨されますが、他のオプションもあります：

npmインストール: npm install -g @anthropic-ai/claude-code

npm（Node Package Manager）を使用する場合、Claude Codeをグローバルにインストールできます。この方法にはNode.js 18以上が必要です。

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

npm install -gが行うこと

-gフラグはパッケージをグローバルにインストールし、ターミナルのどこからでもclaudeをコマンドとして使用できるようにします。パッケージ@anthropic-ai/claude-codeはAnthropicが管理する公式npmパッケージです。

npmインストールの利点：

• Node.js開発者にとって馴染みのあるワークフロー
• 他のグローバルパッケージと一緒に管理しやすい
• コンテナ化/CI環境でうまく動作

欠点：

• Node.jsランタイムが必要
• 他のパッケージマネージャー（Bun、pnpm）と競合する可能性
• 更新には手動でnpm update -g @anthropic-ai/claude-codeが必要

重要： sudo npm install -gは絶対に使用しないでください。これは権限の問題を引き起こします。EACCESエラーが発生した場合は、代わりにnpmの権限を修正してください。

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

ネイティブバイナリの特定バージョンをインストールするには：

# 最新バージョンをインストール
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 特定バージョンをインストール
curl -fsSL https://claude.ai/install.sh | bash -s 2.0.22

プラットフォーム固有の手順

Homebrewを使用したmacOS

brew install claude-code

注：Homebrewインストールはbrewディレクトリとは独立して自動更新されます。

Windows: irm https://claude.ai/install.ps1 | iex を使用

Windowsユーザーには3つのオプションがあります：

1. WSL（推奨）：WSLをインストールしてLinuxの手順に従う
2. Git Bash：Git Bashでネイティブインストーラーを使用
3. PowerShell（ネイティブWindows）：

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

irmコマンドの理解

irmコマンドはPowerShellのInvoke-RestMethodで、URLからコンテンツをダウンロードします。コマンドの動作：

• irm https://claude.ai/install.ps1 - Anthropicのサーバーからインストールスクリプトをダウンロード
• | iex - スクリプトをInvoke-Expressionにパイプし、実行

https://claude.ai/install.ps1スクリプトは以下を処理：

• Windowsアーキテクチャの検出（x64、ARM64）
• 適切なClaude Codeバイナリのダウンロード
• ユーザーディレクトリへのインストール
• PATH環境変数へのClaudeの追加

セキュリティ注意： インストールスクリプトを実行する前に、公式のclaude.aiドメインからダウンロードしていることを必ず確認してください。

Alpine Linux

Alpineや他のmuslベースのディストリビューションには追加の依存関係が必要：

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0
curl -fsSL https://claude.ai/install.sh | bash

インストール後のセットアップ

認証

インストール後、Claude Codeを認証：

claude

認証方法の選択を求められます：

• Claude Console（デフォルト）：console.anthropic.comでの課金を伴うAPIアクセス用
• Claude Pro/Max：Claudeサブスクリプションがある場合
• Enterprise：AWS BedrockまたはGoogle Vertex AIデプロイメント用

基本的な使用方法

Claude Codeの使用開始：

# プロジェクトに移動
cd /path/to/your/project

# Claude Codeを開始
claude

# ヘルプを取得
claude help

# セッション内でスラッシュコマンドを使用
/help    # 利用可能なコマンドを表示
/clear   # 会話をクリア
/exit    # Claude Codeを終了

更新の管理

自動更新

Claude Codeはデフォルトで自動的に更新されます。更新は起動時にチェックされ、バックグラウンドで適用されます。

Claude Codeを更新する方法

claude update

これを.bashrcまたは.zshrcに追加して永続的にしてください。

一般的な問題と解決策

問題：「Insufficient permissions to install update」

これは通常npm/Bunインストールで発生します。解決策：ネイティブバイナリインストールに切り替え。

問題：「command not found: claude」

PATHが更新されていません。シェル設定に追加：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

問題：検索機能が動作しない

通常ネイティブインストールで修正されますが、持続する場合：

# ripgrepを手動でインストール
sudo apt-get install ripgrep  # Ubuntu/Debian
brew install ripgrep          # macOS

ベストプラクティス

1. 特定の要件がない限り、常にネイティブバイナリを使用する
2. どのインストール方法でもsudoを避ける
3. セキュリティと機能のために自動更新を有効に保つ
4. インストールまたは更新後にclaude doctorを実行する
5. 新しいバージョンをインストールする前に古いインストールをクリーンアップする

結論

迷ったら、すべてを削除してネイティブバイナリで新たに始めてください。Claude Codeを実行する最もシンプルで、最速で、最も信頼性の高い方法です。

関連記事

Claude Codeがインストールされたので、活用しましょう：

• Flaskでショッピングカートを構築 - Claude Codeを使用してPythonとFlaskで完全なeコマースバックエンドを構築する実践チュートリアル

クイックリファレンス

• インストール: curl -fsSL https://claude.ai/install.sh | bash
• バージョン確認: claude --version
• 診断: claude doctor
• 更新: claude update
• 開始: claude
• ヘルプ: claude help