Cách thay đổi mô hình mặc định trong Claude Code (và các hook chuyển mô hình mới trong 2.1.251)

Đặt mô hình mặc định của Claude Code bằng /model

Điểm khác biệt chính nằm ở việc lưu tùy chọn và chuyển đổi mô hình tạm thời. Đến tháng Tám 29, 2026, /model đã hỗ trợ cả hai quy trình.

Phiên bản 2.1.153 đã thay đổi /model để lựa chọn được lưu làm mặc định cho các phiên mới. Hành vi đó đã có trước 2.1.251: bản phát hành tháng Tám giới thiệu các hook chuyển đổi mô hình, chứ không phải khả năng ghi nhớ lựa chọn mô hình tương tác.

Thư mục nhật ký thay đổi gắn với phiên bản cụ thể là nguồn tham chiếu lịch sử cho sự khác biệt này. Nhật ký ghi lại cả hành vi lưu giữ lựa chọn lẫn thao tác trong bộ chọn để chuyển đổi tạm thời.

Lưu tùy chọn cho các phiên sau

Sử dụng bộ chọn mô hình:

/model

Chọn mô hình bạn muốn đặt làm mặc định. Hành vi lưu giữ lựa chọn được giới thiệu trong 2.1.153 có nghĩa là lựa chọn này được lưu cho các phiên mới.

Đây là câu trả lời rõ ràng nhất có căn cứ lịch sử cho câu hỏi “Làm thế nào để giữ lại mô hình tôi ưu tiên?” Câu trả lời này không đòi hỏi phải coi một tính năng được giới thiệu trong bản phát hành trước là khả năng mới của 2.1.251.

Chỉ chuyển đổi cho phiên hiện tại

Nhấn s trong bộ chọn để chỉ chuyển đổi mô hình cho phiên hiện tại. Sử dụng thao tác này khi lựa chọn chỉ nên có hiệu lực tạm thời.

Sự khác biệt này quan trọng khi làm theo hướng dẫn cũ hoặc duy trì các phím tắt tùy chỉnh. Thao tác trước đây của bộ chọn là d đã trở thành s, và tổ hợp phím tùy chỉnh liên quan đã đổi từ modelPicker:setAsDefault sang modelPicker:thisSessionOnly.

Để biết bối cảnh rộng hơn về việc chọn mô hình, hãy xem hướng dẫn về mô hình trong Claude Code. Điểm riêng của bản phát hành này rất đơn giản: lựa chọn thông thường lưu một mô hình mặc định, còn thao tác chỉ dành cho phiên cho phép bạn chuyển đổi tạm thời.

Tệp cấu hình, ANTHROPIC_MODEL và các tùy chọn ghi đè khi khởi động

Cấu hình mô hình cũng có thể được thiết lập qua tệp cài đặt, biến môi trường và cờ khởi động. Tuy nhiên, tài liệu nghiên cứu được cung cấp xác định một hạn chế về mặt lịch sử: tài liệu chính xác và thứ tự ưu tiên của các cách này chưa được xác minh độc lập trong một bản chụp có sẵn trước hoặc vào tháng Tám 29, 2026.

Thư mục tài liệu cấu hình mô hình và tài liệu cài đặt mô tả các cách này, nhưng những trang đó có các cập nhật về sau. Chúng không thể xác lập mọi chi tiết về hành vi tại thời điểm chốt thông tin của bài viết này.

Bảng sau phân biệt các tùy chọn được mô tả trong tài liệu với những gì được chứng cứ có ghi ngày tháng hỗ trợ.

Cài đặt nào được ưu tiên?

Tài liệu nghiên cứu được cung cấp cho biết tài liệu hướng dẫn đặt cờ khởi động ở mức ưu tiên cao hơn ANTHROPIC_MODEL, và biến môi trường ở mức ưu tiên cao hơn giá trị trong tệp cài đặt của model . Tài liệu nghiên cứu cũng nêu rõ rằng thứ tự đó chưa được xác minh cho thời điểm chốt thông tin để xuất bản.

