Cách cập nhật Claude Code lên phiên bản mới nhất năm 2026

Claude Code thay đổi gần như mỗi ngày. Bạn mở nhật ký thay đổi mới nhất và thấy các lệnh mới, lỗi đã được sửa cùng những cải tiến về tốc độ. Trong khi đó, thiết bị đầu cuối của bạn vẫn chạy bản dựng từ hai tuần trước, và một nửa số cải tiến ấy đơn giản là không hoạt động. Claude cũng chẳng báo cho bạn: chương trình vẫn khởi chạy như thường, còn bạn tự hỏi tại sao người khác có một tính năng mà mình không có.

Tôi sẽ hướng dẫn cách kiểm tra phiên bản, cập nhật lên phiên bản mới nhất và xử lý khi bản cập nhật không cài đặt được. Các lệnh được trích nguyên văn từ tài liệu chính thức của Claude Code và đã được kiểm tra vào đầu tháng 9 năm 2026. Khi đó, phiên bản mới nhất được phát hành là 2.1.261, nhưng số phiên bản của bạn sẽ khác. Không cần chạy theo một con số cụ thể — điều quan trọng chỉ là dùng một bản dựng mới.

Thông tin về cách làm việc với Ailoot có trong tài liệu hướng dẫn.

Làm thế nào để nhanh chóng cập nhật Claude Code lên phiên bản mới nhất?#

Tôi sẽ giải thích chi tiết từng trường hợp bên dưới, nhưng nếu bạn không có nhiều thời gian, đây là ba lệnh đáp ứng gần như mọi tình huống.

claude --version   # which version is installed now
claude update      # update immediately (native installation)
claude doctor      # check the installation and updates

Lệnh đầu tiên hiển thị phiên bản của bạn, lệnh thứ hai cập nhật phiên bản, còn lệnh thứ ba chẩn đoán vấn đề nếu có sự cố. Bên dưới, tôi sẽ giải thích khi nào nên dùng từng lệnh và vì sao claude update không hoạt động với một số người.

Làm thế nào để kiểm tra phiên bản Claude Code hiện đang được cài đặt?#

Trước khi cập nhật, bạn nên biết mình đang cập nhật từ phiên bản nào. Lệnh rất đơn giản:

claude --version

Bạn sẽ nhận được một dòng như 2.1.211 (Claude Code). Đó là phiên bản hiện tại của bạn. Hãy so sánh hai con số đầu với số phiên bản mới nhất trong nhật ký thay đổi — nếu phiên bản của bạn thấp hơn nhiều, đã đến lúc cập nhật.

Nếu muốn có cái nhìn toàn diện hơn, hãy chạy claude doctor. Lệnh này chỉ kiểm tra và không thay đổi gì: nó không bắt đầu phiên làm việc, nhưng cho biết trạng thái cài đặt, lỗi trong tệp cài đặt và cảnh báo kèm các đề xuất sẵn dùng về những gì cần sửa. Lệnh cũng hiển thị kết quả của lần thử cập nhật tự động gần nhất — hữu ích khi bạn nghi ngờ bản cập nhật nền đã âm thầm cài đặt thất bại.

Claude Code có tự cập nhật không?#

Tất cả phụ thuộc vào cách bạn cài Claude Code. Bản cài gốc — cách Anthropic khuyến nghị và tập lệnh trên trang web cài đặt — có thể tự cập nhật, và tài liệu nêu rõ điều đó.

Cách hoạt động như sau: Claude Code kiểm tra bản cập nhật khi khởi chạy và định kỳ trong lúc chương trình chạy. Nếu tìm thấy phiên bản mới, chương trình tải xuống và cài đặt ở chế độ nền, rồi áp dụng vào lần bạn khởi chạy tiếp theo. Chỉ cần đóng và mở lại phiên làm việc vài ngày một lần là bạn sẽ lại dùng phiên bản mới nhất.

Bạn có thể kiểm tra kết quả của lần thử chạy nền gần đây nhất bằng chính lệnh claude doctor. Lệnh sẽ cho bạn biết liệu bản cập nhật có cài đặt thất bại vì lý do nào đó hay không.

