Nguyên nhân và cách xử lý lỗi 403, Request not allowed trong Claude Code

Những lỗi này trông đều giống như bị từ chối, nhưng nguyên nhân và cách xử lý khác nhau. Nếu gặp lỗi 403 “Request not allowed” sau khi đăng nhập, tài liệu khắc phục sự cố chính thức yêu cầu trước tiên xác nhận gói đăng ký vẫn còn hiệu lực (nếu dùng tài khoản Console, hãy xác nhận tài khoản có vai trò Claude Code hoặc Developer); khi tài khoản bị tạm ngưng, đăng nhập lại cùng tài khoản sẽ không gỡ bỏ trạng thái này; “This organization has been disabled” xuất hiện do biến môi trường chứa ANTHROPIC_API_KEY cũ thuộc một tổ chức đã bị vô hiệu hóa. Hãy xóa biến này rồi khởi động lại claude; nếu đã lưu thông tin đăng nhập bằng gói đăng ký, Claude Code sẽ chuyển về dùng đăng nhập bằng gói đăng ký. Trước tiên, chạy /status để xem Claude Code hiện dùng loại thông tin xác thực nào, rồi đối chiếu với bảng bên dưới.

Lỗi

Lỗi hiển thị trong Claude Code

# 请求被拒、提示重新登录（GitHub #50411 报告里的原文）
Please run /login · API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}}

# 账号被暂停（Claude Code 官方报错文档原文）
Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted

# 环境变量里的 key 属于被停用的组织（官方原文；状态码是 400，不是 403）
Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
API Error: 400 ... This organization has been disabled.

Tổng quan nguyên nhân và cách khắc phục

Nguyên nhân	Cách khắc phục
Lỗi API Error: 403 Request not allowed sau khi đăng nhập (mục “403 Forbidden after login” trong tài liệu khắc phục sự cố chính thức): gói đăng ký có thể đã hết hiệu lực hoặc tài khoản Console không có vai trò bắt buộc.	Người dùng Pro / Max hãy truy cập claude.ai/settings để xác nhận gói đăng ký còn hiệu lực; người dùng Console hãy xác nhận tài khoản có vai trò Claude Code hoặc Developer. Nếu không có, hãy nhờ quản trị viên phân vai trò trên trang thành viên trong Console.
Tài khoản bị tạm ngưng: “Your account is on hold” (theo giải thích chính thức: tài khoản Claude đứng sau phiên đăng nhập đã bị tạm ngưng).	Mở liên kết trong thông báo lỗi để xem chi tiết hoặc gửi khiếu nại. Đăng nhập lại cùng tài khoản không có tác dụng vì tài khoản bị tạm ngưng, chứ không phải phiên đăng nhập.
Biến môi trường còn lưu một ANTHROPIC_API_KEY cũ thuộc tổ chức Console đã bị vô hiệu hóa (“This organization has been disabled”, mã trạng thái 400).	Xóa ANTHROPIC_API_KEY khỏi shell hiện tại và các tệp cấu hình shell (hoặc tệp .env), khởi động lại claude, rồi chạy /status để xác nhận thông tin xác thực hiện tại.
Khi đã đặt ANTHROPIC_BASE_URL và yêu cầu đi qua cổng bên thứ ba mà nhận lỗi 403: yêu cầu bị từ chối ở phía cổng — có thể do chính cổng, tường lửa phía trước cổng hoặc từ chối từ dịch vụ thượng nguồn mà cổng chuyển tiếp.	Các thông tin xác thực trong biến môi trường như ANTHROPIC_AUTH_TOKEN được ưu tiên hơn thông tin đăng nhập đã lưu bằng /login (theo tài liệu xác thực chính thức); đăng nhập lại không thay đổi được việc cổng từ chối yêu cầu. Hãy xem nội dung nguyên văn xuất hiện sau API Error: 403. Kunavo chỉ trả về 403 trong một trường hợp: key có thiết lập danh sách IP cho phép nhưng yêu cầu đến từ địa chỉ ngoài danh sách; nếu lấy được địa chỉ, thông báo lỗi sẽ ghi IP mà hệ thống nhận diện.
Trên GitHub, người dùng Pro và Max đã báo cáo rằng Cowork, Dispatch hoặc phiên SSH từ xa trên ứng dụng máy tính để bàn gặp lỗi 403 Request not allowed, trong khi tính năng trò chuyện hoặc Claude Code trên dòng lệnh của cùng tài khoản vẫn hoạt động bình thường. Các báo cáo không nêu nguyên nhân do phía chính thức đưa ra.	Trước tiên, chạy claude trong terminal bằng cùng tài khoản để xác định liệu chính phiên đăng nhập bị từ chối hay chỉ một tính năng nào đó trên ứng dụng máy tính để bàn bị từ chối.
Người dùng trên GitHub đã báo cáo rằng yêu cầu của Claude Code nhận lỗi 403 Request not allowed khi họ ở khu vực ngoài danh sách hỗ trợ của Anthropic. Đây là báo cáo của người dùng; tài liệu chính thức không giải thích lỗi 403 này theo cách đó.	Xem các quốc gia và khu vực nơi Anthropic cung cấp dịch vụ tại anthropic.com/supported-countries; nếu khu vực của bạn không có trong danh sách, việc thử lại hoặc đăng nhập lại cũng không thay đổi được điều đó.