Do đó, bài viết này không trình bày chuỗi ưu tiên đó như một thông tin đã được xác lập vào tháng Tám 29. /model Thay đổi về khả năng lưu giữ lựa chọn có căn cứ trong nhật ký thay đổi ghi ngày tháng; hệ thống phân cấp cấu hình chính xác thì không.

Còn giá trị mặc định cho một dự án thì sao?

Tài liệu nghiên cứu xác định các tệp cài đặt cấp người dùng, cấp dự án và tệp cài đặt dự án cá nhân trong tài liệu hướng dẫn. Tài liệu nghiên cứu không xác lập cách diễn đạt chính xác hoặc hành vi cài đặt mô hình trong lịch sử của chúng thông qua một bản chụp trước thời điểm chốt thông tin.

Vì vậy, câu trả lời có phạm vi hẹp hơn một hướng dẫn cấu hình dự án: /model khả năng lưu giữ lựa chọn đã được xác nhận, còn hướng dẫn về tệp dành riêng cho dự án cần được xác minh về mặt lịch sử. tài liệu tham khảo CLI là tài liệu bổ trợ hữu ích cho cấu hình dòng lệnh, nhưng không xóa bỏ giới hạn về chứng cứ của bài viết này.

Các hook chuyển đổi mô hình bổ sung điều gì trong 2.1.251

Claude Code 2.1.251 được phát hành vào tháng Tám 28, 2026. ghi chú phát hành chính thức giới thiệu hai hook với tên chính xác là:

• PreModelSwitch
• PostModelSwitch

Bản phát hành mô tả khả năng của chúng là chặn, xác nhận hoặc chú thích một lần chuyển đổi mô hình. Các hook này mở rộng quy trình chọn mô hình bằng các cơ chế kiểm soát xoay quanh việc chuyển đổi.

Đó là tính năng mới cần phân biệt với khả năng lưu giữ giá trị mặc định. Việc lưu tùy chọn mô hình đã có sẵn; các sự kiện hook mới bổ sung những cách tham gia vào quá trình thay đổi mô hình.

Hook có thể chặn hoặc yêu cầu xác nhận không?

Có, chặn và xác nhận là những khả năng được nêu rõ trong thông báo phát hành. Khả năng chú thích cũng được liệt kê.

Thông báo không cung cấp đầy đủ lược đồ đầu vào và đầu ra, quy tắc đối sánh hoặc JSON quyết định. Vì vậy, thông báo đủ căn cứ để mô tả các khả năng này, nhưng không đủ để công bố một cấu hình có thể chạy chỉ dựa trên thông báo.

Giới hạn tương tự cũng áp dụng cho các chi tiết như trường nào trong payload xác định mô hình cũ và mới, hoặc phản hồi xác nhận phải có cấu trúc ra sao. Những chi tiết đó không có trong chứng cứ được cung cấp trước thời điểm chốt thông tin.

Cần những gì trước khi triển khai một hook?

Một bản triển khai hoạt động được cần nhiều hơn tên sự kiện: cần định dạng cấu hình áp dụng và quy ước phản hồi được hỗ trợ. Ghi chú phát hành không cung cấp các thành phần đó.

Sử dụng hướng dẫn về hook trong Claude Code để tìm hiểu bối cảnh rộng hơn về hook. Đối với bản phát hành này, hãy xác định chính xác phạm vi đã được xác nhận: PreModelSwitch và PostModelSwitch tồn tại, và thông báo mô tả các khả năng chặn, xác nhận và chú thích.

Kiểm tra hành vi bộ nhớ đệm prompt và chi phí tiếp tục phiên

Phiên bản 2.1.251 cũng bổ sung công cụ chẩn đoán giúp giải thích hành vi bộ nhớ đệm prompt. Những bổ sung này hiển thị hoạt động của bộ nhớ đệm và chi phí ước tính để xây dựng lại; bản phát hành không công bố giá token mới hoặc giới hạn bộ nhớ đệm bằng số.

Đọc dòng bộ nhớ đệm mới trong /cost

Lệnh hiện có được bổ sung một dòng bộ nhớ đệm prompt cho từng phiên:

