Giải thích CLAUDE_CODE_MAX_OUTPUT_TOKENS: Giới hạn đầu ra và thư mục plugin trong Claude Code 2.1.265

claude_code_max_output_tokens kiểm soát điều gì

Tài liệu tham khảo về biến môi trường mô tả CLAUDE_CODE_MAX_OUTPUT_TOKENS là biến đặt “số token đầu ra tối đa cho hầu hết các yêu cầu”. Cách diễn đạt này rất quan trọng: nó mô tả ngân sách đầu ra của yêu cầu, với giá trị mặc định và giới hạn tối đa thay đổi theo mô hình.

Vì vậy, biến này có liên quan khi tìm hiểu giới hạn đầu ra của Claude Code. Không nên coi đây là giới hạn chung cho mọi loại dữ liệu mà Claude Code xử lý. Phiên bản 2.1.265 cũng đưa ra giới hạn dung lượng trên đĩa cho kết quả công cụ đã lưu, nhưng giới hạn đó đo dữ liệu công cụ được lưu trữ bằng gigabyte, chứ không đo đầu ra được tạo bằng token.

Có một điểm cần lưu ý về mặt lịch sử đối với tài liệu cấu hình. Tài liệu tham khảo về biến môi trường được cập nhật liên tục và chưa tìm lại được bản sửa đổi chính xác vào tháng Chín năm 10. Phần mô tả giải thích mục đích của biến, nhưng trang này không xác lập mọi giá trị mặc định áp dụng cho Claude Code 2.1.265.

Đối với bài viết có mốc thời gian cụ thể, bằng chứng số liệu đáng tin cậy nhất đến từ ghi chú phát hành gắn với phiên bản. Những ghi chú đó xác lập các thay đổi cụ thể trước đó mà không cần suy ra một bảng giá trị mặc định đầy đủ từ tài liệu hiện hành.

Ba giới hạn cần phân biệt

Khi chẩn đoán một giới hạn, trước tiên hãy xác định giới hạn nào trong số này áp dụng. Thiết lập ngân sách token và giới hạn lưu trữ trên đĩa cần được diễn giải khác nhau, ngay cả khi cả hai xuất hiện trong cùng một phiên phát triển.

Các giá trị mặc định và giới hạn đầu ra tối đa đã được xác minh

Thư mục Ghi chú phát hành v2.1.77, đề ngày 17 tháng Ba năm 2026, ghi nhận hai thay đổi liên quan: giá trị mặc định của Claude Opus 4.6 được tăng lên 64k token đầu ra, và giới hạn trên của Opus 4.6 và Sonnet 4.6 được tăng lên 128k token. Những thay đổi này cũng được lưu lại trong nhật ký thay đổi gắn thẻ v2.1.265.

Bằng chứng đó loại trừ việc trình bày “mặc định 32,000, tối đa 64,000” như một quy tắc chung của Claude Code. Nó cũng không đủ cơ sở để điền các giá trị mặc định còn thiếu cho những mô hình khác.

Cần phân biệt rõ giữa một thay đổi được ghi nhận và một tài liệu tham khảo cấu hình đầy đủ. Bản phát hành tháng Ba xác lập những thay đổi ở trên; các nguồn có ngày tháng hiện có không xác lập một bảng giá trị mặc định đầy đủ theo từng mô hình cho v2.1.265.

Thông số kỹ thuật của các mô hình mới hơn không xác lập giá trị mặc định của CLI

Thư mục ghi chú phát hành mô hình ghi nhận đầu ra tối đa 128k và cửa sổ ngữ cảnh 1 triệu token cho Claude Sonnet 5, Claude Opus 5 và Claude Fable 5.1. ID API chính xác của các mô hình này lần lượt là claude-sonnet-5, claude-opus-5, và claude-fable-5-1.

Những thông báo đó đã được công bố trước mốc chốt xuất bản: Sonnet 5 vào ngày 30 tháng Sáu, Opus 5 vào ngày 24 tháng Bảy và Fable 5.1 vào ngày 1 tháng Chín năm 2026. Tuy nhiên, thông số kỹ thuật của các mô hình này không phải là bằng chứng về ngân sách yêu cầu mặc định của Claude Code.

