Home → Guides → Trỏ Claude Desktop và Codex sang APICLAN

Trỏ Claude Desktop và Codex sang APICLAN

Q: Địa chỉ cần điền và quy tắc /v1

Mọi yêu cầu đều phải đến một đường dẫn bắt đầu bằng /v1. Còn việc bạn có phải tự gõ /v1 vào ứng dụng hay không thì tùy ứng dụng: có cái tự thêm, có cái không. Chỉ một chi tiết này thôi đã chiếm phần lớn các báo cáo «không kết nối được». Điền ngược lại, yêu cầu sẽ bị 404 ngay ở lớp biên, nghĩa là nó chưa bao giờ tới cổng và cũng không hề xuất hiện trong nhật ký sử dụng — nên nhật ký trống chính là triệu chứng. Đừng bao giờ để dấu gạch chéo ở cuối địa chỉ.

Ứng dụng máy tính không có ô nhập base URL trong phần cài đặt của chính nó. CC Switch sẽ ghi cấu hình đó thay bạn. Dưới đây là đúng những gì cần điền, và hai điều giải thích gần như mọi lần cài đặt thất bại.

Trước khi bắt đầu

Bạn cần một tài khoản có số dư và một API key. Tạo key trong bảng điều khiển, mục «API key»: chọn dòng nhà cung cấp bạn sẽ gọi — Anthropic cho Claude Desktop, OpenAI cho Codex — rồi chọn nhóm key sẽ trừ tiền. Nhóm quyết định đơn giá của bạn; giá từng mô hình có trên trang giá.

Một key chỉ thuộc đúng một nhóm. Key tạo cho mô hình văn bản không gọi được mô hình ảnh và ngược lại; lỗi trả về là 404 trên mô hình chứ không phải lỗi quyền. Cần cả hai thì tạo hai key. Một key cụ thể gọi được những gì, câu trả lời luôn là kết quả của GET /v1/models gửi kèm chính key đó.

Địa chỉ cần điền và quy tắc /v1

Mọi yêu cầu đều phải đến một đường dẫn bắt đầu bằng /v1. Còn việc bạn có phải tự gõ /v1 vào ứng dụng hay không thì tùy ứng dụng: có cái tự thêm, có cái không. Chỉ một chi tiết này thôi đã chiếm phần lớn các báo cáo «không kết nối được».

Ứng dụng	Địa chỉ yêu cầu cần điền
Claude Desktop (via CC Switch)	`https://apiclan.us/v1`
Codex / ChatGPT desktop app	`https://apiclan.us/v1`
OpenAI SDK, Cherry Studio, Chatbox, LobeChat, LM Studio	`https://apiclan.us/v1`
Cursor, Cline, Roo Code	`https://apiclan.us/v1`
Claude Code	`https://apiclan.us`
Anthropic SDK	`https://apiclan.us`

Điền ngược lại, yêu cầu sẽ bị 404 ngay ở lớp biên, nghĩa là nó chưa bao giờ tới cổng và cũng không hề xuất hiện trong nhật ký sử dụng — nên nhật ký trống chính là triệu chứng. Đừng bao giờ để dấu gạch chéo ở cuối địa chỉ.

Codex nay nằm trong ứng dụng ChatGPT trên máy tính

Codex đã được gộp vào ứng dụng ChatGPT cho máy tính. Trên Windows, cài ChatGPT từ Microsoft Store; trên macOS, tải từ trang của OpenAI. Codex bản dòng lệnh dùng cùng các thiết lập này.

Trong CC Switch, thêm một nhà cung cấp cho Codex, dán key của bạn vào và điền https://apiclan.us/v1 làm địa chỉ yêu cầu. Bật nhà cung cấp đó lên, rồi thoát Codex hoàn toàn — đóng cửa sổ là chưa đủ — và mở lại. Cấu hình chỉ được đọc lúc khởi động, nên tiến trình đang chạy vẫn dùng thiết lập cũ và trông như chẳng có gì thay đổi.

Nếu bạn muốn tự sửa tệp cấu hình thay vì dùng CC Switch, base URL và chỗ đặt key nằm trong hướng dẫn nhanh của chúng tôi.

Ứng dụng Claude Desktop

Cài Claude Desktop từ claude.com, rồi thiết lập nhà cung cấp trong CC Switch:

Mở CC Switch, chọn đích là Claude Desktop và thêm một nhà cung cấp mới.
Đặt tên tùy ý, dán key APICLAN của bạn vào ô API Key.
Điền https://apiclan.us/v1 làm địa chỉ yêu cầu — ứng dụng sẽ tự thêm /messages vào sau. Không có dấu gạch chéo cuối.
Lưu lại, khởi động Claude Desktop và chọn một mô hình.

Nếu CC Switch cho bạn chọn giữa kết nối trực tiếp và ánh xạ mô hình, hãy đọc phần tiếp theo trước khi quyết định. Chính thiết lập đó quyết định trình chọn mô hình có chạy được hay không.

Khi trình chọn mô hình báo lỗi cổng

Thông báo kiểu «kết nối vẫn tốt nhưng nhà cung cấp từ chối yêu cầu» gần như luôn là chuyện tên mô hình, không phải key. Ứng dụng máy tính gửi đi bộ định danh mô hình có sẵn của nó, trong khi một cổng chỉ phục vụ được những mô hình mà tài khoản thượng nguồn thực sự cung cấp.

Cách xử lý là dùng ánh xạ mô hình thay vì kết nối trực tiếp: ánh xạ các mục trong ứng dụng sang những tên mà cổng này phục vụ. Kết nối trực tiếp chỉ chạy khi nhà cung cấp chấp nhận đúng các định danh mà ứng dụng gửi đi.

Gửi GET /v1/models kèm key của bạn để lấy danh sách dùng cho việc ánh xạ. Danh sách đó được dựng từ chính nhóm của key bạn, nên nó là câu trả lời thật cho tài khoản của bạn chứ không phải một danh mục chung chung.

Quay lại tài khoản chính thức

Không có gì bị ghi đè vĩnh viễn. Trong CC Switch, bật lại nhà cung cấp chính thức và khởi động lại ứng dụng; nó sẽ quay về gói thuê bao của bạn. Bạn có thể giữ cả hai cấu hình và chuyển qua lại bất cứ lúc nào — số dư ở đây là trả trước và không hết hạn, nên một cấu hình để không cũng chẳng tốn gì.

Nếu vẫn chưa chạy

Bị 404 và nhật ký sử dụng trống trơn: địa chỉ sai. Xem lại bảng phía trên để biết ứng dụng đó có cần /v1 không, và bỏ dấu gạch chéo ở cuối.
Bị 401: key chưa thực sự đi kèm yêu cầu. Dán lại lần nữa; nó là một chuỗi dài, và bản sao thiếu một đoạn sẽ hỏng y hệt như key sai.
Cùng một key, các mô hình khác chạy được mà một mô hình thì không: mô hình đó nằm ở nhóm khác. Hãy tạo key thứ hai và chọn đúng nhóm; sửa quyền không giải quyết được.

Vẫn tắc? Gửi email tới support@apiclan.us kèm tên mô hình bị lỗi và khoảng thời gian bạn thử. Có người thật đọc.

Start using it

No subscription, no monthly minimum, no sales call. Top up with USDT and spend what you use — 1 USDT gives you 2 credits of API balance.

Read the 30-second quickstart

Prices quoted on this page are regenerated automatically from live billing data. Third-party terms are quoted from that party's own published documentation.