Cara memperbarui Claude Code ke versi terbaru pada 2026

Claude Code berubah hampir setiap hari. Anda membuka changelog terbaru dan menemukan perintah baru, bug yang diperbaiki, serta peningkatan kecepatan. Sementara itu, terminal Anda menjalankan build dari dua minggu lalu, dan separuh peningkatan itu sama sekali tidak berfungsi. Claude juga tidak memberi tahu Anda: program berjalan seperti biasa, dan Anda bertanya-tanya mengapa orang lain memiliki fitur yang tidak Anda miliki.

Saya akan menjelaskan cara memeriksa versi, memperbaruinya ke versi terbaru, dan apa yang harus dilakukan jika pembaruan tidak terpasang. Perintah-perintah ini dikutip persis dari dokumentasi resmi Claude Code dan telah diperiksa pada awal September 2026. Saat itu, versi terbaru yang diterbitkan adalah 2.1.261, tetapi nomor versi Anda akan berbeda. Tidak perlu mengejar nomor tertentu—yang penting adalah menggunakan build yang relatif baru.

Informasi tentang penggunaan Ailoot tersedia di dokumentasi.

Bagaimana cara cepat memperbarui Claude Code ke versi terbaru?#

Saya akan menjelaskan setiap kasus secara terperinci di bawah, tetapi jika waktu Anda terbatas, berikut tiga perintah yang mencakup hampir semua situasi.

claude --version   # versi yang terpasang saat ini
claude update      # perbarui sekarang (instalasi native)
claude doctor      # periksa instalasi dan pembaruan

Perintah pertama menampilkan versi Anda, perintah kedua memperbaruinya, dan perintah ketiga mendiagnosis masalah jika terjadi sesuatu. Di bawah, saya akan menjelaskan kapan menggunakan masing-masing perintah dan mengapa claude update tidak berfungsi bagi sebagian orang.

Bagaimana cara memeriksa versi Claude Code yang sedang terpasang?#

Sebelum memperbarui, sebaiknya ketahui versi yang sedang Anda gunakan. Perintahnya sederhana:

claude --version

Anda akan mendapatkan baris seperti 2.1.211 (Claude Code). Itulah versi Anda saat ini. Bandingkan dua angka pertama dengan nomor terbaru di changelog—jika versi Anda jauh lebih rendah, sudah waktunya memperbarui.

Jika Anda ingin gambaran yang lebih luas, jalankan claude doctor. Perintah ini hanya memeriksa dan tidak mengubah apa pun: perintah ini tidak memulai sesi, tetapi menampilkan status instalasi, kesalahan dalam file pengaturan, serta peringatan dengan saran siap pakai tentang hal yang perlu diperbaiki. Perintah ini juga menampilkan hasil percobaan pembaruan otomatis terakhir—berguna jika Anda menduga pembaruan di latar belakang diam-diam gagal terpasang.

Apakah Claude Code memperbarui dirinya sendiri?#

Semuanya bergantung pada cara Anda memasang Claude Code. Instalasi native—yang direkomendasikan Anthropic dan dipasang melalui skrip situs web—dapat memperbarui dirinya sendiri, dan dokumentasi menyatakannya secara eksplisit.

Begini cara kerjanya: Claude Code memeriksa pembaruan saat mulai dan secara berkala ketika sedang berjalan. Jika menemukan versi baru, program ini mengunduh dan memasangnya di latar belakang, lalu menerapkannya saat Anda menjalankannya lagi. Cukup tutup dan buka kembali sesi Anda setiap beberapa hari, dan Anda akan kembali menggunakan versi terbaru.

Anda dapat memeriksa hasil percobaan latar belakang terakhir dengan perintah claude doctor yang sama. Perintah ini akan menunjukkan apakah pembaruan gagal terpasang karena suatu alasan.