Đối với nhà phát triển đang lựa chọn mô hình, hướng dẫn về mô hình trong Claude Code cung cấp nội dung đọc thêm có liên quan. Hãy phân biệt mức tối đa được công bố của mô hình với ngân sách đầu ra mặc định mà CLI sử dụng.

Thiết lập biến và tìm hiểu việc nén ngữ cảnh

Tài liệu hiện hành hỗ trợ việc thiết lập biến trước khi khởi chạy claude, hoặc đặt biến dưới env là khóa trong settings.json. Do chưa tìm lại được bản sửa đổi chính xác của tài liệu có sẵn vào ngày 10 tháng Chín, các ví dụ dưới đây là những mẫu cấu hình được ghi nhận trong tài liệu, với lưu ý về mặt lịch sử đó.

Cấu hình shell

Ví dụ shell được cung cấp đặt ngân sách đầu ra thành 64,000 token:

export CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000

Mẫu được ghi nhận trong tài liệu là thiết lập biến trước khi khởi chạy Claude Code. Con số trong ví dụ này là một giá trị cấu hình được lựa chọn; đó không phải là khẳng định rằng 64,000 là giá trị mặc định hoặc tối đa cho mọi mô hình.

Khi ghi lại cấu hình cho một dự án hoặc phiên khắc phục sự cố, hãy ghi rõ mô hình được chọn cùng với ngân sách được yêu cầu. Nếu không có thông tin về mô hình, chỉ một giá trị đơn lẻ không thể giải thích liệu nó có khớp với giá trị mặc định được ghi nhận hay nằm trong giới hạn trên được ghi nhận hay không.

Cấu hình trong settings.json

Ví dụ JSON tương đương được cung cấp đặt biến dưới env:

{"env":{"CLAUDE_CODE_MAX_OUTPUT_TOKENS":"64000"}}

Giá trị trong ví dụ này là một chuỗi. Tương tự thiết lập trong shell, đoạn mã thể hiện ngân sách được yêu cầu chứ không chứng minh một giá trị mặc định dành riêng cho mô hình.

Để xem cách sử dụng dòng lệnh có liên quan, hãy tham khảo tài liệu tham khảo CLI của Claude Code. Bằng chứng lịch sử ở đây xác nhận vai trò của biến và các ví dụ cấu hình được cung cấp, nhưng vẫn chưa xác định được đầy đủ các giá trị mặc định của v2.1.265.

Điều gì đã được xác minh về việc nén ngữ cảnh?

Nhật ký thay đổi gắn thẻ v2.1.265 ghi nhận một bản sửa lỗi trước đó trong v2.1.69 cho việc CLAUDE_CODE_MAX_OUTPUT_TOKENS bị bỏ qua trong quá trình nén ngữ cảnh hội thoại. Đây là mối liên hệ đã được xác minh giữa thiết lập này và hành vi nén ngữ cảnh.

Tài liệu tham khảo hiện hành về biến môi trường cũng giải thích rằng việc tăng giá trị thiết lập sẽ làm giảm lượng ngữ cảnh thực tế có thể sử dụng trước khi tự động nén. Ngày công bố lời giải thích đó chưa rõ, nên không thể trình bày nó như một mô tả đã được xác minh vào tháng Chín năm 10.

Vì vậy, không nên mô tả thiết lập này là mở rộng cửa sổ ngữ cảnh được công bố của mô hình. Bằng chứng có ngày tháng xác lập một cơ chế kiểm soát ngân sách đầu ra và một bản sửa lỗi liên quan đến nén ngữ cảnh; nó không xác lập ngưỡng nén ngữ cảnh chính xác cho mọi mô hình trong v2.1.265.

Cách Claude Code 2.1.265 tải thư mục plugin

Claude Code v2.1.265 được phát hành vào ngày 8 tháng Chín năm 2026, với commit phát hành 8e02f6d. Thay đổi về việc tải thư mục cho phép --plugin-dir trỏ đến một thư mục chứa nhiều plugin.

Lệnh gọi được cung cấp là:

claude --plugin-dir ./plugins