Trước tiên, hãy xác định loại thông tin xác thực đang được sử dụng

Trong Claude Code, chạy /status để xem thông tin xác thực đang có hiệu lực là đăng nhập bằng gói đăng ký, ANTHROPIC_API_KEY hay ANTHROPIC_AUTH_TOKEN. Khi hướng dẫn xử lý lỗi “This organization has been disabled”, tài liệu lỗi chính thức cũng yêu cầu chạy /status sau khi xóa biến để xác nhận thông tin xác thực hiện tại đã chuyển sang đăng nhập bằng gói đăng ký. Tài liệu khắc phục sự cố chính thức còn cho biết nếu bạn có gói đăng ký nhưng vẫn thấy lỗi này, ANTHROPIC_API_KEY trong biến môi trường đã ghi đè gói đăng ký; nguyên nhân thường gặp là key cũ còn sót lại từ công ty hoặc dự án trước đây.

Các trường hợp thử lại và đăng nhập lại đều không có tác dụng

Nếu khu vực của bạn không nằm trong danh sách hỗ trợ của Anthropic, việc thử lại và đăng nhập lại cũng không thay đổi được điều đó; trong mục về lỗi không thể kết nối với dịch vụ Anthropic khi khởi chạy lần đầu (“Unable to connect to Anthropic services”), tài liệu lỗi chính thức cho biết Claude Code có thể không khả dụng tại quốc gia của bạn nếu mạng bình thường nhưng kết nối vẫn liên tục thất bại. Khi tài khoản bị tạm ngưng, theo giải thích chính thức, đăng nhập lại bằng cùng tài khoản sẽ không gỡ bỏ thông báo vì tài khoản bị tạm ngưng, chứ không phải phiên đăng nhập; để xem chi tiết hoặc gửi khiếu nại, hãy mở liên kết trong thông báo lỗi. Tài liệu chính thức cũng nêu rõ rằng nếu bạn có tài khoản Claude hoặc API key khác không bị ảnh hưởng bởi lần tạm ngưng này, trong thời gian xử lý, bạn có thể chạy /login để đăng nhập vào tài khoản đó hoặc đặt key bằng ANTHROPIC_API_KEY để tiếp tục làm việc.

Không phụ thuộc vào tài khoản Claude: chuyển sang dùng API key

Bạn có thể dùng Claude Code mà không cần đăng nhập tài khoản Claude, bằng cách thanh toán theo token với API key: dùng key của Anthropic bằng ANTHROPIC_API_KEY; nếu đi qua cổng bên thứ ba, hãy đặt ANTHROPIC_BASE_URL cùng biến thông tin xác thực mà cổng yêu cầu — với Kunavo, đó là ANTHROPIC_AUTH_TOKEN. Khi dùng Kunavo, bạn cũng cần cố định bốn biến mô hình: bí danh sonnet của Claude Code trỏ đến Sonnet mới nhất; nếu Kunavo chưa niêm yết phiên bản đó, các yêu cầu dùng bí danh này sẽ báo 404. Nếu trước đó bạn đã đăng nhập bằng /login, khi khởi chạy sẽ có thông báo rằng đang tồn tại đồng thời hai loại thông tin xác thực; theo cách chính thức, hãy chạy /logout nếu chỉ muốn dùng key trong biến môi trường. Với cấu hình này, bạn không dùng hạn mức gói đăng ký; khi dùng Kunavo, chi phí được trừ theo token từ số dư trả trước. Xem hướng dẫn cài đặt Claude Code để biết các bước đầy đủ.

~/.zshrc

export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Nếu bạn gọi qua Kunavo

Khi dùng key Kunavo, các yêu cầu mô hình của Claude Code được xác thực bằng key này và gửi đến api.kunavo.com, không dùng tài khoản Claude của bạn; chi phí được trừ theo token từ số dư trả trước, có thể nạp bằng Alipay hoặc WeChat Pay. Chính sách sử dụng được chấp nhận của Kunavo vẫn áp dụng; chính sách này nêu rõ rằng các chính sách sử dụng của nhà cung cấp thượng nguồn như Anthropic cũng áp dụng cho nội dung bạn gửi đến họ. Với lỗi do Kunavo tự trả về, 401 nghĩa là key không hợp lệ hoặc tài khoản đã bị vô hiệu hóa, 402 nghĩa là không đủ số dư hoặc đã đạt hạn mức hằng tháng, 403 nghĩa là danh sách IP cho phép của key không bao gồm địa chỉ hiện tại, còn 404 nghĩa là Kunavo không có tên mô hình đó (ví dụ: chưa cố định bí danh sonnet và phiên bản mà bí danh trỏ đến chưa được niêm yết). Nếu nhà cung cấp thượng nguồn từ chối key Kunavo (phản hồi 401, 402 hoặc 403), bạn sẽ nhận được lỗi 502. Các yêu cầu thất bại không bị tính phí. Xem giá của hai phương thức thanh toán gói đăng ký và API key, cũng như chi phí ước tính cho một ngày lập trình, tại Giá Claude Code.

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

