インストールとログインのトラブルシューティング

​

エラーを見つける

​

診断チェックを実行する

​

ネットワーク接続を確認する

curl -sI https://downloads.claude.ai/claude-code-releases/latest

curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest

• 403：通常、プロキシまたはネットワークフィルターがホストをブロックしているか、Claude Code がご利用の地域では利用できません
• 5xx：通常、一時的なサービスの問題です。数分待ってから再試行してください

• downloads.claude.ai をブロックしている企業ファイアウォールまたはプロキシ
• 地域的なネットワーク制限：VPN または別のネットワークを試してください
• TLS/SSL の問題：システムの CA 証明書を更新するか、HTTPS_PROXY が設定されているかどうかを確認してください

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

$env:HTTP_PROXY = 'http://proxy.example.com:8080'
$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
irm https://claude.ai/install.ps1 | iex

​

PATH を確認する

ls -la ~/.local/bin/claude

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

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

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

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

claude --version

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

$env:PATH -split ';' | Select-String '\.local\\bin'

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

claude --version

dir "%USERPROFILE%\.local\bin\claude.exe"

echo %PATH% | findstr /i "local\bin"

claude --version

​

競合するインストールを確認する

which -a claude

ls -la ~/.local/bin/claude

ls -la ~/.claude/local/

npm -g ls @anthropic-ai/claude-code 2>/dev/null

where.exe claude

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

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

rm -rf ~/.claude/local

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"

brew uninstall --cask claude-code

winget uninstall Anthropic.ClaudeCode

​

ディレクトリ権限を確認する

• ~/.claude/downloads/：インストールコマンドがダウンロードしたバイナリを配置する場所
• ~/.local/bin/：claude ランチャー
• ~/.local/share/claude/：ダウンロードした各バージョン
• ~/.local/state/claude/：ロックファイル
• ~/.cache/claude/：ステージングされたダウンロード
• ~/.claude.json：グローバル設定ファイル。インストーラーはここにインストール方法を記録します

test -w ~/.local/bin && echo "writable" || echo "not writable"
test -w ~/.claude && echo "writable" || echo "not writable"

sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

​

バイナリが機能することを確認する

ls -la "$(command -v claude)"

Get-Command claude | Select-Object Source

ldd "$(command -v claude)" | grep "not found"

claude --version

​

よくあるインストールの問題

​

インストールスクリプトが shell スクリプトではなく HTML を返す

bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'

