TL;DR

Claude Code 2.1.117 ship hôm nay (22/04/2026) với 28 thay đổi CLI. Không drama, không feature mới to đùng — đây là bản "dọn dẹp" đúng kiểu: plugin system cứng hơn, /model bám dai hơn sau restart, native build macOS/Linux nhúng luôn bfs+ugrep cho search nhanh hơn, và bug đáng xấu hổ nhất — Opus 4.7 bị tính nhầm cửa sổ context 200K — cuối cùng đã fix để dùng đủ 1M.

What's new

Ba highlight official trong release thread:

  • Model selection persist qua restart. Trước đây nếu project pin một model khác, lựa chọn /model của bạn sẽ bị đè mỗi lần mở session. Giờ lựa chọn cá nhân bám lại, và startup header hiển thị rõ active model đang đến từ project pin, managed-settings pin, hay lựa chọn user — minh bạch khỏi đoán.
  • plugin install thông minh hơn. Chạy lệnh trên plugin đã cài sẽ không dừng ở "already installed" nữa — nó tiếp tục install các dependency còn thiếu. Bonus: plugin marketplace add tự resolve missing deps từ marketplace đã config, và error message đổi thành "not installed" kèm hint thay vì message mơ hồ cũ.
  • Managed-settings siết marketplace. Hai field blockedMarketplacesstrictKnownMarketplaces giờ được enforce ở cả install, update, refresh, và autoupdate. Team IT/security có thể standardize plugin allowlist toàn org mà không sợ autoupdate lách qua.

Why it matters

Patch này không bán tính năng mới — nó bán độ tin cậy. Ba nhóm user được lợi rõ nhất: (1) team enterprise dùng managed-settings giờ có plugin governance thực sự chặt; (2) dev đa-model không còn chửi thầm mỗi lần /model bị reset; (3) Opus 4.7 heavy user không còn bị autocompact sớm vì CLI tính nhầm cửa sổ context.

Technical facts

Top con số đáng nhớ:

Số liệuChi tiết
Tổng thay đổi28 CLI changes
Opus 4.7 context fix200K → native 1M window
Default effort mớiPro/Max trên Opus 4.6 & Sonnet 4.6: mediumhigh
Search engine swapGlob/Grep tools thay bằng bfs+ugrep embed (macOS/Linux native only)
Retention sweep mở rộng~/.claude/tasks/, shell-snapshots/, backups/ giờ nằm trong cleanupPeriodDays
MCP startupConcurrent connect default khi có cả local + claude.ai MCP

Observability cũng được nâng: user_prompt trong OpenTelemetry giờ có command_name + command_source; các event cost.usage, token.usage, api_request, api_error gắn thêm attr effort khi model hỗ trợ effort levels. Custom/MCP command names bị redact trừ khi bạn set OTEL_LOG_TOOL_DETAILS=1 — mặc định ưu tiên privacy.

Comparison — so với 2.1.116

Bản trước đó (20/04) khá hẹp: chủ yếu tăng tốc /resume trên session lớn 40MB+ (tới 67%) và MCP startup nhanh hơn khi có nhiều stdio server. 2.1.117 rộng hơn nhiều — plugin governance, model persistence, search engine swap, OTEL depth, và Opus 4.7 context fix đều là net-new trong vòng 2 ngày.

Use cases

  • IT/Security: dùng blockedMarketplaces chặn marketplace không được duyệt, dùng strictKnownMarketplaces để chỉ cho phép marketplace trong danh sách. Giờ autoupdate cũng tuân thủ — không còn kẽ hở.
  • Dev juggle nhiều model: set /model opus-4-7 một lần là xong, không cần reset mỗi lần project load model khác.
  • Opus 4.7 power user: nhét nguyên codebase lớn vào context không bị autocompact cắt ngang giữa chừng.
  • Plugin author: dependency resolution tự động giảm số support ticket dạng "em cài rồi mà không chạy".
  • Observability team: phân tích cost per slash-command, per effort level trong dashboard OTEL — trước không có dimension này.
  • Mac/Linux native build user: bfs+ugrep chạy qua Bash, không cần round-trip tool — search repo lớn nhanh hơn rõ rệt.

Bug fixes đáng chú ý

  • OAuth plain-CLI: token expire giữa session không còn throw "Please run /login" — auto refresh reactively trên 401.
  • WebFetch không còn treo trên HTML trang cực lớn (truncate trước khi convert markdown).
  • Proxy trả HTTP 204 No Content không còn crash TypeError — surface error rõ ràng.
  • Prompt-input undo (Ctrl+_) hoạt động ngay sau khi gõ, không skip state.
  • NO_PROXY được respect khi chạy dưới Bun.
  • Bedrock application-inference-profile requests không còn fail 400 với Opus 4.7 khi thinking disable.
  • Subagent chạy model khác main agent không còn bị flag "malware warning" sai khi đọc file.
  • VSCode "Manage Plugins" panel không vỡ khi configure nhiều marketplace lớn.

Limitations & pricing

bfs+ugrep swap chỉ áp dụng native build macOS/Linux — Windows và npm install vẫn dùng path cũ. Advisor Tool vẫn gắn nhãn experimental. CLAUDE_CODE_FORK_SUBAGENT=1 là opt-in cho external build, không default.

Pricing không đổi — Pro/Max subscription và API như cũ. Nhưng default high effort trên Opus 4.6/Sonnet 4.6 cho Pro/Max nghĩa là chất lượng output tốt hơn mà không đổi tier.

What's next

Cadence release dạo này đang ~2 ngày/patch (2.1.116 → 2.1.117). Advisor Tool còn experimental — khả năng cao được promote GA trong release tới. bfs+ugrep có thể mở rộng sang Windows khi parity xong. Chưa có roadmap public cho minor kế.

Update ngay: npm i -g @anthropic-ai/claude-code@latest hoặc qua native installer. Check version bằng claude --version.

Nguồn: code.claude.com/docs/en/changelog, anthropics/claude-code, @ClaudeCodeLog.