Anthropic vừa phát hành phiên bản mới của Claude API, mang số hiệu 2026-10-21. Từ năm 2023 đến nay, các nhà phát triển vẫn luôn ghi anthropic-version: 2023-06-01 trong header yêu cầu; đây là phiên bản chính thức đầu tiên kể từ sau mốc đó.
Thay đổi dễ thấy nhất: ba tham số lấy mẫu temperature, top_p và top_k bị gỡ khỏi Messages API. Theo tài liệu hướng dẫn di chuyển, khi gửi yêu cầu bằng phiên bản mới, chỉ cần kèm một trong ba trường này, dù giá trị điền vào chính là mặc định, API cũng trả về lỗi 400 ngay. Nếu không truyền, yêu cầu sẽ lấy mẫu theo giá trị mặc định, với temperature là 1.0, giống hệt hiệu quả khi không truyền tham số ở phiên bản cũ.
Phiên bản cũ không bị ngừng hỗ trợ. Lời khuyên trong tài liệu rất thẳng: yêu cầu nào phụ thuộc vào giá trị lấy mẫu khác mặc định thì hoặc bỏ tham số đi, hoặc tiếp tục ở lại với 2023-06-01.
Ai sẽ bị ảnh hưởng
Với các mô hình từ Claude 4.7 trở đi, việc gỡ tham số gần như không tạo khác biệt thực tế, vì theo tài liệu, những mô hình này vốn chỉ chấp nhận giá trị mặc định. Người chịu tác động là các ứng dụng vẫn dùng mô hình cũ như Claude Sonnet 4.6 và cố tình hạ nhiệt độ để có đầu ra ổn định hơn. Tài liệu nói rất rõ: nhóm yêu cầu này sau khi nâng cấp sẽ mất hiệu quả ban đầu, và không có cài đặt nào khác thay thế được.
Ngoài các tham số lấy mẫu, Messages API còn hai thay đổi khác cũng dẫn tới lỗi 400:
- Đặt trực tiếp khối
documenttrong tin nhắn assistant giờ sẽ báo lỗi; tài liệu phải được đưa vào tin nhắn user; - Mang
citationskhông rỗng trong khối text của tin nhắn user cũng báo lỗi.
Phía quản trị cũng có đổi tên. Trong Admin API, trường roles của nhóm RBAC thành role_ids; workspace_id trên khóa API bị gỡ, thay vào đó đọc scope; trong giao diện phân tích dành cho doanh nghiệp, actor.email đổi thành actor.email_address. Với phiên bản mới, tên trường cũ không còn được trả về.
SDK cùng nhảy phiên bản lớn
SDK chính thức của các ngôn ngữ lần này đều nâng số hiệu chính, và bản mới mặc định gửi 2026-10-21: gói Python anthropic lên 2.0.0, @anthropic-ai/sdk của TypeScript lên 1.0.0, Go lên v2 (đường dẫn import phải thêm /v2), Java lên 3.0.0, C# lên 13.0.0, PHP lên 1.0.0, Ruby lên 2.0.0. Công cụ dòng lệnh ant lên 2.0.0.
Người dùng Go cần chú ý thêm. Đường dẫn module của CLI đổi thành github.com/anthropics/anthropic-cli/v2; tài liệu đặc biệt nhắc rằng nếu dùng đường dẫn cũ để chạy go install, hệ thống vẫn cài bản v1 mới nhất, không báo lỗi cũng không có cảnh báo.
Trên Amazon Bedrock, phiên bản mới chỉ mở cho các mô hình từ Claude 4.7 trở đi. Ai vẫn gọi Opus 4.6 và các mô hình cũ khác trên Bedrock thì hoặc giữ nguyên phiên bản SDK hiện tại, hoặc đổi mô hình trước rồi mới nâng cấp.
Khóa API đổi sang header khác
Thay đổi có thể ảnh hưởng rộng nhất đối với các nhà phát triển tại Trung Quốc nằm ẩn trong phần SDK. SDK và CLI mới không còn đặt khóa API vào header X-Api-Key, mà thống nhất chuyển sang Authorization: Bearer <key>.
Bản thân Claude API chấp nhận cả hai loại header, nên các chương trình kết nối thẳng tới API chính thức không bị ảnh hưởng. Rắc rối nằm ở tầng trung gian: reverse proxy tự dựng, API gateway, middleware thống kê hạn mức, hễ đọc khóa từ X-Api-Key để xác thực hoặc tính phí thì sau khi nâng cấp SDK sẽ không đọc được nữa. Tài liệu đưa ra hai hướng: sửa gateway để đọc Authorization, hoặc tự tay đặt lại khóa vào X-Api-Key ở phía client.
Một thay đổi kéo theo khác là mỗi client chỉ được giữ một loại thông tin xác thực. Trước đây, truyền đồng thời api_key và auth_token trong Python sẽ gửi cả hai header đi; giờ trường hợp này ném thẳng ValueError.
Nhìn lại số hiệu phiên bản hơn hai năm tuổi
Số hiệu 2023-06-01 bao trùm toàn bộ quá trình phát triển của Claude, từ thời Claude 2 đến dòng Claude 5. Các khả năng được bổ sung giữa chừng như gọi công cụ, prompt caching, suy nghĩ mở rộng phần lớn được chồng thêm qua header beta và trường mới, còn bản thân số hiệu phiên bản chưa hề đổi.
Việc các tham số lấy mẫu rút lui thực ra đã có dấu hiệu từ trước. Từ Claude 4.7, mô hình chỉ nhận giá trị mặc định, nên việc chỉnh nhiệt độ trên mô hình mới từ lâu đã không còn tác dụng. Lần này, quy tắc đó được ghi vào hợp đồng giao diện, để yêu cầu thất bại ngay ở cửa vào, tránh việc bên gọi tưởng rằng tham số vẫn đang có hiệu lực.
Phiên bản cũ được giữ bao lâu thì tài liệu di chuyển không nêu lộ trình thời gian, và hiện Anthropic cũng chưa công bố ngày ngừng hỗ trợ 2023-06-01.
Nguồn tham khảo: tài liệu di chuyển nền tảng Claude, tài khoản nhà phát triển chính thức của Claude, CocoLoop; số hiệu SDK của từng ngôn ngữ, điều kiện báo lỗi và phạm vi mô hình áp dụng trên Bedrock lấy theo tài liệu di chuyển chính thức.