Anthropic đã thêm biến môi trường CLAUDE_CODE_DISABLE_ULTRATHINK trong Claude Code 2.1.316. Ghi chú phát hành chính thức mô tả biến này là cách tắt từ khóa ultrathink, nhưng không ghi giá trị hợp lệ, cách nạp cụ thể hay danh sách giao diện được hỗ trợ.

Thay đổi này liên quan đến việc Claude Code nhận diện một từ trong prompt, không phải công tắc tắt mô hình hay toàn bộ khả năng suy luận. Tài liệu cấu hình mô hình giải thích rằng ultrathink yêu cầu suy luận sâu hơn cho một lượt, còn effort của phiên vẫn là một lớp cài đặt riêng. Vì vậy, nâng cấp lên 2.1.316 chưa đủ để kết luận một cấu hình mới đã hoạt động đúng.

Claude Code 2.1.316 thêm kiểm soát nào cho ultrathink

Phần có thể xác nhận từ release note là tên biến và mục đích của nó. Tài liệu cấu hình mô hình của Anthropic nói ultrathink được viết ở bất kỳ vị trí nào trong prompt để yêu cầu suy luận sâu hơn cho lượt đó mà không đổi effort của phiên. Các cụm như “think” hoặc “think hard” không được Claude Code nhận diện theo cùng cơ chế.

Trong terminal, ultrathink còn có thể nâng effort của lượt đó lên xhigh khi mô hình và giới hạn tổ chức cho phép. Từ khóa có thể được hiển thị bằng màu cầu vồng trong điều kiện phù hợp. Nếu từ nằm trong dấu ngoặc kép, đường dẫn hoặc câu lệnh, giao diện có thể không nhận diện theo cách đó. Đây là lý do màu hiển thị không thể dùng làm bằng chứng duy nhất cho mọi phiên.

Biến mới cần được hiểu là một lớp kiểm soát việc nhận diện từ khóa. Nó không tự chứng minh rằng effort đã về mức thấp, không xóa cấu hình CLAUDE_CODE_EFFORT_LEVEL và không thay thế các giới hạn do mô hình hoặc tổ chức đặt ra. Release note cũng chưa cho biết biến nhận chuỗi nào, có cần giá trị đặc biệt hay không và có được áp dụng đồng nhất cho terminal, VS Code cùng script hay không.

Kiểm tra phiên bản trước khi sửa cấu hình

Trước hết, hãy chạy claude --version trong đúng môi trường sẽ dùng. Terminal, IDE, container và máy chủ từ xa có thể gọi những bản cài khác nhau. Một phiên bản hiển thị trong terminal không chứng minh rằng nút khởi chạy trong IDE hoặc pipeline tự động cũng dùng cùng tệp thực thi.

Claude Code 2.1.312 là ví dụ cho rủi ro này: Anthropic ghi nhận lỗi khiến managed settings và chính sách tổ chức không được tải cho phần còn lại của phiên sau khi đăng nhập từ tiện ích VS Code. Bài học ở đây là điểm khởi chạy và thời điểm nạp cấu hình có thể làm thay đổi kết quả, ngay cả khi người dùng tưởng mình đang dùng cùng một tài khoản.

Không nên đưa giá trị đoán vào tệp dùng chung chỉ vì tên biến đã xuất hiện trong release note. Hãy ghi lại phiên bản, đường dẫn chương trình, mô hình, giao diện và vị trí biến trước khi so sánh. Nếu tài liệu sau 2.1.316 bổ sung cú pháp chính thức, dùng văn bản đó làm căn cứ; nếu chưa có, thử trong một thư mục có thể khôi phục và ghi kết quả là quan sát của phiên bản cụ thể.

Biến môi trường được nạp từ đâu

Tài liệu biến môi trường của Anthropic cho biết biến đặt trong shell tồn tại trong phiên terminal đó, còn biến dưới khóa env của settings.json được đưa vào môi trường khi Claude Code chạy. Tài liệu này mô tả cơ chế chung, không xác nhận riêng giá trị hoặc thứ tự ưu tiên của CLAUDE_CODE_DISABLE_ULTRATHINK.

Các tệp có phạm vi khác nhau. ~/.claude/settings.json thường phục vụ một người dùng trên nhiều dự án; .claude/settings.json có thể được đưa vào dự án để dùng chung; .claude/settings.local.json dành cho thiết lập riêng của người dùng trong dự án; managed settings do quản trị viên triển khai cho tổ chức. Đừng suy ra rằng biến mới chắc chắn được mọi tầng cấu hình chấp nhận chỉ vì các biến khác được tài liệu liệt kê.