Lỗi 403 Request not allowed trong Claude Code có nghĩa là gì?

Đây là lỗi HTTP 403: yêu cầu đã nhận được phản hồi nhưng bị từ chối, không phải do không kết nối được mạng. Mục “403 Forbidden after login” trong tài liệu khắc phục sự cố chính thức dành riêng cho lỗi API Error: 403 Request not allowed xuất hiện sau khi đăng nhập; các bước kiểm tra được nêu gồm: người dùng Pro / Max xác nhận gói đăng ký còn hiệu lực tại claude.ai/settings, người dùng Console xác nhận tài khoản có vai trò Claude Code hoặc Developer. Ngoài ra, người dùng trên GitHub đã báo cáo lỗi này xuất hiện trong Cowork, Dispatch và phiên SSH từ xa trên ứng dụng máy tính để bàn, cũng như khi họ ở khu vực ngoài danh sách hỗ trợ của Anthropic; đây là báo cáo của người dùng, không phải nguyên nhân do phía chính thức đưa ra. Trước tiên, chạy /status để xem thông tin xác thực hiện tại, rồi đối chiếu với bảng trên trang này.

Đăng nhập lại (/login) có khắc phục được không?

Còn tùy nguyên nhân. Nếu key cũ trong biến môi trường ghi đè thông tin đăng nhập đã lưu, hãy xóa biến rồi khởi động lại claude để chuyển sang dùng thông tin đăng nhập đó; nếu phiên đăng nhập đã hết hạn, chạy /login sẽ khắc phục được. Khi tài khoản bị tạm ngưng, theo giải thích chính thức, đăng nhập lại cùng tài khoản sẽ không gỡ bỏ trạng thái này; nếu khu vực của bạn không nằm trong danh sách hỗ trợ, đăng nhập lại cũng không thay đổi được điều đó.

“Your account is on hold” có nghĩa là tài khoản đã bị khóa không?

Theo cách diễn đạt chính thức, tài khoản Claude đứng sau phiên đăng nhập đã bị tạm ngưng (suspended). Để xử lý, hãy mở liên kết claude.ai/restricted trong thông báo lỗi để xem chi tiết hoặc gửi khiếu nại; đăng nhập lại cùng tài khoản sẽ không gỡ bỏ trạng thái này. Tài liệu chính thức cũng nêu rõ rằng nếu bạn có tài khoản Claude hoặc API key khác không bị ảnh hưởng bởi lần tạm ngưng này, bạn có thể dùng chúng để tiếp tục làm việc trong thời gian xử lý.

Phải làm gì khi gặp “This organization has been disabled”?

Theo giải thích chính thức, đây là lỗi 400: Claude Code đã dùng một ANTHROPIC_API_KEY cũ trong biến môi trường, thuộc tổ chức Console đã bị vô hiệu hóa; nếu bạn đã lưu thông tin đăng nhập bằng gói đăng ký, key này sẽ ghi đè thông tin đó. Hãy xóa biến này khỏi shell hiện tại và các tệp cấu hình shell (hoặc tệp .env), khởi động lại claude rồi chạy /status để xác nhận. Nếu nửa sau của thông báo lỗi ghi “Update or unset”, tức là không có thông tin đăng nhập đã lưu để chuyển về: hãy chạy /login hoặc thay bằng key thuộc một tổ chức còn hiệu lực.

Claude Code có dùng được mà không đăng nhập tài khoản Claude không?

Được. Claude Code hỗ trợ thanh toán theo token bằng API key: dùng key của Anthropic bằng ANTHROPIC_API_KEY; nếu đi qua cổng bên thứ ba, hãy đặt ANTHROPIC_BASE_URL cùng biến thông tin xác thực mà cổng yêu cầu; với Kunavo, đó là ANTHROPIC_AUTH_TOKEN. Sau đó, cố định bốn biến mô hình. Cách này không dùng hạn mức gói đăng ký; chi phí được tính theo số token thực tế. Có thể nạp số dư Kunavo bằng Alipay hoặc WeChat Pay.

Dùng API key thì có thể gặp lỗi 403 không?

Khi dùng key Kunavo, chỉ có một trường hợp Kunavo tự trả về lỗi 403: key được thiết lập danh sách IP cho phép nhưng yêu cầu đến từ địa chỉ ngoài danh sách. Nếu lấy được địa chỉ, thông báo lỗi sẽ ghi IP mà hệ thống nhận diện; hãy vào /app/keys để cập nhật danh sách cho phép. Key không hợp lệ sẽ báo 401, số dư không đủ sẽ báo 402; nếu nhà cung cấp thượng nguồn từ chối key Kunavo, bạn sẽ nhận lỗi 502 chứ không phải 403.

Hướng dẫn liên quan

Thông tin chi tiết hơn về ý nghĩa lỗi có trong tài liệu tham chiếu lỗi; bạn chỉ mất một phút để lấy khóa qua đăng ký và hướng dẫn xác thực.