Hướng dẫn effort trong Claude Code từ A đến Z
Effort level là gì, sáu cách cấu hình, thứ tự ưu tiên, các hành vi mặc định dễ gây nhầm, và mẹo ultrathink cho một lượt nghĩ sâu — dành cho người mới dùng Claude Code.
Effort level điều khiển adaptive reasoning — cho phép model tự quyết định có nghĩ hay không, và nghĩ sâu đến đâu, ở mỗi bước dựa trên độ phức tạp của task. Effort thấp = nhanh và rẻ cho việc đơn giản; effort cao = suy luận sâu cho vấn đề khó. Bài này hướng dẫn thao tác cụ thể trong Claude Code; còn chọn mức nào cho việc gì thì xem bảng tra cứu theo tác vụ.
Bước 1: Biết mình đang chạy ở mức nào
Mức effort hiện tại hiển thị ngay cạnh logo và spinner — ví dụ “with low effort” — nên không cần mở menu nào để kiểm tra. Muốn xem chi tiết hơn, gõ /effort không tham số để mở slider.
Mặc định theo model: high trên Fable 5, Sonnet 5, Opus 4.8, Opus 4.6 và Sonnet 4.6; riêng Opus 4.7 mặc định xhigh. Haiku không hỗ trợ effort — slider sẽ biến mất khi bạn chọn Haiku.
Bước 2: Sáu cách đặt effort
| Cách | Phạm vi | Ghi chú |
|---|---|---|
/effort | Phiên hiện tại trở đi | Không tham số → slider; kèm tên mức → set thẳng; /effort auto → về mặc định của model |
Slider trong /model | Như trên | Phím mũi tên trái/phải khi đang chọn model |
claude --effort <mức> | Một phiên | Set lúc khởi động |
CLAUDE_CODE_EFFORT_LEVEL | Mọi phiên | Nhận tên mức hoặc auto; ưu tiên cao nhất |
effortLevel trong settings | Mọi phiên | Chỉ nhận low/medium/high/xhigh — max và ultracode là session-only |
effort trong frontmatter skill/subagent | Khi skill/subagent đó chạy | Đè mức của phiên, không đè được biến môi trường |
// ~/.claude/settings.json
{
"effortLevel": "xhigh"
}---
# skills/heavy-refactor/SKILL.md
name: heavy-refactor
effort: xhigh
---Thứ tự ưu tiên: biến môi trường > mức bạn cấu hình > mặc định của model.
low, medium, high, xhigh set trong phiên tương tác sẽ được lưu qua các phiên sau. max chỉ áp cho phiên hiện tại (trừ khi set qua biến môi trường).
Bước 3: Nắm ba hành vi dễ gây nhầm
1. Model-default hold. Lần đầu bạn chạy Fable 5, Opus 4.8 hoặc Opus 4.7, Claude Code áp mức mặc định của model đó kể cả khi bạn đã set mức khác cho model khác trước đó — và giữ mức này qua các phiên cho đến khi bạn chủ động chọn lại bằng /effort hoặc --effort.
2. Auto-downgrade. Set một mức mà model không hỗ trợ, Claude Code tự hạ xuống mức cao nhất được hỗ trợ ở dưới — ví dụ xhigh chạy như high trên Opus 4.6. Không báo lỗi, chỉ lặng lẽ hạ.
3. Đổi effort giữa phiên làm mất prompt cache. Mỗi mức effort có cache riêng cho cùng model, nên Claude Code hiện hộp thoại xác nhận trước khi áp thay đổi. Chốt effort ở đầu phiên; chi tiết ở bài về prompt caching.
Bước 4: Mẹo ultrathink — nghĩ sâu một lượt, khỏi đổi effort
Cần model nghĩ kỹ đúng một câu hỏi khó, giữa phiên đang chạy effort thấp? Đặt từ khóa ultrathink ở bất kỳ đâu trong prompt. Claude Code nhận diện keyword này chính thức: nó thêm một chỉ thị in-context yêu cầu suy luận sâu hơn cho riêng lượt đó, còn effort level gửi lên API giữ nguyên — nghĩa là không mất cache như khi đổi /effort.
Lưu ý: chỉ ultrathink là keyword. Các cụm như “think”, “think hard”, “think more” được truyền đi như văn bản thường.
Bước 5: ultracode trong menu /effort
Menu /effort có thêm mục ultracode. Đây không phải mức effort API — nó là setting của Claude Code: gửi xhigh lên model và cho phép Claude tự dàn dựng workflow đa agent cho task lớn. Session-only, và ăn quota nhanh hơn hẳn. Chi tiết ở bài riêng về ultracode và dynamic workflows.
Với người dùng Enterprise
Admin tổ chức có thể đặt trần effort theo model cho từng role (Claude Code v2.1.195+). Mức vượt trần không hiện trong menu /effort; gọi mức cao hơn qua --effort sẽ chạy ở mức trần kèm cảnh báo. Nếu bạn không thấy xhigh/max trong menu, hỏi admin trước khi nghi ngờ cài đặt của mình.
Nguồn tham khảo
Đối chiếu docs lần cuối ngày 14/07/2026.