Trang chủ › Claude Code › Lỗi › Lỗi API 500
Tổng quanCài đặttài liệu tham khảo CLIGiá và giới hạnAgent SDKKỹ năng và pluginGitHubWeb, máy tính và IDEMô hìnhLỗiCó phải mã nguồn mở?Hướng dẫn thực hànhDành cho sinh viênTự động hóa QASo với CursorSo với Codex và OpenCodeTác tử phụHookMCPHệ sinh tháiVS CodeOpenRouterGiới hạn tốc độHướng dẫn bằng tiếng Trung
Cập nhật lần cuối: ngày 11 tháng Mười, 2026

Claude Code "Lỗi API: 500": ý nghĩa và những cách thực sự khắc phục được

API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}} là tình trạng phía mô hình của API không thể trả lời. Đây là lỗi được báo cáo nhiều nhất trong lịch sử Claude Code — tìm kiếm "API Error: 500" trên trình theo dõi vấn đề anthropics/claude-code trả về 881 vấn đề, và các báo cáo mới vẫn được gửi mỗi tuần. Hầu như không bao giờ là lỗi của bạn; gần như luôn có thể khắc phục trong chưa đầy một phút.

TLDR

  • 500 = API gặp lỗi nội bộ. Khóa, câu lệnh và cấu hình của bạn đều ổn.
  • Kiểm tra status.claude.com trước — trong thời gian xảy ra sự cố, hàng trăm người gặp lỗi cùng lúc.
  • Tiếp tục phiên bằng claude -c; nếu lỗi lặp lại, /model sang một cấp mô hình khác (lỗi 500 thường chỉ xảy ra với một mô hình cụ thể).
  • Lỗi 500 xuất hiện đúng lúc ngữ cảnh đạt 0% có nghĩa là việc rút gọn đã thất bại: /compact hoặc /clear, rồi tiếp tục.

Các thông báo chính xác

API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}}
API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"},"request_id":null}
[Bug] Anthropic API Error: 500 Internal Server Error

Cả ba đều là cùng một lỗi. Hai thông báo đầu là những gì CLI hiển thị; thông báo thứ ba là tiêu đề của các báo cáo lỗi tự động mà Claude Code gửi qua /bug, vì vậy trình theo dõi có hàng trăm báo cáo giống nhau — các báo cáo mới nhất trong nhóm này được gửi vào tháng Chín 16 và Ngày 22 tháng Chín năm 2026, báo cáo sau đề cập đồng thời cả lỗi 500 và 529.

Tại sao lỗi xảy ra

  • Sự cố ở phía nhà cung cấp. Đây là nguyên nhân phổ biến nhất, vượt xa các nguyên nhân khác. Khi Anthropic bị gián đoạn dịch vụ một phần, mọi người dùng một mô hình đều gặp lỗi 500 cùng lúc — đợt lỗi tháng Một 2026 trong #9066 được nhân viên Anthropic trả lời bằng một liên kết duy nhất: trang trạng thái.
  • Một mô hình suy giảm chất lượng dịch vụ, các mô hình khác vẫn ổn. Lỗi 500 thường xảy ra riêng với từng mô hình. Trong #3127 cách khắc phục được bình chọn nhiều nhất chỉ là chuyển từ Opus sang Sonnet; sau đó cùng phiên đó đã hoạt động.
  • Ngữ cảnh đã hết dung lượng, việc rút gọn thất bại. Báo cáo gốc #3127 gặp 500 "khi ngữ cảnh còn lại ở đúng 0% và Claude Code không thể tự động thu gọn". Một yêu cầu quá lớn có thể xuất hiện dưới dạng 500 thay vì lỗi rõ ràng hơn Prompt is too long 400.
  • Một cấu trúc yêu cầu cụ thể khiến backend không xử lý được. Hiếm gặp hơn; #91801 đã tái hiện được các lỗi 500 gắn với một số tiền tố prompt nhất định. Nếu một tin nhắn luôn gây lỗi 500 còn các tin nhắn khác thì không, hãy thay đổi tin nhắn đó.

Các cách khắc phục, theo thứ tự nên thử

  • 1. Kiểm tra status.claude.com. Nếu đang có sự cố, bạn không thể làm gì ở phía mình để khắc phục — hãy chờ sự cố qua đi.
  • 2. Tiếp tục phiên, đừng khởi động lại: claude -c tiếp tục phiên gần nhất; lượt xử lý đang dở sẽ được thử lại.
  • 3. Đổi cấp mô hình cho tác vụ hiện tại: /model → Sonnet nếu bạn đang dùng Opus/Fable, hoặc ngược lại. Công suất và lỗi là riêng cho từng mô hình.
  • 4. Nếu chỉ báo ngữ cảnh gần 0%: /compact (hoặc /clear và cung cấp lại thông tin cần thiết), rồi tiếp tục. Chuyển sang một (1M) biến thể mô hình cũng có tác dụng.
  • 5. Cập nhật: claude update. Theo thời gian, một số lỗi liên quan đến 500 đã được sửa ở phía máy khách.
  • 6. Vẫn lỗi với một tin nhắn cụ thể? Diễn đạt lại hoặc chia nhỏ tin nhắn — lỗi 500 do cấu trúc yêu cầu có tính tất định.
