Advisor tool cho quyết định khó

Ghi chú

Advisor tool đang thử nghiệm (experimental) và cần Anthropic API. Không khả dụng trên Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform, hoặc Microsoft Foundry. Hành vi, giá cả, và mức khả dụng có thể thay đổi.

Advisor tool cho phép Claude tham vấn một model thứ hai, thường mạnh hơn, ở những thời điểm quan trọng trong task - như trước khi cam kết theo một hướng tiếp cận, khi bị kẹt ở lỗi lặp lại, hoặc trước khi tuyên bố task hoàn thành. Advisor nhận toàn bộ cuộc trò chuyện, gồm mọi tool call và kết quả, rồi trả về hướng dẫn Claude áp dụng trước khi tiếp tục.

Advisor chạy phía server trên hạ tầng Anthropic (server tool), khả dụng cho cả tài khoản subscription và tính phí theo API. Bạn chọn model nào đóng vai advisor, còn Claude quyết định khi nào gọi nó.

Khi nào dùng advisor

Advisor phù hợp cho task dài, nhiều bước, nơi hầu hết lượt là thường quy nhưng chất lượng plan quyết định kết quả. Ví dụ: refactor lớn, phiên debug nơi lỗi cứ lặp lại, và task bạn muốn được kiểm tra độc lập trước khi Claude tuyên bố xong.

Nó ít giá trị hơn với task ngắn ít cần lên kế hoạch, hoặc công việc cần model mạnh nhất ở mọi lượt - với những trường hợp đó, chuyển hẳn model chính thay vì dùng advisor.

Bật advisor

Bạn có thể đặt advisor model theo ba cách:

• Lệnh /advisor: đặt/đổi advisor giữa session và lưu làm mặc định
• Setting advisorModel: cấu hình mặc định lâu dài trong settings file
• Cờ --advisor: đặt advisor cho một session duy nhất khi khởi động

Khi một trong các cách trên đặt advisor model, advisor được bật cho các session có model chính hỗ trợ nó, và thông báo Advisor Tool (experimental) is on and may use more tokens · /advisor xuất hiện sau khi session khởi động.

Dùng lệnh /advisor

/advisor opus

Lệnh xác nhận bằng Advisor set to theo sau tên advisor model. Lựa chọn được lưu vào advisorModel trong user settings và giữ qua các session.

Đặt advisorModel trong settings

{
  "advisorModel": "opus"
}

Dùng cờ --advisor

claude --advisor opus

Cờ này ưu tiên hơn setting advisorModel cho session đó, và không xuất hiện trong claude --help.

Chọn advisor model

Advisor phải có năng lực tối thiểu bằng model chính. Các advisor được chấp nhận cho mỗi model chính:

Model chính	Advisor được chấp nhận	Ghi chú
Haiku 4.5	Fable, Opus, Sonnet	Haiku gọi được advisor nhưng không đóng được vai advisor
Sonnet 4.6	Fable, Opus, Sonnet
Sonnet 5	Fable, Opus, Sonnet 5	Advisor Sonnet 4.6 bị từ chối
Opus 4.6	Fable, Opus, Sonnet 5	Sonnet 5 và Opus 4.6 được xếp cùng mức năng lực
Opus 4.7 trở lên	Fable, và Opus 4.7 trở lên	Các Opus 4.7+ được xếp cùng mức năng lực
Fable 5	Fable	Advisor Opus/Sonnet bị từ chối

Fable 5 cần Claude Code v2.1.170 trở lên và quyền truy cập Fable 5, dù đóng vai model chính hay advisor.

Đặt advisor bằng opus hoặc sonnet, hoặc fable khi khả dụng - các alias này resolve về phiên bản mặc định built-in của Claude Code cho mỗi family model. Bạn cũng có thể truyền full model ID như claude-opus-5.

Subagent kế thừa advisor đã cấu hình và áp dụng cùng kiểm tra pairing với model riêng của chúng.

Các cặp model phổ biến