Nhưng nếu bạn cài Claude Code qua trình quản lý gói — Homebrew trên MacBook, WinGet trên Windows, apt hoặc dnf trên Linux — thì sẽ không có cập nhật nền. Những bản cài đó được cập nhật bằng lệnh nâng cấp thông thường của bạn; phần bên dưới sẽ hướng dẫn riêng.

Phiên bản Claude Code mới là nền tảng, nhưng tự nó không thể đưa bạn đến đích. Kết quả nhất quán không đến từ phiên bản công cụ mà từ cách bạn làm việc với công cụ.

Làm thế nào để cập nhật Claude Code thủ công bằng một lệnh duy nhất?#

Bạn không cần chờ lần kiểm tra nền mới biết có phiên bản mới. Có một lệnh để cập nhật ngay:

claude update

Có hai kết quả có thể xảy ra. Nếu tìm thấy và cài đặt bản cập nhật, Claude Code sẽ hiển thị một dòng như Successfully updated from <old version> to version <new version>. Nếu bạn đã dùng bản dựng mới nhất, bạn sẽ nhận được Claude Code is up to date (<version>) — nghĩa là không có gì cần cập nhật.

Lệnh này có một điểm cần lưu ý khi dùng với trình quản lý gói. Nếu Claude Code được cài qua Homebrew, WinGet hoặc apk, claude update sẽ phản hồi ngắn hơn — Claude is up to date! — và không phải lúc nào cũng tự tải bản dựng mới. Với các bản cài này, dùng lệnh nâng cấp riêng của trình quản lý gói sẽ đáng tin cậy hơn; lệnh được mô tả bên dưới.

Làm thế nào để cập nhật Claude Code cài qua Homebrew hoặc WinGet?#

Nếu bạn cài Claude Code qua trình quản lý gói thay vì tập lệnh trên trang web, bạn phải tự cập nhật. Sau đây là các lệnh cho từng hệ thống.

Trên macOS với Homebrew:

brew upgrade claude-code

Homebrew có hai lựa chọn. Công cụ này cài Claude Code theo hai biến thể. Biến thể claude-code theo kênh stable — một phiên bản cũ hơn khoảng một tuần, bỏ qua các bản phát hành có vấn đề nghiêm trọng. Biến thể claude-code@latest nhận phiên bản mới nhất ngay khi được phát hành. Hãy cập nhật biến thể bạn đã cài: nếu bạn có claude-code@latest, lệnh sẽ là brew upgrade claude-code@latest.

Trên Windows với WinGet:

winget upgrade Anthropic.ClaudeCode

Đôi khi WinGet nâng cấp thất bại khi Claude Code đang chạy vì Windows đang sử dụng tệp thực thi. Claude Code sẽ hiển thị lệnh thủ công; hãy đóng chương trình rồi chạy lại lệnh nâng cấp.

Trên Linux với apt, dnf hoặc apk, bạn không cần học thêm lệnh riêng nào — phiên bản mới nhất sẽ có trong lần cập nhật hệ thống thông thường vì Claude Code phát hành các kho lưu trữ đã ký.

Nếu không muốn phải nhớ điều này, có biến môi trường CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE. Đặt biến thành 1, Claude Code sẽ chạy nâng cấp trong nền qua Homebrew và WinGet, sau đó đề xuất khởi động lại khi cập nhật thành công. Tài liệu có nêu một điểm cần lưu ý: đôi khi Claude Code thông báo phiên bản mới trước khi phiên bản đó thực sự xuất hiện trong trình quản lý gói. Nếu lệnh nâng cấp không tìm thấy bản cập nhật, hãy chờ một chút rồi thử lại.

Nhân tiện, nếu bạn vẫn đang chọn cách cài Claude Code, có hướng dẫn chi tiết trong bài viết riêng về cài đặt Claude Code — bao gồm lý do trình cài đặt gốc tiện hơn trình quản lý gói.

Tại sao Claude Code không cập nhật được và bạn nên làm gì?#

Đôi khi bạn cập nhật hết lần này đến lần khác, nhưng claude --version vẫn cố chấp hiển thị số phiên bản cũ. Tôi sẽ lần lượt trình bày các nguyên nhân chính, bắt đầu từ nguyên nhân phổ biến nhất.

