Trang này được dịch từ tài liệu tiếng Anh. Lệnh, định danh và ví dụ giữ nguyên. Runtime 7.24.4 · SDK 2.6.7. Bản tiếng Anh
Mức nỗ lực mô hình (Suy nghĩ / Biến thể)
Trạng thái: Đang hoạt động
Phạm vi: trạng thái hiện tại
Xem xét lần cuối: 2026-07-18
Chủ sở hữu: ax-code runtime
AX Code dùng mức nỗ lực (còn gọi là mức suy nghĩ) để điều khiển mô hình đang hoạt động suy luận mạnh đến đâu. Mức nỗ lực không phải chế độ làm việc và không phải chế độ đặt vị trí.
| Trục | Câu hỏi | Ví dụ |
|---|---|---|
| Mô hình | Mô hình nào? | Sonnet, Opus, GPT, Qwen cục bộ |
| Mức nỗ lực | Nó nên suy nghĩ mạnh đến đâu? | Tự động, Nhanh, Cân bằng, Sâu, Tối đa |
| Chế độ làm việc | Việc được cấu trúc ra sao? | Agent, Council, Arena |
| Vị trí | Suy luận chạy ở đâu? | cục bộ, đám mây, lai |
Xem Chế độ thực thi cho các chế độ làm việc và đặt vị trí.
Định dạng dây
Runtime vẫn lưu và gửi các khóa biến thể tương thích OpenCode từ danh mục nhà cung cấp (ví dụ low, medium, high, xhigh, max). Nhãn giao diện chỉ là lớp trình bày:
| Nhãn giao diện | Khóa dây điển hình |
|---|---|
| Tự động | (không có — mặc định mô hình / chính sách) |
| Tắt | none |
| Tối thiểu | minimal |
| Nhanh | low |
| Cân bằng | medium |
| Sâu | high |
| Tối đa | xhigh, max |
Các khóa có sẵn là theo từng mô hình. Mô hình không có biến thể sẽ ẩn điều khiển mức nỗ lực.
Hỗ trợ nhà cung cấp
Các mức nỗ lực được sinh tự động cho mô hình được hỗ trợ trên các nhà cung cấp này:
| Nhà cung cấp | Cơ chế | Mức |
|---|---|---|
| Anthropic (Claude) | effort trên mô hình hiện tại; ngân sách suy nghĩ trên mô hình kế thừa |
Nhanh, Cân bằng, Sâu, Tối đa (phụ thuộc mô hình) |
| OpenAI (GPT-5.x) | reasoningEffort |
Nhanh, Cân bằng, Sâu |
| Google (Gemini 3.x) | thinkingConfig.thinkingLevel |
Nhanh, Sâu (3.1 thêm Cân bằng) |
| Điểm cuối tương thích OpenAI | reasoningEffort |
Nhanh, Cân bằng, Sâu |
| Venice | reasoningEffort |
Nhanh, Cân bằng, Sâu |
| Claude Code CLI | --effort |
Nhanh, Cân bằng, Sâu, Tối đa |
| Codex CLI | ghi đè cấu hình model_reasoning_effort |
Tối thiểu, Nhanh, Cân bằng, Sâu, Tối đa |
| Grok Build CLI | --reasoning-effort |
Nhanh, Cân bằng, Sâu |
Các nhà cung cấp có API nỗ lực chưa được xác minh hoặc không tương thích (API được lưu trữ của Groq, OpenRouter, các họ DeepSeek/Alibaba/MiniMax/GLM/Mistral, nhà cung cấp CLI không được hỗ trợ và cổng bên thứ ba) không lộ mức tích hợp; /effort giải thích điều này thay vì thất bại im lặng. Hãy định nghĩa mức tùy chỉnh dưới provider.<id>.models.<model>.variants trong ax-code.json khi một nhà cung cấp ghi một dạng tùy chọn được hỗ trợ.
Cách đặt mức nỗ lực
TUI
- Xoay vòng:
ctrl+t(phím tắtvariant_cycle) — đi Tự động → từng mức có sẵn → Tự động - Bộ chọn:
/effort(bí danh/variant,/thinking); trên mô hình không có mức, nó mở hộp thoại giải thích - Trạng thái: chân lời nhắc hiện chip mức nỗ lực hiện tại khi mô hình hỗ trợ mức; tin nhắn đã gửi hiện nhãn mức nỗ lực trên hàng siêu dữ liệu
- CLI:
ax-code run --variant high
Desktop
- Điều khiển suy nghĩ cạnh bộ chọn mô hình
- Xoay vòng bàn phím (cùng đường phím tắt với xoay vòng biến thể mô hình)
- Nhãn dùng cùng ánh xạ thân thiện như TUI
Mặc định và hành vi tự động
- Tự động nghĩa là không có ghi đè tường minh của người dùng cho mô hình đó.
- Khi Tự động đang hoạt động, ReasoningPolicy áp một đường cơ sở cân bằng (
medium/ biến thểdefaultcủa nhà cung cấp) để mô hình thực sự bật suy nghĩ / truyền cờ nỗ lực thay vì bỏ chúng. - Điều này áp dụng cả cho mô hình có
reasoning: truevà cho nhà cung cấp chỉ lộ nỗ lực dưới dạng biến thể (ví dụ Claude Code / Codex / Grok Build CLI, chúng báoreasoning: falsevì đầu ra không nhìn thấy được với AI SDK). - Chính sách vẫn có thể nâng độ sâu lên Sâu cho chế độ kế hoạch, chế độ tự chủ, hoặc lời nhắc rủi ro cao (và cho thất bại lặp / độ bất định cao / bán kính ảnh hưởng lớn khi các tín hiệu đó được cung cấp).
- Khi người dùng chọn một mức nỗ lực tường minh, ghi đè đó thắng ở các lượt sau (chính sách không chống lại nó). Cấu hình hoặc tùy chọn tác nhân đã đặt suy luận/
effort/thinkingcũng được để yên. - Mức nỗ lực được nhớ theo từng mô hình trong tùy chọn mô hình cục bộ (
model.jsontrong thư mục trạng thái TUI).
Cấu hình
Ghim một mặc định trên một tác nhân:
{
"agent": {
"plan": {
"variant": "high"
}
}
}
Định nghĩa hoặc tắt biến thể nhà cung cấp dưới provider.<id>.models.<model>.variants trong ax-code.json (cùng dạng với OpenCode).
Thực hành tốt
- Ưu tiên Tự động hoặc Cân bằng/Sâu cho việc hằng ngày; dành Tối đa cho gỡ lỗi khó hoặc kiến trúc.
- Đừng bịa một chế độ toàn cục thứ tư “nhẹ / xfast / tối đa” cạnh tranh với Agent/Council/Arena.
- Giữ mô hình, mức nỗ lực và chế độ làm việc là các điều khiển riêng trong văn bản giao diện.
- Khi đổi mô hình, mức nỗ lực đã lưu không còn hợp lệ sẽ lùi về Tự động cho mô hình đó.
Liên quan
- Chế độ thực thi — Agent / Council / Arena và vị trí lai
- Nhà cung cấp được hỗ trợ — nhà cung cấp nào lộ mô hình
- Biến thể mô hình OpenCode: https://opencode.ai/docs/models/