Namun, jika Anda memasang Claude Code melalui pengelola paket—Homebrew di MacBook, WinGet di Windows, apt atau dnf di Linux—tidak ada pembaruan di latar belakang. Instalasi tersebut diperbarui dengan perintah upgrade yang biasa Anda gunakan; bagian tersendiri di bawah membahasnya.

Versi Claude Code yang baru adalah fondasi, tetapi itu saja tidak cukup. Hasil yang konsisten bukan berasal dari versi alat, melainkan dari cara Anda menggunakannya.

Bagaimana cara memperbarui Claude Code secara manual dengan satu perintah?#

Anda tidak perlu menunggu pemeriksaan latar belakang untuk mengetahui adanya versi baru. Ada perintah untuk memperbaruinya sekarang:

claude update

Ada dua kemungkinan hasil. Jika pembaruan ditemukan dan dipasang, Claude Code akan menampilkan baris seperti Successfully updated from <old version> to version <new version>. Jika Anda sudah menggunakan build terbaru, Anda akan mendapatkan Claude Code is up to date (<version>)—artinya tidak ada yang perlu diperbarui.

Ada satu hal yang perlu diperhatikan terkait perintah ini saat menggunakan pengelola paket. Jika Claude Code dipasang melalui Homebrew, WinGet, atau apk, claude update memberikan respons yang lebih singkat—Claude is up to date!—dan tidak selalu mengambil build baru dengan sendirinya. Untuk instalasi ini, lebih andal menggunakan perintah upgrade dari pengelola paket itu sendiri, yang dijelaskan di bawah.

Bagaimana cara memperbarui Claude Code yang dipasang melalui Homebrew atau WinGet?#

Jika Anda memasang Claude Code melalui pengelola paket, bukan skrip situs web, Anda bertanggung jawab untuk memperbaruinya. Berikut perintah untuk setiap sistem.

Di macOS dengan Homebrew:

brew upgrade claude-code

Ada dua pilihan di Homebrew. Homebrew memasang Claude Code dalam dua varian. Varian claude-code mengikuti saluran stabil—versi yang tertinggal sekitar satu minggu dan melewati rilis yang memiliki masalah besar. Varian claude-code@latest mendapatkan versi terbaru segera setelah dirilis. Perbarui varian yang Anda pasang: jika Anda memiliki claude-code@latest, perintahnya adalah brew upgrade claude-code@latest.

Di Windows dengan WinGet:

winget upgrade Anthropic.ClaudeCode

Dengan WinGet, upgrade terkadang gagal saat Claude Code sedang berjalan karena Windows sedang menggunakan file executable-nya. Claude Code hanya akan menampilkan perintah manual; tutup program ini lalu jalankan upgrade lagi.

Di Linux dengan apt, dnf, atau apk, tidak ada perintah terpisah yang perlu dipelajari—versi terbaru tiba bersama pembaruan sistem biasa karena Claude Code menerbitkan repositori bertanda tangan.

Jika Anda tidak ingin mengingat hal ini, tersedia variabel lingkungan CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE. Tetapkan nilainya ke 1, dan Claude Code akan menjalankan upgrade di latar belakang dengan Homebrew dan WinGet, lalu menyarankan Anda memulai ulang setelah pembaruan berhasil. Dokumentasi menyertakan catatan: Claude Code terkadang memberi tahu Anda tentang versi baru sebelum versi itu benar-benar tersedia di pengelola paket. Jika upgrade tidak menemukan pembaruan, tunggu sebentar lalu coba lagi.

Omong-omong, jika Anda masih memilih cara memasang Claude Code, ada panduan terperinci di artikel terpisah tentang memasang Claude Code—termasuk alasan penginstal native lebih praktis daripada pengelola paket.

Mengapa Claude Code tidak mau diperbarui, dan apa yang harus dilakukan?#

Terkadang Anda memperbarui berulang kali, tetapi claude --version tetap menampilkan nomor versi lama. Saya akan membahas penyebab utama, dimulai dari yang paling umum.