/cost

Dòng đó báo cáo bốn mục:

• Tỷ lệ trúng bộ nhớ đệm
• Số lần không trúng bộ nhớ đệm
• Số token được lưu lại vào bộ nhớ đệm
• Trạng thái ấm hoặc lạnh

Kết hợp lại, các mục này cung cấp góc nhìn chi tiết hơn về bộ nhớ đệm so với chỉ một con số chi phí. Chúng phân biệt các lần trúng và không trúng bộ nhớ đệm, đồng thời cho biết số token được lưu lại vào bộ nhớ đệm.

Các script dòng trạng thái cũng được bổ sung một đối tượng tương ứng là prompt_cache . Điều này giúp công cụ chẩn đoán bộ nhớ đệm có mặt trên giao diện dòng trạng thái cũng như thông qua /cost.

Thông báo không cung cấp lược đồ đầy đủ cho đối tượng đó. Hãy coi prompt_cache là tên đối tượng đã được xác nhận, mà không giả định có thêm các trường ngoài thông tin chẩn đoán được mô tả trong bản phát hành.

Kiểm tra thông tin tiếp tục phiên qua SessionStart

Khi tiếp tục phiên, SessionStart các hook hiện nhận được thông tin về độ cũ của phiên và chi phí ước tính để xây dựng lại bộ nhớ đệm prompt.

Điều này khác với phần hiển thị /cost : phần bổ sung khi tiếp tục phiên cung cấp thông tin cho các hook, còn lệnh báo cáo dữ liệu chẩn đoán bộ nhớ đệm theo từng phiên. Cả hai phần bổ sung đều liên quan đến khả năng quan sát bộ nhớ đệm, nhưng cung cấp thông tin đó qua các giao diện khác nhau.

Ghi chú phát hành không nêu tên khóa chính xác trong payload cho độ cũ của phiên hoặc chi phí xây dựng lại ước tính. Một ví dụ hook giả định các tên khóa đó sẽ vượt quá những bằng chứng hiện có.

Các giá trị mặc định của mô hình và thông tin chẩn đoán khác đã thay đổi

Một số thay đổi liên quan trong 2.1.251 có ý nghĩa khi diễn giải “mô hình mặc định”. Chúng liên quan đến tác nhân con, giá trị mặc định ở cấp tài khoản, tùy chọn mức nỗ lực và khả năng theo dõi chi tiêu qua gateway.

Thứ tự ưu tiên mô hình của tác nhân con

CLAUDE_CODE_SUBAGENT_MODEL hiện cung cấp một giá trị mặc định. Giá trị model: trong định nghĩa tác nhân và mô hình được chọn rõ ràng khi khởi tạo tác nhân được ưu tiên hơn biến đó.

Đây là thay đổi về thứ tự ưu tiên đã được xác nhận trong nhật ký thay đổi gắn thẻ phiên bản. Cần phân biệt thay đổi này với thứ tự ưu tiên trước đây chưa được xác minh giữa cờ khởi động, biến môi trường và giá trị trong tệp cài đặt của mô hình chính.

Khi xem xét cách chọn mô hình của tác nhân con, hãy tính đến những lựa chọn rõ ràng đó trước khi coi biến môi trường là yếu tố quyết định. Tài liệu hướng dẫn về tác tử phụ cung cấp bối cảnh rộng hơn về cấu hình tác nhân.

Giá trị mặc định ở cấp tài khoản và tùy chọn mức nỗ lực

Các gói Enterprise tính theo số chỗ hiện mặc định dùng Opus 5, tương tự các gói cao cấp khác.

Thay đổi ở cấp tài khoản đó tách biệt với tùy chọn mô hình được lưu qua /model. Bản phát hành cũng thay đổi cách lưu /effort : giờ đây, một mức nỗ lực mặc định riêng được lưu cho từng mô hình.

Điểm khác biệt trong thực tế là việc chọn mô hình và lưu mức nỗ lực là hai cài đặt riêng biệt. Cách lưu mức nỗ lực mới ghi nhớ giá trị mặc định cho từng mô hình thay vì mô tả một mức nỗ lực mặc định dùng chung.