Điều đầu tiên cần kiểm tra là bạn có nhiều bản cài Claude Code cùng lúc hay không. Việc này có thể xảy ra nếu ban đầu bạn cài qua npm rồi sau đó cài lại theo cách gốc. Lệnh cập nhật một bản sao, nhưng thiết bị đầu cuối khởi chạy bản khác, khiến phiên bản có vẻ như không thay đổi. Kiểm tra bạn có bao nhiêu bản sao:

which -a claude

Claude Code có thể nằm ở ba nơi: ~/.local/bin/claude là trình cài đặt gốc, ~/.claude/local/ là bản cài npm cục bộ cũ từ những phiên bản đầu, còn gói npm toàn cục được hiển thị bằng lệnh npm -g ls @anthropic-ai/claude-code. Nếu tìm thấy nhiều hơn một bản, hãy chỉ giữ lại một — tốt nhất là bản cài gốc. Xóa các bản dư như sau:

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

Nguyên nhân phổ biến thứ hai là thư mục npm toàn cục không có quyền ghi. Nếu bạn cài Claude Code toàn cục bằng npm nhưng chương trình không có quyền ghi vào thư mục của nó, bản cập nhật nền sẽ không được cài. Claude Code hiển thị thông báo một lần khi khởi chạy, và claude doctor liệt kê chính xác những gì cần sửa. Đây cũng là một lý do nên ưu tiên bản cài gốc: chương trình ghi vào thư mục chính của bạn và không cần các quyền đó.

Trường hợp thứ ba là trước đây bạn đã thay trình khởi chạy ~/.local/bin/claude bằng tập lệnh hoặc liên kết tượng trưng của riêng mình. Kể từ phiên bản 2.1.207, các bản cập nhật tự động sẽ giữ nguyên trình khởi chạy đó: phiên bản mới vẫn được cài vào thư mục ~/.local/share/claude/versions/, nhưng tập lệnh của bạn quyết định phiên bản nào được khởi chạy. Đừng xóa launcher duy nhất rồi gọi claude update bằng tên. Giữ launcher tùy chỉnh và đích symlink trong vị trí backup riêng chưa dùng, xác minh bản sao rồi mới chuyển launcher khỏi đường cũ. Khôi phục bằng trình cài native chính thức, không phụ thuộc lệnh claude có sẵn:

# macOS, Linux hoặc WSL: trình cài native chính thức
curl -fsSL https://claude.ai/install.sh | bash

Sau cài, mở terminal mới rồi kiểm:

claude --version
claude doctor

Lệnh đầu phải in số phiên bản. Xem cảnh báo launcher/PATH của doctor trước tiếp tục; giữ launcher cũ tới khi bản thay hoạt động.

Một triệu chứng khác là claude update hoặc claude doctor bị treo ngay sau dòng Checking for updates. Trên các phiên bản cũ hơn (trước 2.1.214), tình trạng này đôi khi xảy ra khi một trong các tệp cấu hình shell, chẳng hạn ~/.zshrc, là một thư mục thay vì tệp. Các bản dựng mới đã bỏ qua trường hợp này, vì vậy cập nhật lên phiên bản mới nhất cũng khắc phục được lỗi.

Làm thế nào để chọn kênh cập nhật: latest hay stable?#

Cập nhật lên phiên bản mới nhất không phải lúc nào cũng có nghĩa là lấy bản dựng mới nhất ngay ngày đầu tiên. Claude Code cho phép bạn chọn giữa hai kênh, quyết định chính xác những gì bạn nhận được khi cập nhật.

Kênh latest là mặc định. Các tính năng mới được đưa vào ngay khi phát hành, rất tiện nếu bạn muốn dùng thử trước. Kênh stable cung cấp phiên bản cũ hơn khoảng một tuần: phiên bản đó đã có thời gian ổn định và bỏ qua các bản phát hành có vấn đề nghiêm trọng. Đây là lựa chọn dành cho người coi trọng sự yên tâm hơn tốc độ.

Cách dễ nhất để chuyển kênh là dùng lệnh /config bên trong Claude Code, tại mục Auto-update channel. Hoặc bạn có thể nhập thủ công trong tệp cài đặt settings.json:

