💡

Claude Codeの自動アップデートが失敗する?

に公開

Claude Codeを立ち上げた際に下記のエラーメッセージが表示されることはないでしょうか?
✗ Auto-update failed · Try claude doctor or npm i -g @anthropic-ai/claude-code

これまで上記のエラーが発生した際には、一度アンインストールをしてから再インストールを行っていたのですが、公式のトラブルシューティングに対策がまとめられていました。

原因

npmでインストールを行った際に、/usr/usr/localが保存先として設定されていた場合、書き込み権限がなく上記のエラーが発生するようです。

解決策

npmのインストール先をホームディレクトリに変更する

# まず、後の移行のために既存のグローバルパッケージのリストを保存します
npm list -g --depth=0 > ~/npm-global-packages.txt

# グローバルパッケージ用のディレクトリを作成します
mkdir -p ~/.npm-global

# 新しいディレクトリパスを使用するようにnpmを設定します
npm config set prefix ~/.npm-global

# 注意:~/.bashrcを~/.zshrc、~/.profile、またはお使いのシェルに適した他のファイルに置き換えてください
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# 新しいPATH設定を適用します
source ~/.bashrc

# 新しい場所にClaude Codeを再インストールします
npm install -g @anthropic-ai/claude-code

# オプション:新しい場所に以前のグローバルパッケージを再インストールします
# ~/npm-global-packages.txtを確認し、保持したいパッケージをインストールしてください

引用元:https://docs.anthropic.com/ja/docs/claude-code/troubleshooting#推奨解決策:ユーザー書き込み可能なnpmプレフィックスを作成する

これでauto updateも問題なくされるようになりました。

Discussion