Hal pertama yang perlu diperiksa adalah apakah Anda memiliki beberapa instalasi Claude Code sekaligus. Ini bisa terjadi jika Anda memasangnya lebih dulu melalui npm, lalu memasangnya kembali secara native. Perintah memperbarui satu salinan, tetapi terminal menjalankan salinan lain, sehingga versi tampak tidak berubah. Periksa berapa banyak salinan yang Anda miliki:

which -a claude

Claude Code mungkin berada di tiga tempat: ~/.local/bin/claude adalah penginstal native, ~/.claude/local/ adalah instalasi npm lokal lama dari versi-versi awal, dan paket npm global ditampilkan oleh perintah npm -g ls @anthropic-ai/claude-code. Jika menemukan lebih dari satu, sisakan satu saja—sebaiknya instalasi native. Hapus sisanya seperti ini:

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/local

Penyebab umum kedua adalah folder npm global yang tidak dapat ditulisi. Jika Anda memasang Claude Code secara global dengan npm dan program ini tidak memiliki izin untuk menulis ke foldernya, pembaruan di latar belakang tidak akan terpasang. Claude Code menampilkan satu kali notifikasi saat mulai, dan claude doctor mencantumkan hal yang perlu diperbaiki. Itulah alasan lain untuk memilih instalasi native: instalasi ini menulis ke folder home Anda dan tidak memerlukan izin tersebut.

Situasi ketiga adalah Anda pernah mengganti peluncur ~/.local/bin/claude dengan skrip atau symlink sendiri. Mulai versi 2.1.207, pembaruan otomatis membiarkan peluncur seperti itu tetap digunakan: versi baru tetap dipasang di folder ~/.local/share/claude/versions/, tetapi skrip Anda menentukan versi yang dijalankan. Jangan menghapus satu-satunya peluncur lalu memanggil claude update berdasarkan nama. Pertama, simpan peluncur khusus dan, untuk symlink, targetnya di lokasi cadangan terpisah yang belum digunakan. Pindahkan peluncur dari jalur aslinya hanya setelah salinan diverifikasi. Pulihkan peluncur native menggunakan installer resmi, yang tidak bergantung pada perintah claude yang sudah ada:

# macOS, Linux atau WSL: installer native resmi
curl -fsSL https://claude.ai/install.sh | bash

Setelah installer selesai, buka terminal baru dan verifikasi hasilnya:

claude --version
claude doctor

Perintah pertama harus mencetak nomor versi. Periksa keluaran doctor untuk peringatan peluncur atau PATH sebelum melanjutkan; jangan hapus peluncur yang disimpan sampai penggantinya berfungsi.

Gejala lainnya adalah claude update atau claude doctor macet segera setelah baris Checking for updates. Pada versi lama (sebelum 2.1.214), hal ini terkadang terjadi ketika salah satu file konfigurasi shell, seperti ~/.zshrc, berupa direktori, bukan file. Build terbaru kini melewati kondisi ini, jadi memperbarui ke versi terbaru juga memperbaiki bug tersebut.

Bagaimana cara memilih saluran pembaruan: latest atau stable?#

Memperbarui ke versi terbaru tidak selalu berarti mengambil build paling baru pada hari pertama rilis. Claude Code memungkinkan Anda memilih di antara dua saluran, yang menentukan apa yang Anda terima saat memperbarui.

Saluran latest adalah saluran default. Fitur baru tersedia segera setelah dirilis, cocok jika Anda ingin mencobanya lebih dulu. Saluran stable menyediakan versi yang tertinggal sekitar satu minggu: versi itu sudah lebih stabil dan melewati rilis dengan masalah besar. Saluran ini cocok bagi orang yang lebih mengutamakan ketenangan daripada kecepatan.

