Claude Code は、ターミナルで claude update を実行すると最新版に更新できます。実行したら claude --version で結果を確認します。

claude update
claude --version

更新したのにバージョンが変わらない、権限エラーが出る、というときは、このあとの対処に進んでください。入れ直したいときはインストール・再インストール手順、会話が長くなったときの対処と API Error はコンテキスト管理の記事に分けました。

Claude Code の再インストール・インストール手順【Windows/Mac】認証エラーの直し方 | CODE PLUS(コードプラス) Claude Code の再インストール・インストール手順【Windows/Mac】認証エラーの直し方 | CODE PLUS(コードプラス) Claude Code のインストールと再インストールを Windows・Mac 別に解説。公式推奨のネイティブインストーラー、npm 版からの移行、command not found と認証エラー(/login)の直し方までまとめました。  続きを読む Claude Code のコンテキスト管理|/compact・/clear・/context の使い分けとエラー対処 | CODE PLUS(コードプラス) Claude Code のコンテキスト管理|/compact・/clear・/context の使い分けとエラー対処 | CODE PLUS(コードプラス) Claude Code のコンテキストが溢れた時の対処を解説。/context で使用量を確認し、/compact と /clear を使い分ける方法、API Error 400 と 429 の原因と直し方もまとめました。Claude Code の...  続きを読む

    インストール方法によって、更新のしかたが違う

    ネイティブ版(公式の推奨)は自動で更新されます。起動時と実行中に新しいバージョンを確認し、裏で入れて、次に起動したときに反映します。claude update は、それを待たずに今すぐ更新したいときのコマンドです。Homebrew や WinGet で入れた場合は自動更新されないので、手動で更新します。

    インストール方法 更新のしかた
    ネイティブインストーラー 自動更新。今すぐなら claude update
    Homebrew brew upgrade claude-code(latest 版のcaskは brew upgrade claude-code@latest)
    WinGet winget upgrade Anthropic.ClaudeCode
    apt / dnf / apk 手動。apt なら sudo apt update && sudo apt upgrade claude-code
    npm(非推奨) 書き込み権限がないと自動更新できず、起動時に通知が出る。claude doctor で対処法を確認

    Homebrew と WinGet は、更新の通知が出ても、パッケージ側にまだ新しいバージョンが届いていないことがあります。upgrade が失敗したら、少し待ってからやり直してください。

    自動更新が止まっているときは、settings.json に DISABLE_AUTOUPDATER が入っていないか確認します。この設定が止めるのは裏での自動更新だけで、claude update は使えます。

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

    受け取るバージョンの早さは、/config の「Auto-update channel」で選べます。latest(既定)は新機能をすぐ受け取り、stable は約1週間遅れで、大きな不具合のある版を飛ばします。

    まず、バージョンとインストール場所を確認する

    何を使っているか分からないまま直そうとすると、遠回りになります。最初にこの3つを実行します。

    claude --version
    which claude
    claude doctor

    Windows の PowerShell では、which claude の代わりに Get-Command claude を使います。claude doctor は、インストールの状態を診断して、直し方を示します。Claude Code の中ではなく、ふつうのシェルから実行してください。

    which claude の結果で、どの方法で入れたかが分かります。

    結果 状況
    /Users/xxx/.nvm/versions/node/vXX.X.X/bin/claude nvm 経由の npm グローバルインストール
    /Users/xxx/.npm-global/bin/claude npm-global 経由
    /Users/xxx/.claude/local/claude 旧方式のローカルインストール
    /Users/xxx/.local/bin/claude ネイティブ版(置き場所の一例)
    claude: aliased to /Users/xxx/.claude/local/claude エイリアスで古い版を指している

    エラーメッセージ別の対処

    エラーメッセージ・症状 原因 対処
    A newer version (X.X.X or higher) is required to continue Claude Code が古い claude update
    API Error: 400 ... does not support this model; version X.X.X or newer is required 使おうとしたモデルに、今のバージョンが対応していない claude update。デスクトップアプリ経由なら、アプリも更新
    Insufficient permissions to install update インストール先に書き込めない sudo を付ける前に、下の「npm 版の権限エラー」を確認
    EACCES: permission denied npm のグローバル領域の権限 下の「npm 版の権限エラー」
    zsh: no such file or directory: /Users/.../claude 古い PATH やエイリアスが残っている 下の「複数インストール」の Step 1
    /plugin が動かない バージョンが古い claude update
    command not found: claude 未インストール、または PATH が通っていない インストール手順
    API Error: 401、OAuth token has expired 認証が切れている インストール手順の認証エラー
    API Error: 400(non-empty content)、API Error: 429 会話履歴の不具合、利用上限 コンテキスト管理

    バージョンが変わらない時は、複数インストールを疑う

    claude update で更新しても古いままなら、別の場所にある古い claude が先に呼ばれている可能性があります。npm 版、旧ローカル版、ネイティブ版が混在していると起きます。

    Step 1: エイリアスと PATH を確認する

    alias | grep claude
    echo $PATH | tr ':' 'n' | grep -i claude
    grep -r "claude" ~/.zshrc ~/.zprofile ~/.bashrc ~/.bash_profile 2>/dev/null

    次のような行があれば、削除します。

    alias claude="/Users/xxx/.claude/local/claude"
    export PATH="$HOME/.claude/local:$PATH"

    .zshrc には、他のツールが追加した行も混ざります。Claude に関係すると確認できた行だけを消してください。消したら、設定を読み込み直します。

    source ~/.zshrc
    hash -r

    Step 2: 入っている場所をすべて探す

    ls -la ~/.npm-global/bin/claude 2>/dev/null && echo "Found in .npm-global"
    ls -la ~/.claude/local/claude 2>/dev/null && echo "Found in .claude/local"
    ls -la ~/.nvm/versions/node/$(node -v)/bin/claude 2>/dev/null && echo "Found in nvm"
    ls -la ~/.local/bin/claude 2>/dev/null && echo "Found in .local/bin"

    Step 3: 1つに統一する

    公式の推奨はネイティブ版です。npm 版と旧ローカル版を消して、ネイティブ版だけを残します。

    npm uninstall -g @anthropic-ai/claude-code
    rm -rf ~/.claude/local
    hash -r

    ネイティブ版の入れ方はインストール手順にあります。入れたあとに which claude と claude --version で確認してください。消すのは ~/.claude/local だけです。~/.claude 全体には設定ファイルが入っているので、消さないでください。

    npm 版の権限エラー(EACCES)の直し方

    次のエラーは、過去に sudo npm install -g を実行して、ファイルの所有者が root になっていることが原因です。

    npm error code EACCES
    npm error syscall rename
    npm error path /Users/xxx/.nvm/versions/node/vXX.X.X/lib/node_modules/@anthropic-ai/claude-code

    公式も sudo npm install -g は使わないよう案内しています。nvm 環境では、所有権を自分に戻してから入れ直します。

    # 1. 所有者を確認(root なら問題あり)
    ls -la ~/.nvm/versions/node/$(node -v)/lib/node_modules/@anthropic-ai/
    
    # 2. 所有権を自分に戻す
    sudo chown -R $(whoami) ~/.nvm/versions/node/$(node -v)/lib/node_modules/@anthropic-ai/
    
    # 3. sudo なしで入れ直す
    npm uninstall -g @anthropic-ai/claude-code
    npm install -g @anthropic-ai/claude-code
    
    # 4. 確認
    claude --version

    nvm を使っていない環境では、npm のグローバル領域を自分のホームに変える方法もあります。

    mkdir -p ~/.npm-global
    npm config set prefix ~/.npm-global
    echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
    source ~/.zshrc

    ただ、npm 版は非推奨になっています。権限まわりで何度も詰まるなら、ネイティブ版に移すほうが早く片づきます。

    Claude デスクトップアプリの更新は別の手順

    claude update は、ターミナルで使う Claude Code のコマンドです。デスクトップアプリの更新には使えません。

    アプリの画面に更新の案内が出たら、メニュー(☰、または Alt キー)から「Help」→「Check for updates…」を選び、更新後に再起動します。Microsoft Store から入れた場合は、ストア側で更新します。

    それでも直らない時の順番

    1. claude --version、which claude、claude doctor で現状を確認する
    2. claude update を実行する
    3. バージョンが変わらなければ、複数インストールを整理する
    4. 権限エラーなら、npm 版の所有権を直すか、ネイティブ版に移す
    5. 認証エラーなら、インストール手順の認証の節を見る
    6. 最後は、再インストールする

    関連記事

    Claude Code の再インストール・インストール手順【Windows/Mac】認証エラーの直し方 | CODE PLUS(コードプラス) Claude Code の再インストール・インストール手順【Windows/Mac】認証エラーの直し方 | CODE PLUS(コードプラス) Claude Code のインストールと再インストールを Windows・Mac 別に解説。公式推奨のネイティブインストーラー、npm 版からの移行、command not found と認証エラー(/login)の直し方までまとめました。  続きを読む Claude Code のコンテキスト管理|/compact・/clear・/context の使い分けとエラー対処 | CODE PLUS(コードプラス) Claude Code のコンテキスト管理|/compact・/clear・/context の使い分けとエラー対処 | CODE PLUS(コードプラス) Claude Code のコンテキストが溢れた時の対処を解説。/context で使用量を確認し、/compact と /clear を使い分ける方法、API Error 400 と 429 の原因と直し方もまとめました。Claude Code の...  続きを読む Claude Code の settings.json コピペで使えるおすすめ設定まとめ【2026年版】 | CODE PLUS(コードプラス) Claude Code の settings.json コピペで使えるおすすめ設定まとめ【2026年版】 | CODE PLUS(コードプラス) Claude Code の settings.json のおすすめ設定をコピペ用コードと共に解説。permissions・hooks・env の各項目の意味、グローバルとローカルの使い分け、statusLine などの応用設定まで網羅した実践ガイド...  続きを読む Claude Code プラグインおすすめ5選|重複を避ける選び方とトークン管理 | CODE PLUS(コードプラス) Claude Code プラグインおすすめ5選|重複を避ける選び方とトークン管理 | CODE PLUS(コードプラス) Claude Code のプラグインは入れれば入れるほど context を消費します。superpowers・commit-commands・security-guidance など常用5選と、役割が重複して入れてはいけない組み合わせ、LSP プ...  続きを読む