Claude Code bị treo, mắc kẹt hoặc ngừng phản hồi: cách xác định vị trí bị kẹt và thoát khỏi tình trạng đó

Mắc kẹt ở đâu? Xem màn hình, rồi kiểm tra tiến trình

# in the session
Esc            # cancel the current tool or turn
Ctrl+C (twice) # abort the turn / exit
# from another terminal
ps aux | grep -E "claude|node" | grep -v grep     # child processes still running?
top -o cpu       # is claude spinning or idle?
claude --debug   # next time: timestamps for every request and tool call
claude -c        # resume the last session after a kill

CPU nhàn rỗi trong khi câu lệnh bị đơ nghĩa là nó đang chờ một thứ bên ngoài: luồng mạng, máy chủ MCP, tiến trình con hoặc lời nhắc bạn không nhìn thấy. CPU chạy hết công suất nghĩa là nó đang xử lý thứ gì đó bên trong: phân tích kết quả công cụ khổng lồ, quay lui trong biểu thức chính quy hoặc tải một phiên lớn. Bộ nhớ tăng đều nghĩa là kết quả công cụ hoặc tệp phiên đang được nạp toàn bộ.

Các nguyên nhân đã biết trên hệ thống theo dõi vấn đề

• `/rewind` bị treo, `Ctrl+C` bị bỏ qua, cần `kill -9` (#53011, 21 lượt phản hồi, trong các phiên có kích thước bất kỳ trên các bản dựng 2.1.1xx). Một kỹ sư Anthropic không thể tái hiện trên 2.1.233, vì vậy hãy cập nhật trước; nếu đang dùng bản dựng cũ, hãy kết thúc tiến trình rồi tiếp tục bằng claude -c thay vì quay lại.
• Các phiên Remote Control bị đóng băng giữa chừng khi thực thi và chỉ `Esc` trên máy cục bộ mới khôi phục được (#51267, đang mở). Bất kỳ công cụ hoặc tiến trình con nào bị chặn đều khiến toàn bộ phiên từ xa bị đóng băng mà không thể hủy từ xa; hãy giữ các phiên này ngắn và tránh các công cụ có thể yêu cầu nhập liệu.
• Lời nhắc xác thực MCP bị treo tại `Enter` (#42707, đang mở). Xác thực máy chủ bằng một lệnh claude mcp riêng hoặc trình duyệt, rồi khởi động lại phiên.
• `grep` qua bộ so khớp tích hợp ngốn hết bộ nhớ (#54394): trên các bản dựng gốc, mỗi lệnh shell grep đều chạy bên trong một tiến trình claude có heap V8 riêng; biểu thức chính quy có quay lui chạy trên một dòng dài đã được rút gọn có thể khiến bộ nhớ tăng lên hàng gigabyte, và bộ phận kết thúc tiến trình khi hết bộ nhớ (OOM killer) cũng kết thúc luôn phiên, trên cả WSL2 lẫn Linux. Tránh các biểu thức chính quy không giới hạn trên tệp đã rút gọn, loại trừ đầu ra bản dựng và node_modules, hoặc cài bản hệ thống của ripgrep và gọi trực tiếp.
• Mắc kẹt trong vòng lặp thử lại tại `400 thinking blocks cannot be modified` (#63231) — lịch sử hội thoại không hợp lệ và mọi lần thử lại đều thất bại theo cùng một cách. /rewind về trước lượt đó, hoặc /clear; xem hướng dẫn 400.
• **Các lượt chạy trên đám mây / theo lịch bị kẹt ở *Đang thiết lập vùng chứa đám mây*** (#53691, #54528) — vấn đề nằm ở phía dịch vụ; không có gì cần xử lý cục bộ, hãy hủy và kiểm tra trạng thái.claude.com.
• Tiếp tục một phiên lớn mất nhiều phút — bản ghi hội thoại được phát lại khi bắt đầu. Hãy tiếp tục đúng phiên bạn cần (claude -r) thay vì phiên lớn nhất, và để tính năng nén ngữ cảnh thu nhỏ các phiên quá lớn.

Bị treo khi khởi động

Màn hình trống ngay sau claude mà không có lời nhắc thường là do lệnh gọi API đầu tiên không trả về: biến proxy trỏ đến proxy không hoạt động, VPN, DNS hoặc không thể truy cập ANTHROPIC_BASE_URL. Chạy phép kiểm tra bằng curl trong hướng dẫn về lỗi kết nối, sau đó claude doctor. Nếu khởi động chậm nhưng cuối cùng vẫn xuất hiện lời nhắc, nguyên nhân là các máy chủ MCP đang được khởi chạy; claude mcp list và loại bỏ các máy chủ hết thời gian chờ.

Các tiến trình con không bao giờ thoát

Một công cụ shell mở trình soạn thảo, chờ mật khẩu, theo dõi phần cuối nhật ký hoặc khởi động máy chủ phát triển sẽ không bao giờ trả về, và lượt xử lý sẽ chờ nó. Hãy yêu cầu tác nhân chạy máy chủ ở chế độ nền và thêm --no-pager, -y hoặc < /dev/null ở những nơi lệnh có thể yêu cầu nhập liệu. Nếu tình trạng này đã xảy ra, Esc sẽ hủy công cụ; nếu tiến trình con bỏ qua thao tác đó, hãy kết thúc nó bằng PID từ một cửa sổ terminal khác và lượt xử lý sẽ tiếp tục với lỗi.

Mức sử dụng bộ nhớ và CPU cao

• Kết quả công cụ được giữ trong bộ nhớ và trên đĩa suốt phiên; đọc một tệp 200 MB sẽ tạo ra một phiên 200 MB. Chỉ đọc những phần bạn cần.
• Nhiều tác nhân phụ chạy song song sẽ nhân lên mọi mức sử dụng; CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2 trên máy có cấu hình thấp.
• Các trình giả lập terminal hiển thị chậm (một số console Windows, tmux từ xa qua đường truyền băng thông thấp) khiến đầu ra truyền liên tục trông như bị đóng băng; claude --debug cho biết liệu các token có còn đến hay không.
• Nếu bộ nhớ tăng khi không hoạt động, hãy tìm các tiến trình claude còn sót lại từ những phiên IDE bị sự cố và kết thúc chúng (tiến trình đã thoát với mã 1 đề cập đến trường hợp tiến trình mồ côi trên Windows).

Khi vấn đề nằm ở API, không phải ứng dụng khách

Một phiên bị treo ở cùng một điểm trong mọi lượt, với biểu tượng xoay nhỏ và cuối cùng xuất hiện dòng thử lại, cho thấy đường kết nối API chậm hoặc bị ngắt thay vì lỗi ứng dụng khách: 529 quá tải, giới hạn tốc độ từ phía máy chủ hoặc kết nối bị đặt lại. Qua một cổng trung gian (ANTHROPIC_BASE_URL=https://aiprimetech.io), khi một tài khoản phía thượng nguồn bị quá tải, yêu cầu sẽ được chuyển sang tài khoản khác, giúp rút ngắn chính những lần chờ này.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Câu hỏi thường gặp

AI Prime Tech là một cổng API độc lập, không có quan hệ liên kết với Anthropic và không được Anthropic chứng thực hay tài trợ. “Claude” và “Claude Code” là các nhãn hiệu của Anthropic. Các tính năng Claude Code được mô tả ở đây dựa trên tài liệu công khai của Anthropic tại thời điểm viết và thường xuyên thay đổi; giá và danh sách mô hình trên trang này được đọc từ cấu hình hiện hành của cổng API này.