SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor

Claude hết lượt gọi tool: cách tiếp tục tác vụ

Thông báo giới hạn tool trong lượt này không phải hết quota plan. Hiểu lỗi, giới hạn số vòng agent loop và cách yêu cầu Claude tiếp tục tác vụ.

Ý nghĩa của giới hạn số lần dùng tool trong lượt này

Giới hạn số lần dùng tool trong một lượt có nghĩa là Claude đã dừng giữa chừng vì phản hồi đó đã hết số lần gọi tool, không phải vì tài khoản của bạn đã hết hạn mức sử dụng. Mọi nội dung Claude tìm được trước khi dừng vẫn còn trong cuộc trò chuyện. Hãy gửi thêm một tin nhắn yêu cầu Claude tiếp tục. Claude sẽ mở một lượt mới với hạn mức mới.

Trong Agent SDK, một lượt là một lần chạy qua vòng lặp của agent. Claude tạo output chứa các lần gọi tool, client chạy các tool đó, rồi kết quả được gửi lại cho Claude để đưa ra quyết định tiếp theo. Chu kỳ này lặp lại mà không chuyển quyền điều khiển lại cho bạn. Vòng lặp kết thúc khi Claude tạo một phản hồi không chứa lần gọi tool nào. Giới hạn lượt của SDK tính mọi lần chạy, bao gồm cả phản hồi cuối cùng không có lần gọi tool.

Giới hạn sử dụng của plan là một cơ chế kiểm soát riêng

Giới hạn của plan tính tổng mức sử dụng của bạn trong một khoảng thời gian. Trang trung tâm trợ giúp của Anthropic về thông báo lỗi, được kiểm tra vào ngày 9 tháng 11 năm 2026, cho biết thông báo đó là Approaching session limit khi bạn sắp chạm giới hạn và 5-hour limit reached - resets [time] sau khi vượt giới hạn. Giới hạn theo tuần cũng có các thông báo tương ứng, nêu rõ ngày và giờ reset. Dù ở trường hợp nào, thông báo cũng nêu một thời điểm cụ thể. Nếu bạn không có usage credits, chờ đến thời điểm đó sẽ khắc phục được lỗi; mọi nội dung bạn nhập trong lúc chờ đều không có tác dụng. Nếu bạn đã bật usage credits cho plan trả phí, trang này cho biết công việc sẽ tiếp tục sử dụng credits, và thông báo sẽ là 5-hour limit resets [time] - continuing with usage credits. Việc tiếp tục này kết thúc khi bạn đạt monthly spend limit hoặc số dư credit cạn trong khi auto-reload bị tắt. Tài khoản Ultra đã xác minh không bị giới hạn phiên năm giờ, nhưng giới hạn theo tuần vẫn áp dụng.

Thông báo về tool use hoạt động theo cách ngược lại. Nó xuất hiện giữa một tác vụ, và chỉ cần một tin nhắn follow-up là công việc có thể tiếp tục ngay lập tức. Các tool call đã thực hiện vẫn được tính vào mức sử dụng của plan. Việc tiếp tục không reset quota, và usage credits cũng có thể cho phép công việc tiếp tục sau khi đạt giới hạn của plan. Với trường hợp quota, cần làm gì khi Claude báo đã đạt giới hạn liệt kê các lựa chọn, còn cách tính giới hạn sử dụng của Claude giải thích các khoảng thời gian áp dụng.

Tại sao một lượt lại có giới hạn tool

Mỗi lần gọi tool đều tiêu tốn context. Lệnh gọi được gửi đi, tool chạy, rồi toàn bộ kết quả được đưa trở lại cuộc hội thoại. Đọc một file lớn hoặc chạy một command có output dài có thể dùng đến hàng nghìn token chỉ trong một bước, và phần văn bản đó vẫn nằm trong context trong suốt phần còn lại của session. Tài liệu về vòng lặp agent của Anthropic nêu rõ hệ quả: context tích lũy qua các lượt, nên một session có nhiều lần gọi tool sẽ mang theo nhiều dữ liệu hơn hẳn một session ngắn.

