Claude Code は、ターミナルで claude update を実行すると最新版に更新できます。実行したら claude --version で結果を確認します。
claude update
claude --version
更新したのにバージョンが変わらない、権限エラーが出る、というときは、このあとの対処に進んでください。入れ直したいときはインストール・再インストール手順、会話が長くなったときの対処と API Error はコンテキスト管理の記事に分けました。
インストール方法によって、更新のしかたが違う
ネイティブ版(公式の推奨)は自動で更新されます。起動時と実行中に新しいバージョンを確認し、裏で入れて、次に起動したときに反映します。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 から入れた場合は、ストア側で更新します。
それでも直らない時の順番
claude --version、which claude、claude doctorで現状を確認するclaude updateを実行する- バージョンが変わらなければ、複数インストールを整理する
- 権限エラーなら、npm 版の所有権を直すか、ネイティブ版に移す
- 認証エラーなら、インストール手順の認証の節を見る
- 最後は、再インストールする
関連記事
Claude Code の再インストール・インストール手順【Windows/Mac】認証エラーの直し方 | CODE PLUS(コードプラス)