Claude Code のインストールとログインのトラブル対処

Claude Code 入門 7分で読めます

Claude Code をインストールしたのに claude が見つからない、インストールコマンドが見慣れないエラーで止まる、ブラウザでサインインしたのに 403 が返る。こうした「使い始める前」のつまずきは、出ているエラーの文言からほぼ原因を絞り込めます。この記事では、公式ドキュメント「Troubleshoot installation and login」をもとに、最初に打つ診断コマンド、PATH の直し方、複数インストールの整理、インストールスクリプトの失敗、ログインと認証のエラーを順に整理します。インストール手順そのものはインストールのページ、起動後の設定が効かない問題は設定のデバッグの記事を参照してください。

まず確認する3つの診断

公式ドキュメントは冒頭に「表示されたエラー」と「対処」の対応表を置いています。エラー文がはっきりしているならそこから直接対処に進み、文言が当てはまらないときは次の診断を順に試します。

1. ダウンロード元に届くか: インストーラーは downloads.claude.ai からダウンロードします。

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

# Windows PowerShell(curl は Invoke-WebRequest の別名なので curl.exe を明示する)
curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest

1行目が 200 なら到達できています。403 はプロキシやネットワークのフィルタによる遮断か、Claude Code が利用できない地域であることが多く、5xx は一時的な障害のことが多いので数分待って再試行します。出力がない、または Could not resolve host やタイムアウトになる場合は、社内のファイアウォール・プロキシ、地域のネットワーク制限、TLS の問題を疑います。社内プロキシの内側では、インストール前に HTTPS_PROXY と HTTP_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

2. 書き込み先の権限: macOS と Linux では、インストールは ~/.local/bin/(起動用の claude)、~/.local/share/claude/(各バージョン)、~/.local/state/claude/(ロックファイル)、~/.cache/claude/、~/.claude/downloads/、~/.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 で自分を所有者にします。Windows では %USERPROFILE% の下に書き込むため、この問題はほとんど起きません。

3. バイナリが動くか: claude --version はバージョンを返すのに起動後に落ちる・止まる場合は、ls -la "$(command -v claude)"(PowerShell では Get-Command claude | Select-Object Source)で実体を確かめ、Linux では ldd "$(command -v claude)" | grep "not found" で足りない共有ライブラリを探します。claude --version が動く状態なら、claude doctor でインストールと設定の診断レポートを出せます。claude doctor はセッションを起動せず、読み取りだけで診断します。

command not found と PATH の直し方

インストールは成功したのに command not found: claude や 'claude' is not recognized が出る場合、インストール先のディレクトリが PATH に入っていません。ネイティブインストーラーは claude を macOS/Linux では ~/.local/bin/claude、Windows では %USERPROFILE%\.local\bin\claude.exe に置きます。インストーラーはこの状態を検出すると、出力の Setup notes: に「Native installation exists but ~/.local/bin is not in your PATH.」と表示し、直し方も示しますが、PATH 自体は変更しません。

なお、VS Code 拡張機能は自分専用の CLI を拡張機能のディレクトリ内に持っており、この場所には置きません。拡張機能だけを入れた状態ではターミナルから claude は使えないため、単体のインストールが必要です。

macOS / Linux: まずファイルがあるかを ls -la ~/.local/bin/claude で確かめ、次に PATH に入っているかを調べます。

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

何も出なければ、使っているシェルの設定ファイルに追記して読み込み直します。

# Zsh(macOS の既定)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Bash(ほとんどの Linux ディストリビューションの既定)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

macOS で Bash を使っている場合は、ターミナルがログインシェルとして起動して ~/.bashrc を読まないため、~/.bash_profile に書きます(~/.bash_login か ~/.profile が既にあり ~/.bash_profile がなければ、そちらに書きます)。

Windows PowerShell: Test-Path "$env:USERPROFILE\.local\bin\claude.exe" でファイルを確かめ、PATH に無ければユーザーの PATH に追加してターミナルを開き直します。

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