claude -c              # resume the session
/model claude-sonnet-5 # inside the session: another tier
/compact               # if the context was exhausted
claude update          # latest CLI

500 so với 529 so với 429

Vì sao các gateway gặp ít lỗi này hơn

Lỗi 500 từ một tài khoản thượng nguồn chỉ là điểm lỗi duy nhất nếu bạn chỉ có một tài khoản thượng nguồn. Gateway này tập hợp nhiều tài khoản và chuyển yêu cầu sang tài khoản khác khi một tài khoản trả về 500 hoặc 529, nên phần lớn lỗi 500 tạm thời không bao giờ đến terminal của bạn. Một sự cố thực sự trên toàn nhà cung cấp vẫn sẽ xuất hiện — không ai có thể định tuyến để tránh việc mô hình ngừng hoạt động. Cấu hình Claude Code trỏ đến gateway bằng ANTHROPIC_BASE_URL=https://aiprimetech.io và một khóa gateway.

Bạn đã mệt mỏi vì phải xử lý lỗi này?

Hãy chạy Claude Code qua gateway AI Prime Tech: vẫn là các mô hình Claude đó, sử dụng tài khoản upstream riêng của gateway, chỉ cần hai biến môi trường để chuyển đổi, và tài khoản mới nhận được $5 tín dụng API miễn phí với mã FIXIT — không cần thẻ.

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

Tạo tài khoản với mã FIXIT

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

Lỗi API 500 của Claude Code có nghĩa là gì?

API Claude gặp lỗi nội bộ khi trả lời ({"type":"api_error","message":"Lỗi máy chủ nội bộ"}). Đây là lỗi phía máy chủ, không phải vấn đề với khóa hoặc cấu hình của bạn.

Làm cách nào để khắc phục lỗi API: 500 trong Claude Code?

Kiểm tra status.claude.com, tiếp tục phiên bằng claude -c, đổi cấp mô hình bằng /model và dùng /compact nếu ngữ cảnh gần đầy. Cập nhật bằng claude update nếu lỗi vẫn tiếp diễn.

Vì sao tôi liên tục gặp lỗi 500 từ Claude?

Thường là do sự cố thượng nguồn đang diễn ra hoặc một mô hình bị suy giảm hoạt động. Nếu chỉ một tin nhắn lần nào cũng gây lỗi, thì vấn đề nằm ở chính yêu cầu — hãy diễn đạt lại hoặc chia nhỏ.

Claude có ngừng hoạt động khi tôi gặp lỗi 500 không?

Thường là có — ít nhất một mô hình đang ngừng hoạt động. Cả trang trạng thái và trình theo dõi vấn đề trên GitHub đều xuất hiện thông tin chỉ trong vài phút khi có sự cố.

Chạy Claude Code trên cổng API

Vẫn các mô hình đó, hai biến môi trường, tín dụng có giá trị sử dụng gấp 7.69231× mệnh giá — hoặc gói không giới hạn với phí cố định. Tài khoản mới: $5 tín dụng API miễn phí với mã FIXIT.

Lấy khóa API Xem các gói không giới hạn

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.

Thêm hướng dẫn về Claude Code

Các lỗi Claude Code và cách khắc phụcLỗi Claude "Quá tải" (Lỗi API 529): ý nghĩa và cách xử lýLỗi API Claude Code 400: câu lệnh quá dài, sử dụng công cụ đồng thời và các lỗi khácLỗi OAuth trong Claude Code: vượt quá thời gian chờ 15000ms và mã trạng thái 500"Tiến trình Claude Code đã thoát với mã 1": cách tìm lỗi thực sự và khắc phụcClaude "Câu lệnh quá dài", "Đầu vào quá dài đối với mô hình được yêu cầu" và "Đã đạt giới hạn ngữ cảnh": điều gì làm đầy cửa sổ và cách giải phóngĐã đạt giới hạn sử dụng Claude: giới hạn phiên, hàng tuần và Opus, "giới hạn sử dụng API được chỉ định", "số dư tín dụng quá thấp" — và cách xử lýClaude Code 401 và 403: thông tin xác thực không hợp lệ, khóa API không hợp lệ, "Chưa đăng nhập", host_not_allowedLỗi kết nối Claude Code: ECONNRESET, mất kết nối giữa chừng khi đang nhận phản hồi, "Đang chờ phản hồi API", "Không thể kết nối với API", lỗi chứng chỉ SSLClaude 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 đóClaude.ai không hoạt động: "Đã xảy ra lỗi", hạn chế về năng lực phục vụ, "Đã đạt giới hạn 5 giờ", "Lỗi khi đăng nhập" và các lỗi khác