iex : At line:1 char:2310
+ ... igin="anonymous"/><script type="text/javascript">!function(o,c){var n ...
Missing argument in parameter list.
...

System.Xml.XmlDocument : The term 'System.Xml.XmlDocument' is not recognized as the name of a cmdlet, function, script
file, or operable program.

< was unexpected at this time.

C:\Users\you><!DOCTYPE html>...

curl: (22) The requested URL returned error: 403

1. 数分後に再試行する：この問題は多くの場合一時的です。待機して元のコマンドを再度試してください。
2. 別のインストール方法を使用する：ネイティブインストールとは異なり、Homebrew または WinGet でのインストールはデフォルトでは自動更新されません。 macOS では、Homebrew 経由でインストールします。
   brew install --cask claude-code
   
   Windows では、WinGet 経由でインストールします。
   winget install Anthropic.ClaudeCode
   
   次に claude --version を実行して確認します。コマンドは 2.1.211 (Claude Code) などのバージョン番号を出力します。シェルが claude が見つからないと報告する場合は、新しいターミナルウィンドウを開いて再試行してください。インストール元のセッションは古い PATH を保持しています。

​

インストール後の command not found: claude

​

PATH への追加時の permission denied

ls -l ~/.zshrc

• 所有者が root などの別のユーザーの場合：sudo chown $(whoami) ~/.zshrc で所有権を取得します。これには管理者権限が必要です。
• 所有者が自分の場合：ファイルは読み取り専用です。chmod u+w ~/.zshrc で書き込み可能にしてください。

​

curl: (56) Failure writing output to destination

​

Homebrew cask が利用できないか古い

brew update
brew install --cask claude-code

​

Cask 'claude-code@latest' is not installed

brew list --cask | grep claude-code

​

TLS または SSL 接続エラー

• curl: (35) TLS connect error
• schannel: next InitializeSecurityContext failed
• PowerShell の Could not create SSL/TLS secure channel
• PowerShell の Could not establish trust relationship for the SSL/TLS secure channel

1. システム CA 証明書を更新する： Ubuntu/Debian では：
   sudo apt-get update && sudo apt-get install ca-certificates
   
   macOS では、システム curl は Keychain トラストストアを使用します。macOS 自体を更新するとルート証明書が更新されます。
2. Windows PowerShell 5.1 では、TLS 1.2 を有効にする：
   [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
   
   次に、同じウィンドウでインストーラーを実行します。
   irm https://claude.ai/install.ps1 | iex
   
3. プロキシまたはファイアウォールの干渉を確認する：TLS 検査を実行する企業プロキシはこれらのエラーを引き起こす可能性があります。unable to get local issuer certificate と SELF_SIGNED_CERT_IN_CHAIN を含みます。インストール手順では、インストールダウンロードが企業プロキシの CA を信頼するようにします。
   • macOS/Linux
   • Windows PowerShell

   curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash
   

   PowerShell インストーラーは .NET 経由でダウンロードされ、Windows 証明書ストアに対して TLS を検証します。プロキシの CA 証明書がまだそこにない場合は、IT チームに Windows ストアに追加するよう依頼してから、インストーラーを実行してください。

   irm https://claude.ai/install.ps1 | iex
   
   インストール後の Claude Code 自体については、NODE_EXTRA_CA_CERTS を設定して API リクエストが同じバンドルを信頼するようにします。
   • macOS/Linux
   • Windows PowerShell

   export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
   

   $env:NODE_EXTRA_CA_CERTS = 'C:\path\to\corporate-ca.pem'
   
   証明書ファイルがない場合は IT チームに依頼してください。直接接続で試して、プロキシが原因であることを確認することもできます。
4. Windows では、ブロックされた失効確認を回避する。エラー CRYPT_E_NO_REVOCATION_CHECK (0x80092012) と CRYPT_E_REVOCATION_OFFLINE (0x80092013) は curl がサーバーに到達したが、ネットワークが証明書失効確認をブロックしていることを意味します。これは企業ファイアウォールの背後では一般的です。失敗しているコマンドが install.cmd をダウンロードする curl の場合、--ssl-revoke-best-effort を追加してコマンドプロンプトから再実行してください。
   curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
   
   スクリプト自体のダウンロードが同じエラーに遭遇すると、自動的にベストエフォート失効確認で再試行されるため、フラグは自分で実行するコマンドにのみ必要です。ベストエフォート確認は到達不可能な失効サーバーを許容しますが、既知の失効証明書は拒否します。ブラウザが失効を処理する方法と一致します。curl の失効確認を完全に回避することもできます。PowerShell から PowerShell インストーラーを実行してください。これは .NET 経由でダウンロードされ、失効サーバーが到達不可能な場合は失敗しません。
   irm https://claude.ai/install.ps1 | iex
   
   winget install Anthropic.ClaudeCode でインストールすることもできます。これは curl を完全に回避します。

​

Failed to fetch version from downloads.claude.ai

​

The connection dropped while downloading the update

The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

• claude update を再度実行してください。ネットワークにほかに問題がなければ、通常は次の実行でダウンロードが成功します。タイムアウトのメッセージの場合は、より高速な、または帯域制限の少ないネットワークから再度実行してください。
• ネットワークでプロキシが必要な場合は、インストーラーまたは claude update を実行する前に HTTPS_PROXY を設定してください。ネットワーク接続を確認を参照してください。
• 企業プロキシが転送を切断し続ける場合は、downloads.claude.ai からの完全なダウンロードを許可するようネットワークチームに依頼してください。ネットワークアクセス要件を参照してください。
• シェルから claude doctor を実行してインストールの診断を確認する

​

Windows での間違ったインストールコマンド

• irm が認識されない：CMD にいます。PowerShell ではありません。2 つのオプションがあります。 スタートメニューで「PowerShell」を検索して PowerShell を開き、元のインストールコマンドを実行します。
  irm https://claude.ai/install.ps1 | iex
  
  または CMD にとどまり、代わりに CMD インストーラーを使用します。
  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  
• && が有効なステートメント区切り文字ではない：PowerShell にいますが、CMD インストーラーコマンドを実行しました。PowerShell インストーラーを使用してください。
  irm https://claude.ai/install.ps1 | iex
  
• A parameter cannot be found that matches parameter name 'fsSL'：macOS/Linux の curl -fsSL ... | bash インストーラーを Windows PowerShell で実行しました。ここで curl は Invoke-WebRequest のエイリアスであり、-fsSL フラグを拒否します。代わりに PowerShell インストーラーを使用してください。
  irm https://claude.ai/install.ps1 | iex
  
• bash が認識されない：macOS/Linux インストーラーを Windows で実行しました。代わりに PowerShell インストーラーを使用してください。
  irm https://claude.ai/install.ps1 | iex
  
• コマンドがインストールせずにスクリプトテキストを出力する：ダウンロード部分を実行部分なしで実行しました。irm https://claude.ai/install.ps1 単独でダウンロードされたスクリプトをターミナルに出力します。iex にパイプして実行してください。
  irm https://claude.ai/install.ps1 | iex
  
  CMD では、-o なしの curl -fsSL https://claude.ai/install.cmd はバッチスクリプトを保存する代わりに出力します。完全なコマンドを実行してください。
  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  

​

running scripts is disabled on this system

npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
...
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException

1. ユーザーのローカルで作成されたスクリプトを許可してから再試行してください。
   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   
2. .cmd ランチャーを呼び出す：npm.cmd と claude.cmd は同じ仕事をし、ポリシーはそれらをカバーしません。
3. npm の代わりに PowerShell インストーラーを使用する。これは .ps1 スクリプトではなくバイナリをインストールします。

​

Windows インストール中の The process cannot access the file

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

​

Windows での更新後に claude.exe が見つからない

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

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

​

低メモリ Linux サーバーでインストールが強制終了される

Setting up Claude Code...
bash: line 183: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

1. スワップスペースを追加する（サーバーの RAM が限定されている場合）。スワップはディスク領域をオーバーフローメモリとして使用し、物理 RAM が少ない場合でもインストールを完了できます。 2 GB スワップファイルを作成して有効にします。
   sudo fallocate -l 2G /swapfile
   sudo chmod 600 /swapfile
   sudo mkswap /swapfile
   sudo swapon /swapfile
   
   次にインストールを再試行してください。
   curl -fsSL https://claude.ai/install.sh | bash
   
2. 他のプロセスを閉じてインストール前にメモリを解放します。
3. 可能であれば、より大きなインスタンスを使用する。Claude Code には最低 4 GB の RAM が必要です。

​

Installation was killed before it could finish

Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

• 他のプロセスを停止してメモリを解放してから、インストーラーを再実行する
• スワップ領域を追加するか、より大きなインスタンスに移行する。スワップファイルのコマンドについては、低メモリ Linux サーバーでインストールが強制終了されるを参照してください。

​

Docker でのインストールハング

1. インストーラーを実行する前に作業ディレクトリを設定する。/ から実行すると、インストーラーはファイルシステム全体をスキャンし、過度なメモリ使用を引き起こします。WORKDIR を設定すると、スキャンが小さなディレクトリに制限されます。
   WORKDIR /tmp
   RUN curl -fsSL https://claude.ai/install.sh | bash
   
2. Docker Desktop を使用している場合、Docker にさらにメモリを与える。ビルドコンテナーは Docker Desktop 仮想マシンに割り当てられたメモリを共有するため、Docker Desktop で Settings > Resources を開き、メモリ制限を上げて、ビルドを再実行してください。

​

インストール中の Raw mode is not supported

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

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

​

claude update または claude doctor がハングする

ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish

​

Claude Desktop が Windows で claude コマンドを上書きする

​

Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

1. デフォルトのインストール場所 C:\Program Files\Git と C:\Program Files (x86)\Git。
2. PATH 上の git。その Git インストールから bin\bash.exe を使用します。

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

​

Claude Code は 32 ビット Windows をサポートしていません

[Environment]::Is64BitOperatingSystem

​

Linux musl または glibc バイナリの不一致

Error loading shared library libstdc++.so.6: No such file or directory

1. システムが使用する libc を確認する：
   ldd --version 2>&1 | head -1
   
   GNU libc または GLIBC に言及する出力は glibc を意味します。musl に言及する出力は musl を意味します。
2. glibc にいるが musl バイナリを取得した場合、インストールを削除して再インストールしてください。https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json のマニフェストを使用して正しいバイナリを手動でダウンロードすることもできます。ldd --version と ls /lib/libc.musl* の出力を含む GitHub issue をファイルしてください。
3. 実際に musl にいる場合（Alpine Linux など）、必要なパッケージをインストールしてください。
   apk add libgcc libstdc++ ripgrep
   
   Alpine では、ripgrep はコミュニティリポジトリにあります。apk がパッケージが見つからないと報告する場合は、Alpine Linux セットアップを参照してください。

​

Illegal instruction

​

macOS での dyld: cannot load

dyld: Symbol not found: _ubrk_clone
  Referenced from: claude-darwin-x64 (which was built for Mac OS X 13.0)
  Expected in: /usr/lib/libicucore.A.dylib

dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
Abort trap: 6

1. macOS バージョンを確認する：Claude Code には macOS 13.0 以降が必要です。Apple メニューを開き、「この Mac について」を選択してバージョンを確認してください。
2. macOS を更新する（古いバージョンにいる場合）。バイナリは古い macOS バージョンがサポートしていないロードコマンドとシステムライブラリを使用しています。Homebrew などの代替インストール方法は同じバイナリをダウンロードし、このエラーを解決しません。

​

実行中のセッションで Bus error が発生する

​

WSL1 での Exec format error

wsl --set-version <DistroName> 2

claude() {
  /lib64/ld-linux-x86-64.so.2 "$(readlink -f "$HOME/.local/bin/claude")" "$@"
}

​

WSL での npm インストールエラー

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

source ~/.nvm/nvm.sh

export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

​

インストール中の権限エラー

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

​

npm インストール後にネイティブバイナリが見つからない

Error: claude native binary not installed.

Either postinstall did not run (--ignore-scripts, some pnpm configs)
or the platform-native optional dependency was not downloaded
(--omit=optional).

Run the postinstall manually (adjust path for local vs global install):
  node node_modules/@anthropic-ai/claude-code/install.cjs

Or reinstall without --ignore-scripts / --omit=optional.

• オプション依存関係が無効になっている。 npm インストールコマンドから --omit=optional を削除し、pnpm から --no-optional を削除し、yarn から --ignore-optional を削除し、.npmrc が optional=false を設定していないことを確認してください。次に再インストールしてください。ネイティブバイナリはオプション依存関係としてのみ配信されるため、スキップされた場合は JavaScript フォールバックがなく、install.cjs を再度実行してもダウンロードされなかったバイナリを配置できません。
• インストールスクリプトが無効になっている。 --ignore-scripts と一部の pnpm 設定は postinstall ステップをスキップしますが、プラットフォームパッケージはダウンロードします。メッセージが示唆するように node node_modules/@anthropic-ai/claude-code/install.cjs を実行するか、フラグなしで再インストールしてください。postinstall が環境でまったく実行できない場合、node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs はダウンロードされたパッケージを見つけて起動します。ただし、起動のたびに追加の Node プロセスが必要になります。ラッパーが代わりに Could not find native binary package を出力する場合、プラットフォームパッケージはダウンロードされなかったため、最初に上記のオプション依存関係の原因を修正してください。
• サポートされていないプラットフォーム。 プリビルトバイナリは darwin-arm64、darwin-x64、linux-x64、linux-arm64、linux-x64-musl、linux-arm64-musl、win32-x64、win32-arm64 に対して公開されています。Claude Code は他のプラットフォーム用のバイナリを出荷しません。システム要件を参照してください。FreeBSD では、インストーラーはプラットフォームをサポートされていないと報告します。v2.1.205 より前では、FreeBSD を Linux として扱い、実行できないバイナリをダウンロードしました。
• 企業 npm ミラーがプラットフォームパッケージを欠落している。 レジストリがメタパッケージに加えて 8 つすべての @anthropic-ai/claude-code-* プラットフォームパッケージをミラーしていることを確認してください。

​

npm ENOTEMPTY エラー（更新または再インストール中）

npm error code ENOTEMPTY
npm error syscall rename
npm error path /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/claude-code
npm error dest /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/.claude-code-tVWAnUUt
npm error errno -39
npm error ENOTEMPTY: directory not empty, rename '...'

rm -rf "$(npm root -g)/@anthropic-ai/claude-code"