Bản phát hành mô tả trực tiếp quy tắc phát hiện: “mỗi thư mục con có tệp manifest đều được tải”. Bản phát hành cũng nêu rằng các mục thêm vào và xóa đi được phát hiện trong khi Claude Code đang chạy.

Nhờ vậy, thư mục cha trở thành đơn vị hữu ích khi quản lý nhiều plugin cùng nhau. Hành vi được bảo đảm trong tài liệu áp dụng cho các thư mục con chứa tệp manifest; ghi chú phát hành không nêu rõ việc phát hiện đệ quy. Đừng giả định rằng hệ thống sẽ tìm kiếm trong một cây thư mục lồng nhau tùy ý.

Bố cục manifest và lưu ý về mặt lịch sử

Tài liệu tham khảo hiện hành về plugin đặt tệp manifest tại .claude-plugin/plugin.json và các thư mục thành phần như skills/, commands/, và hooks/ ở thư mục gốc của plugin. Chưa tìm lại được tài liệu tham khảo đó dưới dạng bản chụp có ngày tháng của v2.1.265.

Đối với bài viết tháng Chín năm 10, hãy phân biệt hướng dẫn bố cục hiện hành đó với bảo đảm rõ ràng của bản phát hành: các thư mục con có tệp manifest sẽ được tải. Bản phát hành xác lập khả năng phát hiện thư mục chứa nhiều plugin mà không xác lập mọi chi tiết của tài liệu bố cục tại thời điểm đó.

Các bản sửa lỗi plugin có trong bản phát hành

Phiên bản 2.1.265 cũng sửa ba vấn đề về plugin:

• Đường dẫn plugin chứa dấu gạch chéo ngược có thể vượt qua cơ chế giới hạn phạm vi của liên kết tượng trưng trên macOS và Linux.
• Các thư mục bắt đầu bằng hai dấu chấm đã bị từ chối sai.
• Các thư mục thành phần mặc định không thể đọc trước đây bị bỏ qua mà không có thông báo; giờ đây chúng xuất hiện trong /plugin kèm mã lỗi.

Những bản sửa lỗi này liên quan đến đường dẫn plugin và việc tải thành phần. Nếu một thư mục plugin không tải được, chúng cung cấp bối cảnh phát hành có liên quan, nhưng thiết lập token đầu ra không giải thích được các vấn đề xử lý thư mục đó.

Giới hạn 1 GB cho kết quả công cụ đã lưu là một giới hạn riêng

Phiên bản 2.1.265 bổ sung giới hạn 1 GB cho kết quả công cụ được lưu vào đĩa. Bản xem trước hội thoại thông báo việc cắt bớt.

Giới hạn này liên quan đến dữ liệu công cụ được lưu trữ. CLAUDE_CODE_MAX_OUTPUT_TOKENS liên quan đến số token đầu ra tối đa cho hầu hết các yêu cầu. Bản phát hành không mô tả biến môi trường này là cơ chế kiểm soát giới hạn dung lượng trên đĩa, vì vậy không nên trình bày việc tăng giá trị của nó như một giải pháp cho tình trạng cắt bớt kết quả công cụ đã lưu.

Ghi chú phát hành cũng không nêu rõ giới hạn 1 GB áp dụng cho từng kết quả, từng phiên hay một nhóm khác. Hãy giữ nguyên sự chưa chắc chắn đó khi ghi lại hành vi: “giới hạn 1 GB cho kết quả công cụ được lưu vào đĩa” là mô tả đã được xác minh.

Một cách phân biệt hữu ích khi khắc phục sự cố là dựa vào bằng chứng hiển thị cho nhà phát triển. Bản xem trước hội thoại thông báo việc cắt bớt liên quan đến hành vi mới của kết quả đã lưu. Câu hỏi về ngân sách đầu ra được tạo của mô hình cần được xem xét cùng mô hình đã chọn và thiết lập token. Mã lỗi plugin trong /plugin liên quan đến việc tải plugin.

Đây là các cơ chế kiểm soát và chẩn đoán riêng biệt được giới thiệu hoặc thảo luận trong cùng bối cảnh phát hành. Xem xét chúng riêng biệt giúp tránh dùng thay đổi cấu hình token để giải thích hành vi lưu trữ hoặc thư mục không liên quan.