{
  "autoUpdatesChannel": "stable"
}

Nếu bạn đang tùy chỉnh Claude Code theo thói quen của mình, có hướng dẫn riêng về tùy chỉnh Claude Code — hướng dẫn này bao quát toàn bộ tệp cài đặt, chứ không chỉ kênh cập nhật.

Làm thế nào để cài một phiên bản cụ thể hoặc đặt phiên bản tối thiểu?#

Đôi khi bạn cần một phiên bản cụ thể thay vì phiên bản mới nhất — chẳng hạn để quay lại một bản dựng mà bạn biết chắc quy trình làm việc của mình hoạt động tốt. Trình cài đặt gốc hỗ trợ việc này: nó chấp nhận cả tên kênh lẫn số phiên bản chính xác. Cài một bản dựng cụ thể như sau:

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

Trên Windows, lệnh tương đương trong PowerShell trông hơi khác:

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

Bạn cũng có thể cài kênh stable theo cách tương tự — thay vì một con số, hãy ghi stable. Kênh bạn chọn khi cài đặt sẽ trở thành kênh mặc định cho các lần cập nhật tự động sau này.

Nếu muốn ngăn việc quay lại phiên bản cũ, hãy đặt phiên bản tối thiểu trong settings.json:

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

Đây là giới hạn thấp nhất. Cả bản cập nhật nền lẫn claude update đều sẽ không cài phiên bản thấp hơn mức đã chỉ định. Tính năng này hữu ích khi chuyển sang stable nếu bạn không muốn quay lại phiên bản cũ hơn bản dựng đang sử dụng.

Làm thế nào để tắt cập nhật tự động nếu chúng gây cản trở?#

Đôi khi cập nhật nền gây cản trở — chẳng hạn khi bạn muốn giữ cho cả nhóm dùng chính xác một phiên bản. Bạn có thể tắt chúng qua tệp cài đặt:

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

Một chi tiết quan trọng: DISABLE_AUTOUPDATER chỉ tắt việc kiểm tra nền. Lệnh claude update vẫn hoạt động, vì vậy bạn vẫn có thể cập nhật thủ công. Nếu cần chặn mọi con đường cập nhật cùng lúc, bao gồm cả cập nhật thủ công, có một biến nghiêm ngặt hơn là DISABLE_UPDATES. Biến này được dùng khi phân phối Claude Code qua kênh riêng và bạn muốn mọi người chỉ dùng đúng bản dựng mình đã cung cấp.

Với mục đích sử dụng cá nhân thông thường, tốt hơn hết là không thay đổi các biến này: phiên bản Claude Code mới hầu như luôn tốt hơn phiên bản cũ, và bản cập nhật có thể bao gồm một bản vá bảo mật. Duy trì công cụ luôn cập nhật là một phần của việc giữ quyền truy cập và tránh các lỗi kỳ lạ; bài viết riêng hướng dẫn cách tránh mất tài khoản Claude.

Bạn nên bắt đầu từ đâu?#

Đây là kế hoạch ngắn gọn.

1. Kiểm tra phiên bản hiện tại: claude --version. So sánh với số phiên bản mới nhất trong nhật ký thay đổi.
2. Cập nhật. Bản cài gốc — claude update. Homebrew — brew upgrade claude-code. WinGet — winget upgrade Anthropic.ClaudeCode.
3. Khởi động lại phiên Claude Code để phiên bản mới có hiệu lực.
4. Nếu phiên bản không thay đổi, hãy chạy claude doctor và which -a claude. Có thể bạn có nhiều bản cài hoặc thư mục npm không có quyền ghi.
5. Chọn kênh phù hợp: latest nếu muốn có tính năng mới ngay khi chúng ra mắt, hoặc stable nếu bạn coi trọng tính ổn định hơn. Đổi kênh qua /config.

Phiên bản mới sửa lỗi và thêm lệnh mới, nhưng công cụ được cập nhật không thể tự xây dựng dự án cho bạn. Hướng dẫn về các lựa chọn thay thế Claude Code giải thích Claude Code khác gì so với các tác nhân thiết bị đầu cuối khác và khi nào nên cân nhắc giải pháp thay thế.

Khám phá Ailoot.