Lỗi Claude Code "401 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" và 403

Các thông báo

API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid authentication credentials"}}
API Error: 401 invalid x-api-key
Invalid API key · Fix external API key
Not logged in · Please run /login
Login expired · Please run /login
API Error: 403 x-deny-reason: host_not_allowed
Error: Poll: Access denied (403): Account is no longer a member of the organization associated with this token.

Bước 1: thông tin xác thực nào đang được gửi?

claude
/status                       # auth method, endpoint, model
echo $ANTHROPIC_API_KEY | cut -c1-12
echo $ANTHROPIC_BASE_URL
grep -n apiKeyHelper ~/.claude/settings.json

Thứ tự ưu tiên rất đơn giản khi bạn đã biết: một ANTHROPIC_API_KEY trong môi trường (hoặc giá trị được trả về bởi apiKeyHelper) được dùng thay cho phiên đăng nhập OAuth. Một khóa cũ được xuất trong .bashrc từ nhiều tháng trước, hoặc một khóa từ gateway khác, là nguyên nhân điển hình của lỗi 401 vẫn tồn tại sau mọi lần /login. Hãy bỏ thiết lập biến đó hoặc đặt khóa đúng.

401 khi dùng khóa API: khóa và endpoint không khớp

invalid x-api-key và Invalid API key · Fix external API key nghĩa là endpoint không nhận ra khóa. Một khóa chỉ thuộc về đúng một endpoint: khóa từ bảng điều khiển Anthropic chỉ hoạt động với api.anthropic.com; khóa gateway chỉ hoạt động với ANTHROPIC_BASE_URLcủa gateway đó. Gửi khóa từ bảng điều khiển đến https://aiprimetech.io hoặc gửi khóa gateway đến Anthropic đều trả về 401. Đồng thời kiểm tra xem có ký tự xuống dòng hoặc dấu ngoặc kép bị dán vào cuối biến hay không, và khóa có bị thu hồi hoặc thay mới trên bảng điều khiển hay không.

curl -s https://aiprimetech.io/v1/models -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" | head -c 300
# a JSON list = key accepted; authentication_error = wrong key for this host

401 sau /login: token OAuth

