- Patch 2.1.117 tưởng nhỏ nhưng hé lộ 3 trục Anthropic đang khoá lại cho Claude Code: fork subagent có context riêng, CLI hiểu rõ subscription tier, và idle timeout ép tay cho stream dài.
- Bundle chỉ +64KB, prompt tokens không đổi, nhưng bộ cờ mới mở đường cho parallel agent workflow ổn định hơn.
TL;DR
Claude Code 2.1.117 phát hành 22/04/2026, chỉ 1 ngày 4 giờ sau 2.1.116. Thay đổi đáng chú ý nhất không nằm ở UI hay model, mà ở CLI surface: 4 env var mới được thêm, 1 bị xoá, tổng count 557 → 560. Bộ cờ mới hé lộ 3 hướng đi: fork subagent (context isolation), rate-limit tier-aware (CLI biết rõ subscription để phân bổ quota), và force idle timeout (vá nợ kỹ thuật "stream idle timeout"). Prompt tokens không đổi — behaviour LLM không bị động, chỉ wrapper CLI nâng cấp.
What's new
4 env var được thêm:
API_FORCE_IDLE_TIMEOUT— ép timeout cho API stream idle, khắc phục các lỗi "Stream idle timeout — partial response received" đã nổi lên trong GitHub issue #46987 và #46955.CLAUDE_CODE_FORK_SUBAGENT— cờ toggle cho cơ chế fork subagent. Đây là lần đầu flag này xuất hiện trong CLI surface, ám chỉ Claude Code đang chuẩn bị cho subagent chạy trong context riêng, tách hẳn main agent.CLAUDE_CODE_RATE_LIMIT_TIER— chỉ định tier rate limit (Pro / Max 5x / Max 20x) cho CLI.CLAUDE_CODE_SUBSCRIPTION_TYPE— phân loại subscription, bổ trợ cho tier trên để CLI phân bổ quota chính xác theo plan.
1 env var bị xoá: EMBEDDED_SEARCH_TOOLS — cờ cũ dùng để bật bộ tool search nhúng, giờ được dọn dẹp.
Ngoài CLI surface, release kèm một loạt bug fix: OAuth token refresh khi gặp 401 giữa session, WebFetch không còn treo với HTML lớn, proxy xử lý HTTP 204 đúng, NO_PROXY được tôn trọng dưới Bun, MCP server reconnect tối ưu hơn, Bedrock Opus 4.7 với thinking tắt đã tương thích, và fix subagent chạy model khác main agent không còn bị cờ cảnh báo malware nhầm.
Why it matters
Patch này trên bề mặt chỉ là +64KB bundle. Nhưng nếu đọc kỹ 4 env var, đây là signal dài hạn của Anthropic về ba vấn đề người dùng nặng hay than:
- Stream đứt giữa chừng với task dài >5 phút.
API_FORCE_IDLE_TIMEOUTcho user ép timeout lớn thay vì phụ thuộc mặc định. - Context contamination giữa các sub-task song song.
CLAUDE_CODE_FORK_SUBAGENTmở đường cho "controlled cognitive isolation" — subagent không share state với main agent, giảm drift và tăng reproducibility. - Rate limit không khớp tier. Issue #41788 ghi nhận Max 20 plan hết quota trong ~70 phút sau v2.1.89. Việc CLI giờ có 2 cờ riêng cho tier + subscription cho thấy Anthropic đang refactor budget allocation phía client.
Technical facts
| Chỉ số | 2.1.116 | 2.1.117 | Δ |
|---|---|---|---|
| Total env vars | 557 | 560 | +3 |
| Bundle size | baseline | +64.0 KB | +0.2% |
| Prompt files | — | — | +0 (0.0%) |
| Prompt tokens | — | — | +0 (0.0%) |
| Prompt mix (system-reminder) | 100.0% | 100.0% | 0 |
| Time since previous | — | 1d 4h 1m 26s | — |
Điểm quan trọng: prompt tokens = 0 delta. Nghĩa là behaviour LLM không bị thay đổi trong release này. Tất cả giá trị nằm ở code CLI wrapper và bộ cờ mới.
Comparison với 2.1.116
2.1.116 (21/04) thiên về plugin management: model selection persist giữa project pin, plugin install fix missing dep, managed-settings chặn plugin từ marketplace chưa duyệt. 2.1.117 đi một hướng hoàn toàn khác: runtime knobs cho subagent & rate limiting. Hai patch liên tiếp cho thấy Anthropic đang chia rõ 2 line of work — governance (plugin) và execution primitives (subagent fork, timeout, tier).
Use cases
- Agent chạy dài >5 phút (build, migration, large refactor): set
API_FORCE_IDLE_TIMEOUTlên cao để tránh stream bị cắt giữa chừng. - Parallel review / exploration: bật
CLAUDE_CODE_FORK_SUBAGENT=1khi chạy nhiều subagent cùng lúc — mỗi con có context sạch, giảm regression do noise tích luỹ. - User Max 20x bị rate-limit sớm: set
CLAUDE_CODE_RATE_LIMIT_TIER+CLAUDE_CODE_SUBSCRIPTION_TYPEkhớp plan để CLI không đoán nhầm quota. - Enterprise có workflow cũ bật
EMBEDDED_SEARCH_TOOLS: phải audit — cờ đã gỡ, cần chuyển sang tool search mặc định.
Limitations & pricing
Chưa có doc chính thức cho CLAUDE_CODE_FORK_SUBAGENT và cặp tier/subscription. Các flag này xuất hiện trong CLI surface reverse-engineered từ bundle, chưa lên trang env vars chính thức. Behaviour có thể thay đổi trong patch sau — đừng hardcode vào CI production mà chưa test.
Pricing không đổi: Pro $20/mo, Max 5x $100/mo, Max 20x $200/mo. Opus 4.7 vẫn yêu cầu 2.1.111+.
What's next
Dự đoán hợp lý cho 2.1.118+: doc chính thức cho CLAUDE_CODE_FORK_SUBAGENT, khả năng CLI expose flag chọn model khác cho subagent vs main agent (vì bug malware warning cho case này đã được fix trong 2.1.117 — tức trường hợp đó đang thật sự được test). Nếu fork subagent trở thành default, parallel agent workflow sẽ rẻ và ổn định hơn — một điểm mà Claude Code tụt lại so với các framework agent khác suốt năm qua.
Nguồn: marckrenn/claude-code-changelog v2.1.117, @ClaudeCodeLog tweet, Claude Code env vars docs.