Bỏ qua để vào nội dung chính
Claude Code 2.1.323: soát lại .claude config trước khi vỡ

Claude Code 2.1.323: soát lại .claude config trước khi vỡ

Bởi Noah Williams
13 thg 11, 20264 phút đọc

Bản 2.1.323 siết config từ khuyến nghị thành bắt buộc: plugin mang version range, hook hết quyền lấn át check fail, model ID lạ mặc định 1M context.

Bạn update Claude Code, mở lại project, và plugin của team im lặng không load. Hoặc tệ hơn: session chạy ổn cả tuần rồi đột nhiên mọi turn đều fail, không log nào chỉ ra nguyên nhân.

Bản 2.1.323, Anthropic ship ngày 12/11, siết config từ "khuyến nghị" thành "bắt buộc". Đây là những chỗ sẽ cắn vào setup có sẵn, và cách soát lại trong 10 phút.

Plugin giờ mang version range

Changelog thêm field engines["claude-code"] vào plugin.json. Theo mô tả: plugin nằm ngoài range đã khai báo sẽ không được install, update, hay load; install/update chọn bản plugin mới nhất còn khớp range.

Đây là ý tưởng engines của npm mang sang agent tooling. Nếu hook trong plugin phụ thuộc internal của CLI — tên hook event, tool schema, luồng permission check — khai báo range là cách để CLI chặn thay vì để plugin load vào bản đã âm thầm phá nó.

Lưu ý trước khi publish marketplace entry: tác giả bài phân tích nói cú pháp range cụ thể chỉ là minh hoạ anh tự suy từ npm — trang plugin manifest reference lúc anh fetch (13/11) không nhắc tới engines. Dòng changelog hiện là toàn bộ spec công khai.

Ba thay đổi permission dễ phá setup cũ

Thứ nhất, startup cảnh báo Bash allow rule có * bên trong giá trị biến, kiểu Bash(PORT=* npm run dev) — lỗi over-grant hay gặp.

Thứ hai, "don't ask again" bị giới hạn trí nhớ: rule trông như chứa secret, hoặc rule sẽ ghi vào settings.local.json đang được git track, nay chỉ sống trong session, không ghi xuống disk. Theo bài phân tích, thay đổi này đến từ khảo sát của Apiiro — 1.122 public repo chứa secret thật trong file settings được track.

Thứ ba, hook không còn lấn át được check fail: nếu permission check lỗi sau khi PreToolUse hook đã trả "allow", Claude Code xử lý như chưa hook nào trả lời.

Git hooks mất token — và hỏng trong im lặng

ripgrep nội bộ và hầu hết lệnh git nội bộ của Claude Code nay chạy mà không mang theo phần lớn sign-in token và API key — credential helper hay hook chạy dưới các lệnh git đó không còn thấy chúng. Về bảo mật đây là điểm cộng; mặt trái là nếu setup dựa vào helper đọc được token, nó dừng chạy mà không lỗi nào gọi đúng tên nguyên nhân. Audit mọi custom git hook chạy trong session.

Model ID lạ giờ mặc định 1M context

Context window giả định cho model ID mà Claude Code không nhận ra đã nhảy từ 200K lên 1M. Với model vendor khác có cửa sổ nhỏ hơn, cả session có thể fail mọi turn cho tới khi /clear, vì CLI cứ đẩy lượng context model không giữ nổi.

Biến CLAUDE_CODE_DISABLE_1M_CONTEXT=1 đưa giả định về 200K. Chịu đòn nặng nhất là ai chạy sau LLM gateway, nơi model ID là custom hoặc proxy nên không được nhận diện. Set nó trước khi cần, đừng đợi một tuần debug mò.

MCP và sandbox: fail-closed

Sign-in MCP server giờ bắt confirm trước khi hoàn tất, kể cả trong bypass và auto mode; headless dontAsk run phải làm tay qua /mcp. Approval .mcp.json cấp project phải khớp chính xác tên server. Install plugin cũng fail khi git submodule không nằm đúng commit repository ghi nhận, và file --settings không phải JSON hợp lệ mà chứa key sandbox thì chặn startup hẳn — kể cả khi key đó tắt sandbox.

Checklist chạy ngay tuần này

  • Grep wildcard: grep -rn 'Bash(' .claude/settings*.json | grep '\*' rồi viết lại từng rule tìm được.
  • Maintain plugin: chốt range engines["claude-code"], chạy claude plugin validate --strict — bản này type-check hook TypeScript và fail khi có finding.
  • Test lại credential helper từng dựa vào token Claude Code.
  • Sau gateway với model ID custom: set CLAUDE_CODE_DISABLE_1M_CONTEXT=1 nếu cửa sổ thật dưới 1M.
  • Đối chiếu tên server .mcp.json với server đã cài, đúng từng ký tự.

Thứ đáng theo dõi tiếp: khi nào trang plugin manifest reference bổ sung engines. Chừng nào chưa có, mọi range bạn viết vẫn là suy đoán từ một dòng changelog.

Không spam, hủy đăng ký bất kỳ lúc nào.

Bài viết liên quan