Claude Code “context_management: Extra inputs are not permitted” — header beta đã không đến nơi

Xác nhận header bị thiếu là nguyên nhân

Claude Code ghép từng trường phần thân phát hành trước với giá trị anthropic-beta bật trường đó, và hai phần này phải di chuyển cùng nhau: gateway loại bỏ header nhưng vẫn chuyển phần thân sẽ tạo ra lỗi 400 rõ ràng, còn chỉ khi cả hai đều bị thiếu thì tính năng mới âm thầm tắt (https://code.claude.com/docs/en/llm-gateway-protocol#feature-pass-through, tính đến tháng 9 năm 2026). Gửi một yêu cầu đến URL cơ sở của bạn với trường và header tương ứng, theo dạng mà trang chỉnh sửa ngữ cảnh của Anthropic sử dụng, nhưng bỏ công cụ tìm kiếm web của trang đó (https://platform.claude.com/docs/en/build-with-claude/context-editing). Cùng lỗi 400 khi header hiện diện có nghĩa là header không đến được backend chấp nhận nó.

curl -s "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: context-management-2025-06-27" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "max_tokens": 64,
       "messages": [{"role": "user", "content": "ping"}],
       "context_management": {"edits": [{"type": "clear_tool_uses_20250919"}]}}'

Ngăn Claude Code gửi trường này: CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

Đây là cách khắc phục phía máy khách được ghi chép: tài liệu tham khảo lỗi của Claude Code đưa ra biến này cho thông báo này như phương án dự phòng khi không thể khiến gateway chuyển tiếp header (https://code.claude.com/docs/en/errors#extra-inputs-are-not-permitted). Nó loại bỏ các header anthropic-beta dành riêng cho Anthropic và các trường schema công cụ beta như defer_loading và eager_input_streaming (https://code.claude.com/docs/en/env-vars), đồng thời hướng dẫn gateway cho biết nó cũng dừng các trường phần thân phát hành trước, bao gồm context management (https://code.claude.com/docs/en/llm-gateway-protocol#disable-pre-release-capabilities). Cần Claude Code 2.1.27 trở lên: bản phát hành ngày 30 tháng 1 năm 2026 này là bản có changelog cho biết cờ này giờ đây tránh được lỗi context-management cho người dùng gateway (https://code.claude.com/docs/en/changelog). Cái giá phải trả là các khả năng phát hành trước và tính năng tìm kiếm công cụ MCP, vì vậy các công cụ MCP sẽ được tải ngay từ đầu (từ 2.1.227, cài đặt được quản lý có thể giữ tính năng tìm kiếm công cụ bật); suy luận thích ứng do mô hình lựa chọn, không phải beta, và vẫn bật. Đặt biến này trong khối env của ~/.claude/settings.json để áp dụng cho mọi phiên (https://code.claude.com/docs/en/settings-reference#env).

claude --version          # 2.1.27 or later
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
claude

# Every session, in ~/.claude/settings.json:
#   { "env": { "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1" } }

Nếu bạn vận hành gateway: hãy chuyển tiếp anthropic-beta hoặc chuyển đổi định dạng

Hướng dẫn gateway của Claude Code liệt kê anthropic-version và anthropic-beta là các header cần được chuyển tiếp nguyên trạng trên tuyến định dạng Anthropic, đồng thời yêu cầu gateway truyền qua các header và trường thân anthropic-* dưới dạng danh sách mở thay vì chỉ cho phép các mục hiện thấy, vì mỗi bản phát hành lại thêm mục mới. Hướng dẫn này nêu một nguồn phổ biến của lỗi 400: gateway chấp nhận yêu cầu định dạng Anthropic rồi chuyển tiếp chúng đến Amazon Bedrock. Nếu đó là thiết lập của bạn, hãy cung cấp định dạng riêng của nhà cung cấp và trỏ Claude Code đến đó bằng các biến của nhà cung cấp bên dưới; trên tuyến đó, Claude Code giới hạn các header và trường beta mà nó gửi ở những mục nhà cung cấp chấp nhận (https://code.claude.com/docs/en/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway).

# Only if your gateway exposes the Amazon Bedrock format:
export ANTHROPIC_BEDROCK_BASE_URL=https://llm-gateway.example.com/bedrock
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
export CLAUDE_CODE_USE_BEDROCK=1

“context_management: Extra inputs are not permitted” có nghĩa là gì?

API hoặc backend phía sau gateway của bạn đã nhận một trường context_management mà nó không chấp nhận. Trên API Anthropic, trường đó cần header beta chỉnh sửa ngữ cảnh (context-management-2025-06-27), và tài liệu tham khảo lỗi của Claude Code quy nguyên nhân thông báo này cho proxy hoặc gateway đã loại bỏ header anthropic-beta. Claude Code gửi trường và header theo cặp, vì vậy một thành phần trung gian nào đó đã loại bỏ header hoặc chuyển tiếp yêu cầu đến backend có schema khác.

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS có tắt suy nghĩ hoặc bộ nhớ đệm prompt không?

Không. Suy luận thích ứng do mô hình lựa chọn, không phải beta, và bộ nhớ đệm prompt tiêu chuẩn (cache_control) không có cặp beta. Cờ này loại bỏ các khả năng phát hành trước — header beta, trường công cụ beta, context management — cùng tính năng tìm kiếm công cụ MCP, vì vậy các công cụ MCP được tải ngay từ đầu. Trên các mô hình cũ sử dụng extended thinking thủ công, suy nghĩ xen kẽ giữa các lần gọi công cụ cần header beta, nên tính năng đó cũng bị tắt.

Có công tắc nào chỉ tắt context_management không?

Tính đến tháng 9 năm 2026, không có công tắc nào được ghi chép. Cờ này bao phủ mọi khả năng phát hành trước cùng lúc — ngoại lệ duy nhất, từ Claude Code 2.1.227, là giữ tính năng tìm kiếm công cụ MCP bật thông qua cài đặt được quản lý — và yêu cầu về công tắc chỉ dành cho context_management (anthropics/claude-code#64510) đã bị đóng do không hoạt động. Đừng dựa vào các biến không có trong tài liệu tham khảo biến môi trường của Claude Code.

Tôi có nên hạ cấp Claude Code không?

Vào tháng 1 năm 2026, những người bình luận trong anthropics/claude-code#21612 cho biết 2.1.20 là phiên bản cuối cùng hoạt động, nhưng bản sửa được phát hành là 2.1.27, với mục changelog cho biết cờ này bao phủ lỗi đó. Việc ghim ở phiên bản cũ như vậy cũng bỏ lỡ 2.1.77, bản đã khiến cờ loại bỏ các trường công cụ beta. Hãy đặt cờ và duy trì phiên bản hiện hành.

Lỗi thay vào đó nêu tools.0.custom.eager_input_streaming

Cùng loại điểm không khớp, nhưng là trường khác: một trường schema công cụ đã đến backend từ chối nó. Khi sử dụng URL cơ sở tùy chỉnh, Claude Code chỉ gửi trường đó — truyền công cụ chi tiết — nếu bạn đặt CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1. Từ 2.1.77, cờ này loại bỏ các trường công cụ beta, và 2.1.80 đã sửa lỗi 400 của tính năng truyền công cụ chi tiết qua proxy, Bedrock và Vertex.