Giới hạn cho mỗi lượt sẽ dừng một vòng lặp không còn tạo ra tiến triển. Một agent tìm kiếm, đọc, tìm kiếm lại nhưng vẫn không tìm thấy gì sẽ tiếp tục làm như vậy cho đến khi có thứ gì đó ngắt nó. Giới hạn này chính là điểm ngắt. Nó trả quyền điều khiển cho bạn tại thời điểm bạn có thể định hướng lại công việc. Cách này tốn ít hơn nhiều so với để vòng lặp chạy đến cuối context window.

Giới hạn này hiển thị ở đâu trong API

Tài liệu lỗi công khai của Anthropic không đưa ra số tool call tối đa trong mỗi lượt cho ứng dụng chat Claude. Vì vậy, mọi con số chính xác bạn đọc được về giới hạn này đều chỉ là phỏng đoán của người khác. API (application programming interface) có tài liệu về cùng dạng giới hạn này, và đó là nơi có thể thấy hành vi thực tế.

Trường stop_reason trong response của Messages API cho biết lý do generation dừng lại. Các giá trị được tài liệu hóa gồm end_turn, max_tokens, stop_sequence, tool_use, pause_turn, refusal và model_context_window_exceeded. Hai giá trị trong số đó mô tả tình huống trong hướng dẫn này.

pause_turn được trả về khi vòng lặp sampling phía server đạt giới hạn số vòng trong lúc chạy các server tool như web search. Tính đến ngày 25 October 2026, trang về stop reasons và fallback ghi mặc định là 10 vòng cho mỗi request. Cách khắc phục được tài liệu hóa là gửi nguyên response đó trở lại dưới dạng assistant message để Claude tiếp tục từ nơi đã tạm dừng. Bạn không thêm user message mới yêu cầu Claude tiếp tục. Ví dụ trong tài liệu chỉ gửi user message ban đầu, sau đó gửi nội dung assistant đã tạm dừng.

max_tokens có nghĩa là response đã chạm mức trần output token được đặt trong request. Nếu response bị cắt giữa một tool use block chưa hoàn chỉnh, tool call không thể thực thi. Cách xử lý được tài liệu hóa là retry với max_tokens cao hơn.

Hãy đọc các giá trị hiện tại trên trang về stop reasons và fallback, thay vì tin vào các giá trị được ghi ở đây. Các giá trị mặc định trên trang đó có thể thay đổi, và một con số đã lỗi thời còn tệ hơn không có con số nào.

Điều gì khiến một chat hết số lần gọi tool

  • Một câu hỏi không có điểm dừng tự nhiên. "Tìm mọi thứ đã viết về X" không cho model dấu hiệu nào để biết quá trình tìm kiếm đã kết thúc.
  • Đọc lặp lại cùng một tài liệu, vì câu trả lời không nằm ở nơi model dự đoán.
  • Kết quả tool lớn. Một web page dài hoặc một file lớn chiếm phần không gian mà phần còn lại của lượt xử lý cần dùng.
  • Nhiều job độc lập trong cùng một message. Mỗi job cần các tool call riêng, nhưng tất cả đều dùng chung một budget.
  • Các connector và server MCP (model context protocol) mà bạn không dùng cho task này. Sau khi được load, mỗi connector chiếm một phần không gian trong conversation và cung cấp cho model thêm cách sử dụng lượt xử lý.

Cách hoàn tất câu trả lời

Hãy trả lời bằng "continue", hoặc tốt hơn là một instruction ngắn nêu rõ phần còn thiếu. Việc này mở một lượt mới với budget mới. Conversation trước đó vẫn nằm trong context, nên Claude tiếp tục công việc thay vì lặp lại các tool call đã thực hiện.

Nếu nó dừng ở cùng một vị trí hai lần, task quá rộng đối với một lượt, vì vậy hãy chia nhỏ task. Thay vì yêu cầu audit toàn bộ repository, trước tiên hãy yêu cầu danh sách file, sau đó hỏi về từng file trong mỗi message. Bốn lượt nhỏ có thể hoàn tất công việc mà một lượt lớn không thể hoàn tất.

Thu hẹp phạm vi tìm kiếm của model. Cung cấp exact file path hoặc exact error string, và paste log nếu bạn đã có log đó. Một log được paste chỉ tốn một message. Để model tự đi tìm log sẽ tốn nhiều tool call, và nó có thể tìm nhầm log.