CMD の場合は、システムの環境変数の設定画面でユーザーの PATH に %USERPROFILE%\.local\bin を追加します。どの OS でも、最後に claude --version で確認します。

直したはずなのにまだ見つからない場合、公式ドキュメントは次の原因を挙げています。

追記時に zsh: permission denied: /Users/you/.zshrc のように設定ファイル自体に書き込めないと出た場合は、そのファイルを書き込み可能にする必要があります。

複数インストールの競合を解消する

Claude Code が複数の方法で入っていると、バージョンの食い違いや予期しない動作の原因になります。まず PATH 上にある claude をすべて列挙します。

# macOS / Linux
which -a claude

# Windows PowerShell
where.exe claude

macOS / Linux では、claude の出どころは次の3か所です。

場所中身確認コマンド
~/.local/bin/claudeネイティブインストーラー。~/.local/share/claude/versions/ へのシンボリックリンクls -la ~/.local/bin/claude
~/.claude/local/古いバージョンの Claude Code が作った旧式のローカル npm インストールls -la ~/.claude/local/
npm のグローバルnpm install -g によるインストールnpm -g ls @anthropic-ai/claude-code

ls が No such file or directory を返すのはエラーではなく、その場所に何も入っていないという意味です。~/.local/bin/claude があるのに which -a claude に出てこない場合は、前の節の PATH の問題です。

複数見つかったら1つだけ残します。推奨はネイティブインストール(~/.local/bin/claude、Windows では %USERPROFILE%\.local\bin\claude.exe)で、余分なものは次のように削除します。

# npm のグローバルインストール
npm uninstall -g @anthropic-ai/claude-code

# 旧式のローカル npm インストール(macOS / Linux)
rm -rf ~/.claude/local

# Homebrew(claude-code@latest を入れた場合はその名前で)
brew uninstall --cask claude-code

# WinGet
winget uninstall Anthropic.ClaudeCode

Windows の旧式ローカル npm インストールは、PowerShell で Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local" で削除します。

インストールスクリプトが失敗するとき

インストールコマンドが次のようなエラーで止まる場合、ダウンロードしたものがインストールスクリプトではなく、Web ページや XML、エラー応答だったことを示しています。