Cặp	Khi nào dùng
Sonnet chính + Opus advisor	Sonnet xử lý công việc thường quy và leo thang lên Opus khi lên kế hoạch, lỗi mơ hồ, và kiểm tra hoàn thành
Sonnet chính + Fable advisor	Hướng dẫn cấp Fable 5 tại điểm quyết định mà không chạy Fable 5 xuyên suốt
Haiku chính + Opus advisor	Model chính chi phí thấp nhất với khả năng lên kế hoạch mạnh
Opus chính + Opus advisor	Opus thứ hai review Opus đầu - hữu ích cho task quan trọng cao
Fable chính + Fable advisor	Cặp năng lực cao nhất khi Fable 5 khả dụng
Sonnet chính + Sonnet advisor	Ý kiến thứ hai chi phí thấp để bắt các sai sót thường quy

Khi nào Claude tham vấn advisor

Claude tự quyết định khi nào gọi advisor. Nó thường tham vấn trước khi cam kết theo hướng tiếp cận, khi lỗi cứ lặp lại, và trước khi tuyên bố task xong, nhưng thời điểm này do model quyết định chứ không theo rule cố định.

Bạn có thể yêu cầu tham vấn trong prompt như yêu cầu bất kỳ tool nào, ví dụ consult the advisor before you continue.

Những gì bạn thấy trong session

Khi Claude gọi advisor, transcript hiện dòng Advising kèm tên advisor model trong khi cuộc gọi đang xử lý. Khi kết quả trả về, dòng này xác nhận advisor đã review cuộc trò chuyện. Nhấn Ctrl+O để mở rộng và đọc toàn bộ hướng dẫn của advisor.

Claude thường làm theo hướng dẫn của advisor, nhưng điều chỉnh khi bằng chứng của chính nó mâu thuẫn với một khẳng định cụ thể: nếu bước được khuyến nghị thất bại khi thử, hoặc nội dung file mâu thuẫn với lời khuyên, Claude sẽ nêu ra mâu thuẫn đó thay vì làm theo vô điều kiện.

Chi phí

Mỗi lần gọi advisor gửi cuộc trò chuyện đến advisor model, nên tốn token theo giá của advisor model, cộng thêm vào usage của model chính. Với billing theo API, token advisor tính theo giá input/output của advisor model. Với subscription plan, usage advisor tính vào giới hạn usage của plan.

Claude gọi advisor tại điểm quyết định thay vì mỗi lượt, nên kết hợp model chính nhanh với advisor mạnh thường rẻ hơn chạy model mạnh xuyên suốt.

Ảnh hưởng đến prompt caching

Bật/tắt advisor giữa session không làm mất prompt cache của model chính. Khác với việc đổi model hoặc effort level, toggle /advisor giữ nguyên cached prefix, và hướng dẫn advisor trả về được cache như một phần transcript ở các lượt sau.

Yêu cầu

Advisor tool cần tất cả:

• Chỉ Anthropic API: advisor là server-executed tool. Không khả dụng trên Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform, Microsoft Foundry.
• Model chính được hỗ trợ: Opus 4.6 trở lên, Sonnet 4.6 trở lên, hoặc Haiku 4.5. Fable 5 cũng đủ điều kiện trên v2.1.170+, nhưng chỉ chấp nhận advisor Fable.
• Feature-flag fetching: Claude Code bật advisor qua một feature flag lấy từ Anthropic. Trong session có biến tắt việc fetch flag, như DISABLE_TELEMETRY, advisor vẫn tắt dù các điều kiện khác đã đủ.

Tắt advisor

/advisor off

Hoặc chọn No advisor trong picker /advisor để xoá advisorModel đã lưu.

Để tắt hẳn tool advisor, đặt CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. Lệnh /advisor khi đó không khả dụng và advisorModel đã cấu hình bị bỏ qua.

So sánh với tính năng liên quan

Cách tiếp cận	Khi model mạnh hơn chạy	Cách khởi động
Advisor tool	Tại điểm quyết định giữa task	Claude gọi khi cần hướng dẫn
opusplan	Trong plan mode, rồi chuyển sang Sonnet khi thực thi	Bạn vào plan mode
Subagent với model đặt sẵn	Cho toàn bộ subtask được giao	Claude giao việc, hoặc bạn gọi subagent
/model	Cho mọi lượt tiếp theo	Bạn chuyển model

Nguồn

Dịch và biên soạn từ Escalate hard decisions with the advisor tool.