Tắt các connector mà bạn chưa cần dùng ngay. Trang trợ giúp của Anthropic cho biết mỗi connector chiếm một phần không gian trong conversation. Với setting Auto mặc định, Claude quyết định sẽ load connector nào. Với Always available, Claude load tất cả connector ngay từ đầu; mỗi connector được load sẽ tiêu tốn context và mở rộng tập hành động mà model có thể chọn. Nếu bạn giữ một tập connector lớn, setting On demand chỉ load connector sau khi Claude tìm kiếm connector phù hợp. Lý do tương tự cũng áp dụng cho một coding session dài, trong đó giữ context của một session Claude Code ở mức nhỏ là yếu tố quyết định agent hoàn tất công việc hay dừng giữa chừng.

Tự đặt giới hạn lượt chạy khi chạy agent

Nếu bạn điều khiển Claude bằng code của mình, bạn tự quản lý giới hạn lượt chạy của loop. Claude Agent SDK (software development kit) cung cấp max_turns trong Python và maxTurns trong TypeScript. Các tham số này đếm số lượt có gọi tool cùng với phản hồi cuối chỉ có text. Theo tài liệu, mặc định là không giới hạn.

Khi đạt giới hạn này, SDK trả về một result có subtype là error_max_turns. Trong một lần gọi query(), SDK sẽ phát sinh lỗi chứa nội dung Reached maximum number of turns. Trang agent-loop của Agent SDK cũng ghi rõ rằng tiến trình Claude Code nền trả về mã thoát khác 0 cho lỗi trong lần gọi đó. Result vẫn chứa num_turns và session_id. Vì vậy, bạn có thể tiếp tục cùng session với giới hạn cao hơn thay vì chạy lại task.

Từ CLI (command line interface), cùng tùy chọn này được đặt bằng một flag và chỉ áp dụng cho print mode:

claude -p --max-turns 3 "summarise the failing tests"

Tài liệu tham chiếu về flag cho biết mặc định là không giới hạn. Với --input-format stream-json, nếu còn một message đang trong hàng đợi khi giới hạn kết thúc, message đó vẫn nằm trong hàng đợi và bắt đầu một lượt mới với giới hạn riêng. Có một phiên bản tương tự dựa trên chi phí: max_budget_usd trong Python và maxBudgetUsd trong TypeScript dừng loop khi đạt ngưỡng chi tiêu thay vì đếm số lượt. Chi phí của subagent cũng được tính vào tổng này. SDK kiểm tra budget sau khi nhận phản hồi từ model. Vì vậy, chi phí có thể vượt giới hạn do chính phản hồi chạm ngưỡng gây ra và do các subagent chạy nền hoàn tất trước khi dừng. Nếu bạn chạy agent trên server trả phí theo tháng, kiểm soát chi phí của AI agent trên VPS là việc nên thiết lập trước lần chạy dài đầu tiên.

Việc tạm dừng để chờ phê duyệt là một trường hợp khác. Nếu agent dừng và không có chi phí nào phát sinh, hãy đọc permission_mode thay vì chỉ xem số lượt, vì một tool đang chờ câu trả lời của người dùng nhưng không nhận được. chế độ tự động và thiết lập quyền của Claude Code giải thích mode nào yêu cầu xác nhận và mode nào chạy mà không hỏi.

Cách tự kiểm tra hành vi hiện tại

Hành vi có thể thay đổi mà không có thông báo, vì vậy hãy xem mọi con số trong hướng dẫn này là thông tin tại thời điểm viết, không phải giá trị cố định. Có hai nơi cho biết tình trạng hiện tại.

  • Tài liệu API về lý do dừng, trong đó nêu giá trị mặc định của số lượt lặp của server tool và cách tiếp tục sau khi đạt giới hạn đó.
  • Trang trung tâm trợ giúp của Anthropic về thông báo lỗi, trong đó liệt kê nội dung thông báo về giới hạn sử dụng. Được kiểm tra vào ngày 9 November 2026, trang này ghi lại thông báo sử dụng theo năm giờ và theo tuần, bao gồm các phiên bản xuất hiện khi credit sử dụng được dùng thay thế, nhưng không đề cập đến giới hạn tool theo mỗi lượt. Vì không có thông tin này nên ở đây không trích dẫn con số chính thức nào cho ứng dụng chat.