API Error: 401 Invalid authentication credentials ngay sau khi đăng nhập thành công trên trình duyệt là dạng được báo cáo nhiều nhất (#69706, đang mở, Windows, gói Pro đang hoạt động; #44265, token được báo là hết hạn ngay sau khi đăng nhập).

Một người bình luận trong chủ đề đầu tiên phát hiện rằng refreshToken đã lưu là một chuỗi rỗng trong ~/.claude/.credentials.json, khiến mọi yêu cầu đều gặp 401 cho đến khi tệp được thay thế bằng một lần đăng nhập mới. #54443 ghi nhận việc máy chủ từ chối phiên trước thời điểm hết hạn được lưu cục bộ và lệnh gọi làm mới trả về 400, nên Please run /login lại xuất hiện sau vài giờ; chạy nhiều phiên bản Claude Code trên cùng một tài khoản khiến tình hình tệ hơn, vì chúng tranh nhau làm mới cùng một token. #44585: /login in ra *Đăng nhập thành công* rồi lập tức trở lại *Chưa đăng nhập*.

/logout, sau đó xóa thông tin xác thực đã lưu (~/.claude/.credentials.json trên Linux và Windows; mục *Claude Code-credentials* trong Keychain trên macOS), rồi /login trong một trình duyệt không có tiện ích Claude in Chrome.
Đóng các cửa sổ Claude Code khác, ứng dụng desktop và tiện ích IDE trước khi đăng nhập; chúng làm mới cùng một token. Trang lỗi OAuth đề cập đến lỗi *Không thể làm mới token OAuth: một tiến trình Claude Code khác đang làm mới token*.
claude update: #54235 đã truy ra lỗi 401 liên quan đến một phiên bản cụ thể và một biến môi trường cờ beta; các lỗi hồi quy về xác thực thường được sửa nhanh.
Máy không có giao diện đồ họa hoặc máy truy cập qua SSH: claude setup-token trên một máy mà việc đăng nhập qua trình duyệt hoạt động, rồi dùng token trên máy đó.
Làm việc được ngay quan trọng hơn gỡ lỗi: khi ANTHROPIC_API_KEY được đặt, Claude Code không bao giờ dùng đến OAuth.

403: được phép xác thực, nhưng không được phép thực hiện thao tác đó

`x-deny-reason: host_not_allowed` — một proxy đứng trước yêu cầu từ chối đích đến. Đã gặp trong danh sách cho phép lưu lượng ra của sandbox web/desktop (#93562, đang mở: các máy chủ ngoài danh sách tích hợp sẵn nhận 403 trên CONNECT ngay cả khi đã chọn *Tất cả miền*) và từ các proxy doanh nghiệp. Thêm máy chủ vào danh sách cho phép hoặc chạy CLI bên ngoài sandbox.
Proxy git của sandbox 403 trên git push đến một nhánh đã tồn tại (#57356) — do chính sách proxy git của sandbox, không phải GitHub. Hãy đẩy từ một terminal thông thường.
`Account is no longer a member of the organization associated with this token` — token được cấp cho một tổ chức mà bạn đã rời khỏi hoặc đã thay đổi; claude remote-control từng khiến mọi phiên gặp sự cố vì điều này (#53563). Đăng xuất rồi đăng nhập lại để tạo token cho tổ chức hiện tại.
403 từ một gateway — khóa hợp lệ nhưng tài khoản bị vô hiệu hóa, không đủ số dư cho mô hình đó hoặc mô hình không nằm trong gói của bạn; nội dung phản hồi cho biết nguyên nhân cụ thể. Kiểm tra bảng điều khiển trước khi thay đổi bất cứ thứ gì ở phía máy khách.
`/feedback` trả về 403 (#55348) — sự cố phía dịch vụ của riêng endpoint đó; sự cố này không ảnh hưởng đến mô hình.

Cách sử dụng khóa API

unset ANTHROPIC_API_KEY ANTHROPIC_BASE_URL   # back to the subscription login
# or: bypass OAuth entirely
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

Khóa gateway là một khóa API thông thường: không có OAuth, không có làm mới token, không có tư cách thành viên tổ chức, và nhóm lỗi 401 chỉ còn là câu hỏi *khóa có khớp với máy chủ hay không*. Nếu bạn đang mắc kẹt trong một /login vòng lặp và cần phát hành ngay hôm nay, đây là cách thoát nhanh nhất; lần nạp tiền mã hóa đầu tiên của bạn được nhân đôi (+50%).

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àm cách nào để sửa lỗi 'API Error: 401 Invalid authentication credentials' trong Claude Code?

Kiểm tra /status để xem thông tin xác thực đang được sử dụng. Hủy thiết lập ANTHROPIC_API_KEY đã cũ, hoặc chạy /logout, xóa ~/.claude/.credentials.json (Keychain trên macOS) rồi chạy /login lại sau khi đóng các phiên Claude Code khác. Một cách thay thế là dùng khóa API để bỏ qua hoàn toàn OAuth.

Tại sao Claude Code báo khóa API không hợp lệ?

Khóa không thuộc về điểm cuối trong ANTHROPIC_BASE_URL. Khóa từ bảng điều khiển cần api.anthropic.com; khóa của cổng cần URL của cổng đó. Đồng thời kiểm tra xem có khoảng trắng được dán vào hay khóa đã bị thu hồi không.

Tại sao Claude Code cứ yêu cầu tôi chạy /login?

Token OAuth bị từ chối trước khi hết hạn cục bộ hoặc việc làm mới thất bại, thường do nhiều tiến trình Claude Code dùng chung một token. Đóng các tiến trình khác, đăng xuất, xóa thông tin xác thực đã lưu, đăng nhập lại và cập nhật CLI.

403 x-deny-reason: host_not_allowed có nghĩa là gì?

Một proxy (danh sách cho phép kết nối ra ngoài của môi trường cách ly hoặc proxy doanh nghiệp) đã từ chối máy chủ đích. Thông tin xác thực của bạn vẫn hợp lệ; hãy cho phép máy chủ đó hoặc chạy bên ngoài môi trường cách ly.

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.

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_allowed

TLDR