Cara termudah untuk berganti saluran adalah melalui perintah /config di dalam Claude Code, pada bagian Auto-update channel. Atau, Anda dapat memasukkannya secara manual dalam file pengaturan settings.json:

{
  "autoUpdatesChannel": "stable"
}

Jika Anda sedang mengatur Claude Code sesuai kebiasaan, ada panduan terpisah tentang menyesuaikan Claude Code—panduan itu membahas keseluruhan file pengaturan, bukan hanya saluran pembaruan.

Bagaimana cara memasang versi tertentu atau menetapkan versi minimum?#

Terkadang Anda memerlukan versi tertentu alih-alih versi terbaru—misalnya, untuk kembali ke build yang sudah pasti berfungsi dalam alur kerja Anda. Penginstal native mendukung hal ini: penginstal tersebut menerima nama saluran maupun nomor versi tertentu. Pasang build tertentu seperti ini:

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

Di Windows, padanannya di PowerShell sedikit berbeda:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

Anda dapat memasang saluran stable dengan cara yang sama—tulis stable sebagai pengganti nomor versi. Saluran yang Anda pilih saat instalasi menjadi saluran default untuk pembaruan otomatis berikutnya.

Jika Anda ingin mencegah penurunan ke versi yang lebih lama, tetapkan versi minimum dalam settings.json:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

Ini adalah batas minimum. Pembaruan latar belakang maupun claude update tidak akan memasang versi yang lebih rendah daripada yang ditentukan. Ini berguna saat beralih ke stable jika Anda tidak ingin kembali ke versi yang lebih lama dari build baru yang sedang Anda gunakan.

Bagaimana cara menonaktifkan pembaruan otomatis jika mengganggu?#

Terkadang pembaruan latar belakang mengganggu—misalnya, ketika Anda ingin tim menggunakan satu versi yang sama persis. Anda dapat menonaktifkannya melalui file pengaturan:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Satu detail penting: DISABLE_AUTOUPDATER hanya menonaktifkan pemeriksaan latar belakang. Perintah claude update akan tetap berfungsi, sehingga Anda masih dapat memperbarui secara manual. Jika Anda perlu memblokir semua jalur pembaruan sekaligus, termasuk pembaruan manual, ada variabel yang lebih ketat, DISABLE_UPDATES. Variabel ini digunakan saat mendistribusikan Claude Code melalui saluran sendiri dan Anda ingin pengguna tetap menggunakan build yang Anda sediakan.

Untuk penggunaan biasa, sebaiknya jangan mengubah variabel ini: versi Claude Code yang baru hampir selalu lebih baik daripada versi lama, dan perbaikan keamanan mungkin disertakan dalam pembaruan. Menjaga alat tetap mutakhir merupakan bagian dari mempertahankan akses dan menghindari bug yang aneh; artikel terpisah membahas cara menghindari kehilangan akun Claude Anda.

Dari mana sebaiknya Anda memulai?#

Berikut rencana singkatnya.

1. Periksa versi saat ini: claude --version. Bandingkan dengan nomor terbaru di changelog.
2. Perbarui. Instalasi native—claude update. Homebrew—brew upgrade claude-code. WinGet—winget upgrade Anthropic.ClaudeCode.
3. Mulai ulang sesi Claude Code agar versi baru berlaku.
4. Jika versi belum berubah, jalankan claude doctor dan which -a claude. Kemungkinan Anda memiliki beberapa instalasi atau folder npm yang tidak dapat ditulisi.
5. Pilih saluran yang sesuai: latest jika Anda ingin fitur baru segera setelah tersedia, atau stable jika konsistensi lebih penting. Ubah melalui /config.

Versi baru memperbaiki bug dan menambahkan perintah baru, tetapi alat yang diperbarui tidak akan membangun proyek Anda untuk Anda. Panduan tentang alternatif Claude Code menjelaskan perbedaan Claude Code dari agen terminal lainnya dan kapan alternatif patut dipertimbangkan.

Kenali Ailoot.