Với shell, kiểm tra biến trong chính phiên sẽ khởi chạy Claude Code. Với IDE, cần xác định nút khởi chạy gọi chương trình nào và có truyền môi trường của shell hay không. Với script hoặc CI, cần xem cấu hình của tiến trình con, không dừng ở biến trên máy phát triển. Mỗi đường đi nên có một bản ghi riêng để phân biệt lỗi chưa truyền biến với lỗi Claude Code không nhận diện biến.

Terminal, VS Code, script tự động và cấu hình nhóm cùng truyền thiết lập vào Claude Code (ảnh minh họa)

Ultrathink không phải là effort của cả phiên

Tài liệu model configuration tách hai khái niệm. Ultrathink là tín hiệu trong prompt cho một lượt; effort là mức được giải quyết từ biến môi trường, lựa chọn trong phiên, cờ khởi chạy, tệp settings và mặc định của mô hình. Vì vậy, một tổ chức muốn hạn chế từ khóa vẫn phải quyết định riêng có cho phép người dùng chọn effort cao hay không.

Cũng cần phân biệt việc tắt nhận diện từ khóa với việc thay đổi chất lượng đầu ra. Nếu cùng một nhiệm vụ cho ra câu trả lời khác sau khi bật biến, đó là dấu hiệu cần điều tra chứ chưa phải bằng chứng biến đã hoạt động. Mô hình, giới hạn token, tệp cấu hình, prompt, dữ liệu đầu vào và thời điểm chạy đều có thể ảnh hưởng kết quả.

Trong terminal, màu cầu vồng là một chỉ dấu tiện quan sát nhưng phụ thuộc vào điều kiện nâng effort. Tài liệu chính thức nói từ khóa có thể nâng lượt lên xhigh, không hứa rằng màu sẽ xuất hiện trong mọi giao diện. Bài kiểm tra nên ghi cả đầu vào, mô hình, effort hiển thị và phiên bản, thay vì chỉ chụp màu của một dòng prompt.

Ví dụ thay đổi phiên bản không nên bị suy diễn

Claude Code 2.1.314 thêm permissions.blockWritesOutsideWorkingDirectories để Write, Edit và NotebookEdit từ chối đường dẫn ngoài thư mục làm việc trong các chế độ quyền. Release note 2.1.314 ghi rõ hành vi, tên khóa và phạm vi thao tác của thay đổi này. Đây là ví dụ về một bản cập nhật có mô tả đủ cụ thể.

Không thể dùng ví dụ đó để đoán rằng CLAUDE_CODE_DISABLE_ULTRATHINK cũng nhận một giá trị boolean, được nạp ở mọi tầng hoặc thay đổi effort theo cùng quy tắc. Hai biến phục vụ hai cơ chế khác nhau. Khi thông tin còn thiếu, cách an toàn là giữ lại giả thuyết trong hồ sơ thử nghiệm và không biến nó thành quy định của nhóm.

Tại Việt Nam thì sao

Nhóm phát triển ở Việt Nam có thể bắt đầu từ câu hỏi rất thực tế: ai đang dùng Claude Code, từ thiết bị nào và cấu hình được quản lý ở đâu. Một lập trình viên chạy terminal trên máy cá nhân có đường truyền và tệp settings khác với nhóm dùng VS Code, máy chủ phát triển hoặc pipeline CI. Hồ sơ triển khai nên ghi hệ điều hành, cách cài Claude Code, phiên bản, shell, IDE, thư mục cấu hình và người có quyền thay đổi từng mục.

Về chi phí, bài viết này không đưa ra giá cho Việt Nam vì biến tắt ultrathink không có bảng giá riêng và Anthropic chưa công bố mức giá theo đồng Việt Nam trong các tài liệu đã kiểm tra. Chi phí thực tế còn phụ thuộc gói dịch vụ, cách mua, loại mô hình, lượng token và cơ chế thanh toán của tổ chức. Doanh nghiệp nên kiểm tra trang giá và hợp đồng của tài khoản đang dùng, sau đó đối chiếu hóa đơn bằng tiền tệ thực tế thay vì tự quy đổi từ một ví dụ trên mạng.