Thay vào đó, hãy đo các lần chạy của chính bạn. Trong Claude Code, /context hiển thị mức sử dụng context hiện tại dưới dạng lưới màu và chỉ ra các tool đang chiếm nhiều context nhất; /compact tóm tắt cuộc hội thoại đến thời điểm hiện tại để giải phóng dung lượng. Trong Agent SDK, mỗi result đều có num_turns, vì vậy bạn có thể biết một task điển hình thực sự cần bao nhiêu lượt trước khi đặt giới hạn. Một con số từ workload của chính bạn có giá trị hơn một con số trong bài đăng trên forum.

FAQ

Giới hạn sử dụng tool có giống giới hạn sử dụng Claude của tôi không?

Không. Giới hạn sử dụng tính tổng mức bạn đã dùng trong một khoảng thời gian và cho biết khi nào giới hạn được reset, nên cách xử lý là chờ. Thông báo về giới hạn sử dụng tool dừng câu trả lời giữa chừng vì câu trả lời đó đã dùng hết số lần gọi tool, còn gửi thêm một message sẽ bắt đầu turn mới với ngân sách mới ngay lập tức. Việc sử dụng tool vẫn được tính vào mức sử dụng trong plan của bạn. cách tính giới hạn sử dụng Claude giải thích đầy đủ trường hợp giới hạn quota.

Làm cách nào để Claude hoàn tất tác vụ đã dừng giữa chừng?

Gửi thêm một message. "Continue" có thể dùng được, nhưng chỉ dẫn nêu rõ phần còn thiếu sẽ hiệu quả hơn vì giúp model không phải dựng lại context mà nó đã có. Nếu lần thứ hai nó vẫn dừng ở cùng một điểm, hãy chia tác vụ thành các phần nhỏ hơn và gửi mỗi message một phần. Cung cấp chính xác file path hoặc dán trực tiếp nội dung sẽ loại bỏ thao tác tìm kiếm đã làm hết ngân sách ngay từ đầu.

"límite de uso de herramientas" hoặc "limite de uso de ferramentas" nghĩa là gì?

Đây là cách viết bằng tiếng Tây Ban Nha và tiếng Bồ Đào Nha của cùng một thông báo, thường xuất hiện dưới dạng "límite de uso de herramientas en este turno" hoặc "limite de uso de ferramentas neste turno". Ý nghĩa trong mọi ngôn ngữ là giống nhau: Claude đã dùng hết số lần gọi tool được phép trong một response, và quota của plan không liên quan. Cách xử lý cũng giống nhau. Hãy trả lời yêu cầu Claude tiếp tục hoặc chia yêu cầu thành các bước nhỏ hơn. Giới hạn billing là một thông báo khác và thông báo đó sẽ nêu thời điểm reset.

Nâng cấp plan có tăng giới hạn sử dụng tool trong một turn không?

Cấp độ plan và ngân sách tool cho mỗi turn là hai cơ chế kiểm soát khác nhau. Nâng cấp plan tăng tổng mức bạn có thể sử dụng trong một khoảng thời gian, tức giới hạn có nêu thời điểm reset. Số lần gọi tool mà một response có thể thực hiện là thuộc tính của loop đang chạy model, và Anthropic không công bố con số đó cho ứng dụng chat. Chia tác vụ thành các turn nhỏ hơn mới là cách thực sự hữu ích, bất kể bạn dùng plan nào.

Tại sao agent của tôi lại dừng chỉ sau vài lần gọi tool?

Kiểm tra xem bạn có đặt giới hạn hay không. Claude Agent SDK dùng max_turns trong Python và maxTurns trong TypeScript, còn giao diện dòng lệnh dùng --max-turns trong print mode. Khi đạt một trong các giới hạn đó, SDK trả về result có subtype là error_max_turns; một lần gọi query() đơn lẻ sau đó sẽ phát sinh lỗi chứa nội dung Reached maximum number of turns. Mặc định của cả hai là không giới hạn. Nếu không có giới hạn nào được đặt mà tiến trình vẫn dừng, hãy đọc stop_reason trong result: max_tokens nghĩa là đã chạm giới hạn output, còn pause_turn nghĩa là server tool loop đã đạt giới hạn số lần lặp và muốn bạn gửi response trở lại để nó có thể tiếp tục.

Bài viết này có hữu ích không?