Chuyển đến nội dung chính
Sử dụng hướng dẫn này để kết nối Claude Desktop Cowork trên third-party inference với CometAPI. Cấu hình này cho phép Claude Desktop gửi các yêu cầu Claude Messages API tới CometAPI từ Cowork, Projects và các quy trình làm việc desktop được hỗ trợ. Tài liệu tham khảo chính thức:
Third-party inference của Claude Desktop yêu cầu một Anthropic-compatible gateway. CometAPI hỗ trợ các model Claude thông qua Anthropic Messages API.
Nội dung bạn gửi từ Claude Desktop sẽ được CometAPI và nhà cung cấp model đã chọn xử lý. Không gửi dữ liệu mật trừ khi tổ chức của bạn cho phép quy trình làm việc đó.

​
Điều kiện tiên quyết

  • Claude Desktop được cài đặt từ claude.com/download
  • Một bản dựng Claude Desktop có bao gồm Developer mode và Configure third-party inference
  • Một tài khoản CometAPI với API key đang hoạt động
  • Quyền truy cập vào các model Claude trong CometAPI
  • Một đường mạng có thể truy cập https://api.cometapi.com
Bắt đầu từ màn hình đăng nhập Claude Desktop. Nếu bạn đã đăng nhập bằng tài khoản Anthropic, hãy đăng xuất trước khi cấu hình third-party inference.

​
Cấu hình

1

Bật developer mode

Mở Claude Desktop và giữ nguyên ở màn hình đăng nhập. Trong menu ứng dụng, mở Help → Troubleshooting, sau đó chọn Enable Developer Mode.Trên Windows, menu có thể khó truy cập trước khi đăng nhập. Đặt tiêu điểm vào trường email, nhấn Tab cho đến khi menu được chọn, rồi nhấn Enter.
2

Mở cài đặt third-party inference

Sau khi developer mode được bật, mở Developer → Configure third-party inference.Cửa sổ cấu hình sẽ mở ra với nhiều phần ở thanh bên trái. Sử dụng phần Connection cho các cài đặt CometAPI.
3

Cấu hình gateway

Trong phần Connection, nhập các giá trị CometAPI bên dưới:
FieldValue
Nhà cung cấp InferenceGateway
GatewayAnthropic-compatible
URL cơ sở của gatewayhttps://api.cometapi.com
API key của gatewayAPI key CometAPI của bạn, ví dụ như <COMETAPI_KEY>
Auth scheme của gatewayBearer
Header bổ sung của gatewayĐể trống
Giữ nguyên base URL chính xác như hiển thị. Claude Desktop yêu cầu một base URL HTTPS.Ảnh chụp màn hình sau cho thấy phần Connection đã được điền các giá trị CometAPI.Cài đặt Connection của Claude Desktop với gateway base URL của CometAPI, trường API key và bearer auth scheme đã được điền
4

Thêm model ID

Trong Model list, thêm thủ công các model ID sau:
Model IDMục đích sử dụng đề xuất
claude-opus-4-7Lập kế hoạch phức tạp và tác vụ agent
claude-sonnet-4-6Sử dụng desktop nói chung
claude-haiku-4-5-20251001Prompt nhẹ và bản nháp nhanh
Model đầu tiên trong danh sách sẽ trở thành model mặc định. Đặt claude-sonnet-4-6 lên đầu nếu bạn muốn một model mặc định dùng cho mục đích chung.
Khả năng khả dụng của model có thể thay đổi. Nếu một model không xuất hiện trong Claude Desktop sau khi cấu hình, hãy xác minh quyền truy cập trên trang Models của CometAPI.
Ảnh chụp màn hình sau cho thấy danh sách model với ba model ID Claude đã được cấu hình cho CometAPI.Danh sách model của Claude Desktop hiển thị claude-opus-4-7, claude-sonnet-4-6 và claude-haiku-4-5-20251001 cho CometAPI
5

Áp dụng cấu hình cục bộ

Nhấp vào Apply locally. Claude Desktop sẽ ghi cấu hình đã chọn vào hồ sơ người dùng cục bộ và khởi động lại ứng dụng.Nếu ứng dụng không khởi động lại, hãy thoát hẳn Claude Desktop rồi mở lại.
6

Bắt đầu một phiên Cowork

Trên màn hình đăng nhập, chọn tùy chọn Cowork trên third-party inference. Mở Cowork hoặc Projects, chọn một trong các model Claude đã cấu hình, rồi gửi một prompt kiểm tra ngắn.Phản hồi thành công xác nhận rằng Claude Desktop đang sử dụng CometAPI cho các lệnh gọi model.

​
Xác minh cấu hình

Sử dụng một prompt ngắn không yêu cầu công cụ bên ngoài: 
Reply with one sentence: Claude Desktop is connected through CometAPI.
Nếu Claude Desktop trả về phản hồi, thì base URL, API key và danh sách model đã được cấu hình chính xác. Ảnh chụp màn hình sau cho thấy một phản hồi Cowork thành công thông qua CometAPI. Phản hồi Cowork của Claude Desktop sử dụng CometAPI sau khi thiết lập third-party inference Để kiểm tra các cài đặt đã được phát hiện, mở Help → Troubleshooting → Copy Managed Configuration Report. Các giá trị bí mật sẽ được che trong báo cáo đã sao chép.

​
Khắc phục sự cố

Kiểm tra các mục sau:
  • Inference provider được đặt thành Gateway.
  • Gateway base URL là https://api.cometapi.com.
  • Gateway API key chứa API key CometAPI của bạn và không có khoảng trắng thừa.
  • Bạn đã nhấp Apply locally và đã khởi động lại hoàn toàn Claude Desktop.
Xác nhận rằng base URL bắt đầu bằng https://. Claude Desktop không chấp nhận URL gateway HTTP thuần.Đồng thời xác nhận rằng tài khoản CometAPI của bạn có quyền truy cập vào các model Claude và API key chưa bị xóa hoặc vô hiệu hóa.
Mở lại Developer → Configure third-party inference và kiểm tra các mục trong Model list. Model ID phải khớp với các ID mà CometAPI cung cấp.Thêm từng model ID dưới dạng một mục riêng biệt. Không đưa dấu ngoặc kép, dấu phẩy hoặc khoảng trắng thừa vào các trường UI.
Third-party inference của Claude Desktop yêu cầu một Anthropic-compatible gateway cho luồng này. Sử dụng https://api.cometapi.com và các model ID Claude được liệt kê ở trên.
Tab Code sử dụng engine Claude Code bên trong Claude Desktop. Một số cài đặt desktop có thể không áp dụng cho các phiên Code theo cùng cách mà chúng áp dụng cho Cowork.Đối với việc sử dụng terminal độc lập, xem hướng dẫn tích hợp Claude Code.