シェル出るエラー
Bash / Zshsyntax error near unexpected token `<' の後に <!DOCTYPE html>
PowerShellHTML や CSS を引用した iex の構文エラー、ParserError、または The term 'System.Xml.XmlDocument' is not recognized
CMD< was unexpected at this time. の後に返ってきたページの HTML
curlcurl: (22) The requested URL returned error: 403(本文なし)

エラー出力に「App unavailable in region」が含まれていれば、その国では Claude Code を利用できません。本文のない 403 は、同じ理由のほか社内プロキシやファイアウォールの遮断でも起きます。利用可能な国にいるのに 403 が出る場合は、前述のダウンロード元への到達確認を先に行います(代替のインストール方法も同じホストに接続するため)。それ以外はネットワークや一時的な障害のことが多く、公式ドキュメントの対処は次の2つです。

  1. 数分おいて再試行する
  2. 別のインストール方法を使う: macOS は brew install --cask claude-code、Windows は winget install Anthropic.ClaudeCode。ただし Homebrew や WinGet のインストールは、ネイティブインストールと違って既定では自動更新されない

Windows では、シェルとコマンドの取り違えもよくあります。The token '&&' is not a valid statement separator は CMD 用のコマンドを PowerShell で打った場合、'irm' is not recognized は PowerShell 用のコマンドを CMD で打った場合です。プロンプトが PS C:\ なら PowerShell 用の irm https://claude.ai/install.ps1 | iex を使います。

このほか、Linux で Killed と出る(メモリ不足。メモリを空けるかスワップを足す)、EACCES: permission denied(インストール先の権限)、unable to get local issuer certificate(社内の CA 証明書の設定)、Error loading shared library(musl と glibc のバイナリの取り違え)なども、対応表にそれぞれの対処が載っています。

ログインと認証のエラー

Claude Code を使うには Pro、Max、Ultra、Team、Enterprise、または Console のアカウントが必要で、無料の claude.ai プランには含まれません。原因がはっきりしないログイン失敗は、まずログインのやり直しで解消することがほとんどです。

  1. /logout で完全にサインアウトする
  2. Claude Code を閉じる
  3. claude で起動し直し、認証をもう一度行う

ブラウザが自動で開かない場合は、c を押すと OAuth の URL がクリップボードにコピーされるので、ブラウザに貼り付けます。主なエラーと対処は次のとおりです。

表示原因と対処
OAuth error: Invalid codeコードの期限切れか、コピー時の欠け。ブラウザが開いたら素早くログインを済ませる。SSH 越しだとブラウザが別のマシンで開くことがあるので、表示された URL を手元のブラウザで開く
API Error: 403 Request not allowedPro/Max/Ultra は claude.ai の設定でサブスクリプションが有効か確認。Console ユーザーは「Claude Code」か「Developer」ロールが付いているかを管理者に確認。社内プロキシが原因のこともある
Claude Code access has not been granted for this accountEnterprise 組織でロールが Custom になっており、Claude Code を許可するカスタムロールが割り当てられていない。Claude Code 側では直せないため、組織の Owner にロールの割り当てを依頼し、変更後にログインし直す
This organization has been disabled(有効なサブスクリプションがあるのに)古い ANTHROPIC_API_KEY 環境変数がサブスクリプションより優先されている。unset ANTHROPIC_API_KEY(PowerShell は Remove-Item Env:ANTHROPIC_API_KEY)で外し、シェルの設定ファイルからも削除する。/status で有効な認証方法を確認できる

WSL2・SSH・コンテナでログインできない: ブラウザが開かない、またはサインイン後に localhost への接続エラーになる場合でも、ターミナルに表示される別のログイン URL を使えば完了できます。URL を手元のブラウザで開いてサインインすると、localhost に戻る代わりにコードが表示されるので、それを Paste code here のプロンプトに貼り付けます。貼り付けが効かない場合は、標準入力からコードを読む claude auth login を使います。WSL2 では、BROWSER 環境変数に Windows 側のブラウザのパスを設定しておくと、次回から Windows のブラウザが開きます。

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

ログインが頻繁に切れる: /login で再認証します。トークンの検証は時刻に依存するため、何度も起きるならシステムの時計が正しいか確認します。macOS でキーチェーンに書き込めない場合は、ログインが平文の ~/.claude/.credentials.json に保存されます。claude doctor が macOS Keychain is not writable という警告を出すので、security unlock-keychain ~/Library/Keychains/login.keychain-db でロックを解除し、/logout と /login をやり直すとキーチェーンに戻せます。

Amazon Bedrock などのクラウドプロバイダー: Could not load credentials from any providers(Bedrock)、Could not load the default credentials(Google Cloud)、ChainedTokenCredential authentication failed(Microsoft Foundry)は、今のシェルでプロバイダーの CLI が認証されていないことが原因です。それぞれ aws sts get-caller-identity、gcloud auth application-default login、az login で確かめます。ターミナルでは動くのに IDE の拡張機能で動かない場合は、IDE がシェルの環境変数を受け継いでいないので、IDE の設定に環境変数を書くか、変数を設定したターミナルから IDE を起動します。

どれにも当てはまらない場合は、GitHub の Issue で既知の問題を探す(OS、実行したインストールコマンド、エラー出力の全文を添えて報告する)、claude doctor の診断を見る、起動できるならセッション内の /feedback で報告する、アカウント側の問題ならサポートに問い合わせる、の順に進めます。

本記事は Claude Code 公式ドキュメント「Troubleshoot installation and login」を元に、同じく公式の Advanced setup でインストール先・各インストールコマンド・claude doctor の役割・Homebrew と WinGet の自動更新の扱いを照合した非公式の日本語解説です(確認日 2026-11-17)。エラー文や手順は更新される可能性があるため、利用前に公式ドキュメントをご確認ください。