Khả năng theo dõi chi tiêu qua gateway

Thư mục /usage được bổ sung thanh Giới hạn chi tiêu dành cho nhà phát triển sử dụng gateway ứng dụng Claude có giới hạn chi tiêu:

/usage

Các tập lệnh dòng trạng thái được bổ sung trường rate_limits.spend_limit tương ứng. Đây là phần bổ sung thông tin chẩn đoán cho ngữ cảnh gateway đó.

Nhật ký thay đổi không công bố một mức trần chi tiêu bằng đô la áp dụng chung. Vì vậy, việc hiển thị giới hạn chi tiêu không nên được hiểu là một giới hạn cố định áp dụng cho mọi người dùng Claude Code.

Những điểm chính

• /model đã lưu giá trị mặc định cho các phiên mới trước 2.1.251; hành vi đó có từ 2.1.153.
• Nhấn s trong bộ chọn mô hình để chỉ chuyển đổi trong phiên hiện tại. Các phím tắt tùy chỉnh sử dụng modelPicker:thisSessionOnly.
• Claude Code 2.1.251 bổ sung PreModelSwitch và PostModelSwitch, với các khả năng chặn, xác nhận và chú thích được mô tả trong bản phát hành.
• /cost, dữ liệu bộ nhớ đệm trên dòng trạng thái và thông tin SessionStart khi tiếp tục phiên giúp quan sát hoạt động của bộ nhớ đệm prompt và chi phí xây dựng lại ước tính.
• CLAUDE_CODE_SUBAGENT_MODEL cung cấp một giá trị mặc định mà các lựa chọn mô hình rõ ràng cho tác nhân có thể ghi đè. Thứ tự ưu tiên chính xác trước đây của cấu hình mô hình chính vẫn chưa được xác minh trong tài liệu nghiên cứu được cung cấp.

Câu hỏi thường gặp

/model có lưu mô hình mặc định trong Claude Code không?

Có. Phiên bản 2.1.153 đã thay đổi /model để lựa chọn được lưu làm mặc định cho các phiên mới, và hành vi đó đã có trước 2.1.251. Nhấn s trong bộ chọn khi bạn chỉ muốn chuyển đổi cho phiên hiện tại.

Cái nào được ưu tiên: settings.json, ANTHROPIC_MODEL hay --model?

Tài liệu nghiên cứu được cung cấp cho biết tài liệu hướng dẫn xếp cờ khởi động ở mức ưu tiên cao hơn ANTHROPIC_MODEL, và biến đó cao hơn giá trị mô hình trong tệp cài đặt. Tuy nhiên, thứ tự chính xác này chưa được xác minh độc lập trong bản chụp trước tháng Tám 29, 2026, nên bài viết này không xác lập đây là hành vi cụ thể tại mốc thời gian đó.

Hook chuyển đổi mô hình của Claude Code có thể chặn thay đổi không?

Bản phát hành 2.1.251 mô tả PreModelSwitch và PostModelSwitch là hỗ trợ chặn, xác nhận và chú thích các lần chuyển đổi mô hình. Bản phát hành không cung cấp đầy đủ lược đồ hoặc JSON quyết định, nên chỉ riêng thông báo này chưa đủ để triển khai một hook có thể chạy được.

Tôi có thể xem số lần trượt bộ nhớ đệm và chi phí xây dựng lại ước tính ở đâu?

Trong 2.1.251, /cost báo cáo tỷ lệ trúng bộ nhớ đệm, số lần trượt, số token được lưu lại vào bộ nhớ đệm và trạng thái nóng hoặc lạnh theo từng phiên; các tập lệnh dòng trạng thái được bổ sung đối tượng prompt_cache tương ứng. Ngoài ra, SessionStart các hook khi tiếp tục phiên nhận được thông tin về độ cũ của phiên và chi phí ước tính để xây dựng lại bộ nhớ đệm prompt, dù ghi chú phát hành không nêu tên các khóa đó trong payload.