Claude Code は Anthropic が提供するコマンドライン AI アシスタントツールです。定期的にアップデートが提供されますが、時々アップデート時にエラーが発生することがあります。
本来は Claude Code 組み込みの update コマンドの実行でアップデートはできるのですが上手くできませんでした。
今回は実際に遭遇したエラーとその解決方法について説明します。
背景
Claude Code のアップデートを要求された
久しぶりに Claude Code 起動するとバージョンが低く起動ができまでした。
$ claude
╭─────────────────────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code! │
│ │
│ /help for help, /status for your current setup │
│ │
│ cwd: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx │
╰─────────────────────────────────────────────────────────────────╯
※ Tip: Press Esc twice to edit your previous messages
It looks like your version of Claude Code (1.0.15) needs an update.
A newer version (1.0.24 or higher) is required to continue.
To update, please run:
claude update
This will ensure you have access to the latest features and improvements.
# 勝手に Claude Code が終了した 😭😭😭
$メッセージに表示されている通りに、claude update を実行してバージョンアップを実施しました。
claude update を実行するとエラーが発生
Claude Code 組み込みのアップデートコマンドを実行した際に、以下のエラーが発生しました。
$ claude update
Current version: 1.0.15
Checking for updates...
New version available: 1.0.33 (current: 1.0.15)
Installing update...
Using global installation update method...
Error: Another instance is currently performing an update
Please wait and try again laterエラーの原因
このエラーメッセージ「Another instance is currently performing an update」は、既に別のアップデート処理が実行中であることを示しています。
おそらく以下のような状況で発生する可能性があるのだと思われます。
- 前回のアップデート処理が正常に終了していない
- バックグラウンドでアップデート処理が動作している
- アップデート処理がロックファイルを残したまま異常終了した
etc…
いずれにせよアップデートしないと Claude Code が使えなくて困るので原因を調査し、無事に解決できたので後述します。
Claude Code のアップデートエラー解決までの流れ
手順1: プロセス確認と再試行
まずは、メッセージにある通り、他の実行中のプロセスが原因でないか確認しました。
- 実行中のプロセスを確認
- Claude Code のプロセスを終了
- 数分待ってから再実行
実行したコマンドは下記の通りです。
# 実行中のプロセスの確認
$ ps aux | grep claude
# -> 自分の場合は何も動いていなかった
# Claude Code のプロセスを終了させる
## 今回はプロセスがなかったから実行はしていない
$ pkill -f claude
# 時間をおいてリトライ
$ claude updateしかし、この方法では問題が解決しませんでした。
そもそも実行中のプロセスがなかったので、実際は時間をおいてリトライしただけでした。
ただもし Claude Code の他のプロセスがあった場合は終了させることで解決する可能性は大いにあると思われます。
手順2: npm を使った直接アップデート（解決）
組み込みのアップデート機能で解決しなかったため、npm を直接使用してアップデートを実行しました。
npm update -g @anthropic-ai/claude-codeこの方法により、問題なくアップデートが完了しました。
余談
Claude Code のインストール先が Volta などのバージョン管理ツールになっていると claude update コマンドが成功しても起動してみるとバージョンが上がっていないなどの問題に直面することがあります。
そのときはインストール先を .claude 配下に移動させる必要があります。
細かい手順は下記の記事にまとめているので参考にしてみてください。
まとめ
Claude Code のアップデートエラーに遭遇した場合、まずプロセス確認を行い、それでも解決しない場合は npm を使った直接アップデートが効果的です。
今回の経験では、組み込みのアップデート機能では解決しませんでしたが、npm エコシステムの標準的なパッケージ管理機能を活用することで問題を解決できました。同様のエラーに遭遇した際の参考になれば幸いです。