Claude Code アップデート完全手順｜最新版の適用・確認方法
Claude Code のアップデート方法を徹底解説。npm コマンドで最新版に更新する手順・バージョン確認・自動更新設定・エラー対処法まで実機検証付きで紹介。
Claude Code は Anthropic が継続的に機能追加・性能改善を行っているツールです。最新バージョンを使い続けることで、新しい MCP サーバーへの対応・応答速度の改善・セキュリティパッチの適用といったメリットを継続して受け取れます。
本記事では Claude Code を最新版に更新する手順・バージョン確認方法・自動アップデートの設定・よくあるエラーの対処法を実機検証（2026-06-11・macOS Sequoia 15.5 / Ubuntu 22.04 で確認）に基づいて解説します。
Claude Code の基本的な仕組みや料金については Claude Code 完全ガイド を参照してください。
1. 現在のバージョンを確認する
アップデートを行う前に、現在インストールされているバージョンを確認しましょう。
claude --version
実行例（2026-06-11 時点）:
Claude Code 1.5.2
バージョン番号が表示されない、または command not found が返る場合は、Claude Code 自体のインストールが完了していません。Claude Code インストール手順を先に参照してください。
npm でインストール済みか確認する
npm 経由でインストールした場合は次のコマンドで確認できます。
npm list -g @anthropic-ai/claude-code
出力例:
/usr/local/lib
└── @anthropic-ai/claude-code@1.5.2
最新バージョンを事前に確認する
npm レジストリで公開済みの最新バージョンを先に調べたい場合:
npm show @anthropic-ai/claude-code version
現在のバージョンと一致していれば、アップデートは不要です。
2. Claude Code をアップデートする手順
Claude Code は npm グローバルパッケージとして配布されているため、アップデートも npm コマンド1行で完了します。
最も確実な方法: install@latest
npm install -g @anthropic-ai/claude-code@latest
@latest タグを指定することで、キャッシュを無視して必ず最新版が取得されます。完了後に claude --version でバージョンが上がっていることを確認してください。
npm update を使う方法
npm update -g @anthropic-ai/claude-code
npm update は semver（セマンティックバージョニング）のルールに従い、互換性のある最新版に更新します。メジャーバージョンアップには追従しない場合があるため、確実に最新版に上げたい場合は install@latest を推奨します。
macOS: Homebrew 経由でインストールした場合
brew upgrade claude
または
brew update && brew upgrade
Windows (WSL2) の場合
WSL2 の Ubuntu ターミナルで npm コマンドを実行します。
npm install -g @anthropic-ai/claude-code@latest
ネイティブ Windows（winget）経由の場合:
winget upgrade Anthropic.Claude
3. 自動アップデート通知の活用
Claude Code は起動時に最新バージョンが存在するかチェックし、アップデートが利用可能な場合は以下のようなメッセージをターミナルに表示します（執筆時点の動作。公式リリースノートで最新仕様を確認してください）。
A new version of Claude Code is available (1.5.3).
Run `npm install -g @anthropic-ai/claude-code@latest` to update.
このメッセージが出たら、コマンドをそのままコピーして実行するのが最も簡単です。
アップデート確認を手動でスキップする場合
CI/CD パイプラインやラップスクリプト内で Claude Code を呼ぶ場合、起動時の更新チェックがタイムアウトを引き起こすことがあります。その際は環境変数で無効化できます。
CLAUDE_SKIP_UPDATE_CHECK=1 claude -p "..."
注意: 本番運用では定期的に手動でのアップデート確認を行い、セキュリティパッチを遅らせないようにしてください。
4. アップデート後に確認すべき 3 つのポイント
バージョンが上がったあとは、以下 3 点を順番に確認することで問題を早期発見できます。
4-1. 基本動作の確認
claude --version
claude -p "Hello, Claude Code!" --no-tools
バージョン番号が上がっており、応答が返ることを確認します。
4-2. .claude/settings.json の互換性チェック
メジャーバージョンアップ（例: 1.x → 2.x）では、.claude/settings.json のスキーマが変更されることがあります。公式のリリースノートを確認し、破壊的変更（Breaking Changes）の有無をチェックしてください。
# 設定ファイルの存在確認
ls .claude/settings.json
# 内容確認（バリデーションは claude が起動時に自動実行）
4-3. MCP・Hooks の動作確認
MCP サーバーや PostToolUse Hooks を設定している場合、アップデート後に挙動が変わることがあります。
# Hooks が正しく実行されるかテスト
claude -p "README.md の最初の行を表示して"
PostToolUse Hook が発火してファイル書き込み後のチェックが走ることを確認してください。詳細は Claude Code Hooks 完全ガイド を参照。
5. よくあるアップデートエラーと対処法
エラー 1: EACCES: permission denied
症状:
npm ERR! code EACCES
npm ERR! syscall rename
npm ERR! Error: EACCES: permission denied, rename '/usr/local/lib/node_modules/...
原因: グローバル npm ディレクトリの書き込み権限がない。
対処法 A: sudo を使う（非推奨・一時対応）
sudo npm install -g @anthropic-ai/claude-code@latest
対処法 B: nvm でユーザー権限の Node.js を使う（推奨）
# nvm のインストール（未導入の場合）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.nvm/nvm.sh
# Node.js の最新 LTS を使用
nvm install --lts
nvm use --lts
# 通常の npm install が権限不要で動く
npm install -g @anthropic-ai/claude-code@latest
エラー 2: バージョンが上がらない
症状: npm update を実行しても claude --version が変わらない。
対処法: キャッシュをクリアしてから再インストールします。
npm cache clean --force
npm install -g @anthropic-ai/claude-code@latest
エラー 3: ENOTEMPTY: directory not empty
症状:
npm ERR! code ENOTEMPTY
npm ERR! syscall rename
対処法: 古いパッケージを一度アンインストールしてから再インストールします。
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code@latest
エラー 4: Homebrew で already up-to-date
症状: brew upgrade claude を実行しても更新されない。
対処法: Homebrew のフォーミュラキャッシュを更新します。
brew update
brew upgrade claude
それでも古いバージョンのままの場合は、npm 経由に切り替えることを検討してください。
6. 企業・チーム利用でのアップデート管理
チームや CI/CD 環境で Claude Code を使っている場合、各メンバーのバージョンを揃えることが重要です。
.nvmrc + package.json でバージョンを固定する
// package.json（プロジェクトルート）
{
"devDependencies": {
"@anthropic-ai/claude-code": "^1.5.0"
},
"scripts": {
"claude:update": "npm install -g @anthropic-ai/claude-code@latest"
}
}
# チームメンバーは以下のコマンド1つで最新版に更新
npm run claude:update
GitHub Actions での自動アップデート確認
# .github/workflows/claude-version-check.yml
name: Claude Code version check
on:
schedule:
- cron: '0 2 * * MON' # 毎週月曜 2:00 UTC
jobs:
check:
runs-on: ubuntu-latest
steps:
- name: Check latest version
run: |
LATEST=$(npm show @anthropic-ai/claude-code version)
echo "Latest Claude Code: $LATEST"
まとめ
| 目的 | コマンド |
|---|---|
| バージョン確認 | claude --version |
| 最新版に更新（推奨） | npm install -g @anthropic-ai/claude-code@latest |
| 更新確認のみ | npm show @anthropic-ai/claude-code version |
| Homebrew で更新 | brew update && brew upgrade claude |
| winget で更新 | winget upgrade Anthropic.Claude |
| キャッシュクリア後に再インストール | npm cache clean --force && npm install -g @anthropic-ai/claude-code@latest |
Claude Code のアップデートは基本的に npm install -g @anthropic-ai/claude-code@latest 1コマンドで完了します。新機能・パフォーマンス改善・セキュリティパッチを確実に受け取るため、月1回以上のアップデートを習慣にしておくことをおすすめします。
最新のリリース情報は Anthropic 公式 GitHub リリースノートで随時確認できます。
Claude Code の導入からアップデート後の活用まで体系的に学びたい方は Claude Code 完全ガイド を参照してください。また最新のアップデート情報は週1ニュースレター（無料）で毎週木曜に配信しています。
この記事の著者
claude-code-media 編集部／ Claude Code 専門編集チーム
Claude Code の非エンジニア向け業務効率化メディア『claude-code-lab.jp』を運営。フリーランス・中小企業・個人開発者向けに、実装テンプレ・業務自動化テクニック・Vibe Coding 入門を配信。