Claude app

Kết nối Claude app (Claude Desktop) với gateway bằng API key được tạo trên website.

Cài Claude app và chuẩn bị API key

Tải và cài bản Claude Desktop mới nhất từ claude.com/download.
Mở trang quản lý key của môi trường bạn sử dụng: https://api.vnaipro.app/keys.
Đăng nhập và làm theo hướng dẫn tạo API key. Kiểm tra số dư tại https://api.vnaipro.app/wallet và quota của key.
Khi tạo key, chọn group Auto hoặc group Claude có model bạn muốn dùng. Key group Auto có thể dùng chung với Codex và các client khác. Nếu có giới hạn model cho key, cho phép các model Claude bạn muốn dùng.
Sao chép API key để điền vào app ở bước cấu hình.

API key phải có quyền dùng model Claude

Key thuộc group không có model Claude sẽ không dùng được cho cấu hình này. Hãy kiểm tra group và danh sách model trên website trước khi tiếp tục.

Bật Developer Mode

Mở Claude app. Nếu đang ở màn hình đăng nhập, bạn có thể cấu hình third-party ngay tại đây.
Mở menu ứng dụng:
- macOS: dùng thanh menu ở phía trên màn hình.
- Windows: bấm menu ☰ ở góc trên bên trái ứng dụng.
Chọn Help → Troubleshooting → Enable Developer Mode.
Chờ app khởi động lại; menu Developer sẽ xuất hiện.

Mở cấu hình third-party

Trên menu ứng dụng, chọn Developer → Configure Third-Party Inference….
Trong cửa sổ cấu hình, tìm phần Connection.
Chọn Inference provider là Gateway, rồi điền các trường bên dưới.

Điền cấu hình bắt buộc

Trường	Giá trị cần dùng
Inference provider	`gateway` (Gateway)
Gateway base URL	`https://api.vnaipro.app` — URL gateway của môi trường đang sử dụng
Gateway API key	API key đã tạo trên website, thuộc group Auto hoặc group Claude có quyền dùng model Claude
Credential kind	`Static API key`
Gateway auth scheme	`bearer`

Gateway base URL của môi trường này: https://api.vnaipro.app. Hãy sao chép URL hiển thị trong bảng cho môi trường của bạn, không thêm /v1, /messages hoặc đường dẫn của trang docs vào cuối URL.

Ở Gateway API key, chỉ dán nguyên API key, không thêm tiền tố Bearer . App sẽ dùng Gateway auth scheme: bearer để gửi key theo đúng cơ chế xác thực.

Lưu và kiểm tra kết nối

Bấm Apply Changes, sau đó bấm Save & Restart.
Khi app mở lại, chọn tùy chọn bắt đầu bằng cấu hình third-party trên màn hình đăng nhập.
Tạo cuộc trò chuyện mới và chọn một model Claude mà group của key cho phép.
Gửi một câu hỏi ngắn, ví dụ: “Xin chào, hãy trả lời bằng tiếng Việt.”
Khi nhận được phản hồi, mở lịch sử sử dụng trên website để kiểm tra request đã đi qua gateway.

Lỗi thường gặp

Hiện tượng	Cách xử lý
Không thấy menu Developer	Kiểm tra đã bật Help → Troubleshooting → Enable Developer Mode và khởi động lại app; cập nhật Claude Desktop nếu thiếu tùy chọn này.
Cửa sổ cấu hình chỉ cho đọc	Thiết bị đang nhận cấu hình do tổ chức quản lý. Liên hệ quản trị viên để đổi gateway.
Lỗi `401` hoặc `403`	Kiểm tra key còn hiệu lực, đúng môi trường, thuộc group có model Claude; dùng Static API key và bearer, không thêm `Bearer` vào ô key.
Không thấy hoặc không dùng được model Claude	Kiểm tra group đã chọn khi tạo key và giới hạn model của key trên website.
`Gateway was unreachable`	Kiểm tra Gateway base URL, kết nối mạng và trạng thái gateway; dùng URL gốc đúng môi trường.

Tham khảo hướng dẫn cài đặt của Anthropic và cấu hình LLM gateway.