Bản phát hành tiếp theo cho cổng kết nối có sẵn tính đến tháng Chín 10

Phiên bản 2.1.266 cũng được phát hành vào tháng Chín 8, nên nằm trong mốc thời gian giới hạn của bài viết này. Phần Ghi chú phát hành v2.1.266 khắc phục lỗi hồi quy xác thực cổng kết nối trong v2.1.265 liên quan đến CLAUDE_CODE_USE_GATEWAY.

Lỗi liên quan là “Chưa đăng nhập vào cổng kết nối Cloud”. Bản phát hành nêu rõ rằng không cần thay đổi cấu hình.

Đối với nhà phát triển gặp đúng lỗi hồi quy đó trên v2.1.265, bản phát hành tiếp theo có liên quan trực tiếp. Tăng ngân sách token đầu ra hoặc tổ chức lại các thư mục plugin không phải là cách khắc phục được ghi trong tài liệu.

Các quy trình làm việc tương tự có thể chạy thông qua một cổng API như AI Prime Tech; xem sử dụng Claude Code với khóa API để xem hướng dẫn thiết lập liên quan. AI Prime Tech hoạt động độc lập và không liên kết với Anthropic hay OpenAI.

Những điểm chính

• CLAUDE_CODE_MAX_OUTPUT_TOKENS đặt số token đầu ra tối đa cho hầu hết các yêu cầu; giá trị mặc định và mức trần thay đổi theo mô hình.
• v2.1.77 đã tăng giá trị mặc định của Opus 4.6 lên 64k và giới hạn trên của Opus 4.6/Sonnet 4.6 lên 128k. Bảng giá trị mặc định đầy đủ cho v2.1.265 vẫn chưa được xác minh.
• Đầu ra tối đa của mô hình, dung lượng ngữ cảnh của mô hình và dung lượng lưu trữ kết quả công cụ đã lưu là các giới hạn riêng biệt.
• Trong v2.1.265, --plugin-dir có thể tải nhiều plugin từ các thư mục con có tệp kê khai và phát hiện việc thêm hoặc xóa trong khi chạy.
• v2.1.265 giới thiệu mức trần 1 GB cho kết quả công cụ đã lưu; v2.1.266 khắc phục lỗi hồi quy xác thực cổng kết nối mà không cần thay đổi cấu hình.

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

CLAUDE_CODE_MAX_OUTPUT_TOKENS kiểm soát điều gì?

CLAUDE_CODE_MAX_OUTPUT_TOKENS đặt số token đầu ra tối đa cho hầu hết các yêu cầu. Giá trị mặc định và mức trần của nó thay đổi theo mô hình, và giới hạn này tách biệt với mức trần 1 GB của v2.1.265 đối với kết quả công cụ được lưu vào ổ đĩa.

Giới hạn đầu ra mặc định và tối đa là bao nhiêu?

v2.1.77 đã tăng giá trị mặc định của Claude Opus 4.6 lên 64k token đầu ra và giới hạn trên của Opus 4.6/Sonnet 4.6 lên 128k. Các nguồn có ghi ngày được xem xét không xác định giá trị mặc định của Sonnet 4.6 hay bảng giá trị mặc định đầy đủ theo từng mô hình cho v2.1.265.

Tăng giá trị cài đặt này có làm tăng cửa sổ ngữ cảnh không?

Mục đích được ghi trong tài liệu là đặt ngân sách token đầu ra, chứ không phải tăng cửa sổ ngữ cảnh đã công bố của mô hình. v2.1.69 đã khắc phục việc biến này bị bỏ qua trong quá trình nén ngữ cảnh, nhưng phần giải thích trong tài liệu hiện hành về tác động của nó đối với việc tự động nén ngữ cảnh có ngày công bố chưa xác định.

--plugin-dir phát hiện nhiều plugin như thế nào?

Trong Claude Code 2.1.265, --plugin-dir có thể trỏ đến một thư mục cha, và mỗi thư mục con có tệp kê khai đều được tải. Việc thêm và xóa được phát hiện trong khi Claude Code chạy; ghi chú phát hành không nêu rõ khả năng phát hiện đệ quy.