Việc tắt từ khóa cũng không tự tạo ra nghĩa vụ pháp lý mới tại Việt Nam. Nội dung cần xem xét là dữ liệu được đưa vào prompt, quyền truy cập của công cụ, nơi lưu nội dung cuộc trò chuyện, thời gian giữ log và người có thể đọc đầu ra. Một dự án xử lý mã nguồn công khai khác với dự án đưa dữ liệu khách hàng, thông tin nhân sự hoặc bí mật kinh doanh vào phiên. Các loại dữ liệu đó cần được phân loại trước khi nhóm quyết định dùng tệp cấu hình chung.

Quản trị viên có thể lập một bảng kiểm cho từng nhóm ở Việt Nam: phiên bản Claude Code được phê duyệt, mô hình được phép dùng, biến môi trường nào do tổ chức quản lý, tệp nào được commit, log nằm ở đâu và ai duyệt thay đổi. Nếu công ty có nhân sự làm việc từ nhiều tỉnh hoặc kết nối qua VPN, cần kiểm tra thêm đường truyền, DNS, proxy và chính sách bảo mật của thiết bị. Những yếu tố này không thể được suy ra từ việc một prompt có hiện màu cầu vồng hay không.

Với dự án có yêu cầu lưu trữ hoặc chuyển dữ liệu xuyên biên giới, bộ phận pháp chế và an toàn thông tin cần xác định căn cứ áp dụng từ loại dữ liệu và hợp đồng cụ thể. Tính đến thời điểm bài viết được thực hiện, chúng tôi chưa tìm thấy một văn bản chính thức của cơ quan chức năng Việt Nam đưa ra giá trị hợp lệ hoặc phạm vi áp dụng riêng cho CLAUDE_CODE_DISABLE_ULTRATHINK. Vì vậy, nhóm nên hỏi nhà cung cấp về nơi xử lý dữ liệu, chính sách lưu giữ và cơ chế quản trị tài khoản, thay vì tự coi biến này là biện pháp bảo vệ dữ liệu.

Ví dụ phù hợp cho một nhóm nhỏ tại Việt Nam là tạo một dự án thử không chứa dữ liệu thật, ghi phiên bản Claude Code trên terminal và VS Code, rồi chạy cùng một prompt trước và sau khi thay đổi cấu hình. Nhóm ghi lại việc từ khóa có được nhận diện, effort được hiển thị ra sao, công cụ nào được gọi và log xuất hiện ở đâu. Nếu kết quả lệch nhau, hãy kiểm tra biến có đến đúng tiến trình hay không trước khi đánh giá chất lượng mô hình.

Cuối cùng, cần có quy trình quay lại cấu hình cũ. Giữ bản sao tệp settings, ghi người phê duyệt, đặt thời điểm áp dụng và thông báo cho thành viên dùng IDE hoặc script riêng. Nếu biến mới không có tác dụng trong một giao diện, nhóm vẫn còn cách tạm thời là sửa prompt, giới hạn effort ở lớp đã được tài liệu xác nhận hoặc chờ Anthropic cập nhật hướng dẫn. Đây là cách quản trị thay đổi phù hợp hơn với việc đoán cú pháp rồi đưa thẳng vào cấu hình chung.

Kiểm tra trước khi áp dụng cho cá nhân và nhóm

Hãy coi việc tắt ultrathink là một thay đổi cần nghiệm thu, không phải một dòng cấu hình đã có thể mặc nhiên dùng cho mọi nơi.

  1. Ghi phiên bản, mô hình, hệ điều hành, shell và đường dẫn thực thi trong từng giao diện.
  2. Đối chiếu release note và tài liệu Anthropic để xác định giá trị biến, phạm vi và thứ tự ưu tiên đã được công bố.
  3. Dùng prompt không chứa dữ liệu nhạy cảm để so sánh phiên chưa đặt biến và phiên đã đặt biến.
  4. Kiểm tra riêng terminal, VS Code, script, container và cấu hình dự án dùng chung.
  5. Ghi nhận từ khóa, effort, màu hiển thị, lỗi và log; không dùng chất lượng một câu trả lời làm chỉ dấu duy nhất.
  6. Chỉ đưa thay đổi vào cấu hình nhóm sau khi có bản ghi thử nghiệm và đường quay lại.
Bảng ghi phiên bản, mô hình, đường khởi chạy, biến môi trường và kết quả quan sát ultrathink (ảnh minh họa)

Claude Code 2.1.316 xác nhận hướng kiểm soát mới cho từ khóa ultrathink, nhưng tài liệu công khai chưa đủ để suy ra cú pháp và phạm vi cho mọi khách hàng. Quyết định áp dụng nên dựa trên phiên bản thực tế, đường truyền cấu hình và phép thử có thể lặp lại tại tổ chức.