Claude Code実践ガイド
Claude Codeのアップデート方法｜更新とバージョン確認
Claude Codeは更新が非常に頻繁です。そして実務上いちばん役に立つ知識は、「調子が悪いと感じたら、原因を調べる前にまず更新する」という一点に尽きます。既に修正済みの不具合を何時間もかけて調査するのが、最ももったいない時間の使い方だからです。
このサイトは Anthropic や Claude の公式サイトではありません。Claudeの基本的な使い方、ChatGPTとの違い、文章作成・長文整理・仕事での活用を初心者向けに整理するガイドです。機能・料金・提供状況は変更される可能性があるため、重要な判断ではAnthropic公式情報も確認してください。
更新コマンド
| 操作 | コマンド |
|---|---|
| 更新する | claude update（npmで入れた場合は npm install -g @anthropic-ai/claude-code@latest。公式は npm update -g を避けるよう案内しています。Homebrewは brew upgrade claude-code、WinGetは winget upgrade Anthropic.ClaudeCode） |
| 今のバージョンを見る | claude --version |
| 入った更新を反映して再起動する | /restart（別名 /update）。自動更新で入った新しい版を、会話を引き継いだまま反映します。macOS・Linuxのネイティブ版（WSLは除く）かつPro・Max・Ultraプラン、v2.1.288以降が対象です |
| 確実に入れ直す | アンインストール後、再インストール（後述） |
更新は数十秒で終わります。作業中でも、区切りのタイミングでこまめに実行して構いません。更新後は起動し直してください。
なぜ更新が効くのか
Claude Codeは開発の速いプロダクトで、機能追加と不具合修正が短い周期で配信されます。そのため、次のような症状は更新するだけで消えることが頻繁にあります。
- 特定の操作で止まる・落ちる
- 表示が崩れる、文字がおかしい
- 以前は動いていた機能が動かない
- エラーメッセージの意味が分からない
逆に言うと、ネット上で見つけた「不具合の対処法」が、既に不要になっていることも珍しくありません。古い情報に従って設定をいじる前に、まず更新して再現するか確かめてください。この順番だけで解決までの時間が大きく変わります。
更新の習慣づけ
毎回手で打つのは続かないので、次のどれかを習慣にすると楽です。
- 不調を感じたら反射的に更新──最も実用的です。「おかしい」と思った瞬間の1コマンドを癖にします
- 週の初めに更新──月曜の作業開始時など、決まったタイミングで
- 新機能の話を見かけたら更新──使いたい機能が入っていない原因は、たいてい古いバージョンです
ネイティブインストーラーで入れた場合は、バックグラウンドで自動更新され、次に起動したときに反映されます（Homebrew・WinGet・apt・dnf・apkは自動では更新されません）。それでも手元のバージョンを自分で把握しておく価値はあります。不具合を報告するときにも、バージョン番号は必ず聞かれる情報です。
更新後に不具合が出た場合
まれに、更新が原因で不調になることもあります。順に試してください。
- 起動し直す──更新の反映には再起動が必要です。これで解決する場合が多いです
- もう一度更新をかける──更新の途中で止まっていた可能性があります
- 入れ直す──下の表の方法でアンインストールしてから再インストール。ネイティブ版は
claude installでも入れ直せます - 設定を疑う──ユーザーフォルダの
.claudeを削除せずリネームして退避し、起動してみます。これで直れば設定が原因だと分かります - 報告する──再現手順が明確なら
/bugで開発チームに送れます。修正の速いプロダクトなので、報告する価値があります
アンインストール
| 目的 | やること |
|---|---|
| 本体を消す | ネイティブ版は、Windows PowerShell なら Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force と Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force、Mac・Linux なら rm -f ~/.local/bin/claude と rm -rf ~/.local/share/claude。npm版は npm uninstall -g @anthropic-ai/claude-code、Homebrewは brew uninstall --cask claude-code、WinGetは winget uninstall Anthropic.ClaudeCode |
| 設定・履歴も消す | 上記に加えて、ユーザーフォルダの .claude と .claude.json を削除 |
| 一時的に退避したい | .claude をリネームして残す（後で戻せます） |
アンインストールしてもプロジェクト内の CLAUDE.md や設定はそのまま残ります。作業した成果物やgitの履歴も当然残るので、入れ直せば元の環境に戻れます。
最近の版で変わったこと（2.1.312）
公式の CHANGELOG（2026年10月28日に確認）の 2.1.312 には、日常の使い方に関係する変更があります。GitHub のリリース v2.1.312の公開は2026年10月27日（UTC）です。自分の版は claude --version で確かめ、古ければ上の手順で更新します。
- 上限の呼び名──利用上限の案内が「session limit」ではなく「5-hour limit」と表示されるようになりました。VS Code 拡張では、リセットが「Resets at 3:10 PM」のような時刻で出ます。
- 作業中の effort の変更──作業中に
/effortで変えた時、入力欄に「次のメッセージまで反映が待たれることがある」と案内が出ます。画面や履歴には、モデルに実際に効いているレベルが出ます。 - 大きな CLAUDE.md の上書き防止──とても大きな CLAUDE.md やルールファイル、@ で取り込んだファイルを、先頭だけ読んで上書きしてしまう問題が直りました。Write は、全部読むか、その場で編集するよう Claude に求めます。
- 独自の名前でモデルを使う環境──Bedrock・Vertex・Foundry・Mantle で、独自のデプロイ名や推論プロファイルの ARN のように Claude Code が知らない名前を使うと、Sonnet や Haiku を指していても短いシステムプロンプトを使います。完全版に戻すには
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0を設定します。フラグが立ったメッセージの後の自動のモデル切り替えもこの名前が対象になり、止めるにはCLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1を設定します。 - VS Code 拡張──サインイン後に、管理設定や組織のポリシーが取得されなくなる問題が直りました。組織の設定が読めなかった時は、理由と「Retry」「Sign in again」が出ます。
ほかにも細かな修正が多数あります。全文は公式の CHANGELOG で確かめてください。
バージョンが分からなくなったとき
claude --version が動かない場合、そもそもインストールが壊れているか、パスが通っていません。切り分け方はインストールのページにまとめました。
また、更新しても症状が変わらない場合は、更新以外の原因を疑う段階です。障害・利用枠・環境のどれかで、切り分け手順は動かない時の対処法と障害・稼働状況の確認にあります。
AIガイド群
FAQ
更新はどのくらいの頻度でありますか？
短い周期で配信されます。数日単位で新しいバージョンが出ることも珍しくないため、「久しぶりに使う」場合はまず更新するのが確実です。
更新で設定は消えますか？
消えません。CLAUDE.md、Skills、hooks、権限設定などはそのまま残ります。
更新すると料金は変わりますか？
変わりません。更新は無料です。プランや利用枠の仕組みは料金ページを参照してください。
古いバージョンに戻せますか？
インストーラーやnpmでバージョンを指定して入れ直すことは可能ですが、通常は推奨されません。問題があるなら報告して修正を待つ方が、結果的に早く解決します。
編集：ちんあなご編集部 最終確認：（公式の情報と照らした日）
製品の仕様や料金は、Anthropicの公式（ドキュメント、ヘルプ）を基準に確かめています。誤りや古い情報はお問い合わせからお知らせください。