Kết nối Cherry Studio với Claude

Cherry Studio là ứng dụng máy tính có giao diện gọn gàng để trò chuyện với nhiều mô hình và hỗ trợ trực tiếp định dạng gốc của Anthropic. Thêm gateway AI Prime Tech làm nhà cung cấp loại Anthropic sẽ đưa Claude vào cùng cửa sổ với mọi mô hình khác bạn đang dùng, chỉ với một máy chủ và một khóa.

Mở Dịch vụ mô hình

Vào Cài đặt và mở Dịch vụ mô hình. Đây là nơi Cherry Studio liệt kê mọi nhà cung cấp mà ứng dụng có thể kết nối và cũng là nơi bạn thêm nhà cung cấp mới. Nhấn dấu cộng để thêm nhà cung cấp, rồi bạn sẽ được yêu cầu chọn loại.

Việc chọn loại rất quan trọng vì nó quyết định định dạng truyền dữ liệu. Để dùng Claude qua gateway, bạn cần chọn loại Anthropic, hướng đến giao diện /v1/messages gốc thay vì endpoint kiểu OpenAI.

Vì Cherry Studio quản lý các nhà cung cấp dưới dạng danh sách, gateway nằm cạnh mọi dịch vụ khác bạn đã cấu hình và bạn chuyển đổi giữa chúng theo từng cuộc trò chuyện. Điều này khiến ứng dụng trở thành nơi thuận tiện để dùng gateway đa mô hình: một mục nhà cung cấp có thể chứa nhiều mô hình Claude để bạn chọn từ menu khi cần. Việc coi gateway là một mục trong số nhiều mục giúp Cherry Studio trở thành trung tâm điều khiển đa mô hình tiện dụng. Bạn chuyển nhà cung cấp cho từng cuộc trò chuyện mà không cần rời ứng dụng.

Chọn loại Anthropic

Chọn Anthropic làm loại nhà cung cấp và bật nhà cung cấp đó. Cherry Studio sẽ hiển thị hai trường quyết định toàn bộ cấu hình: Khóa API và Máy chủ API. Dán khóa gateway của bạn vào trường khóa.

Vì loại nhà cung cấp là Anthropic gốc, Cherry Studio sẽ gửi yêu cầu theo định dạng Messages mà gateway cung cấp cho Claude. Sau khi chọn loại, bạn không cần lo về việc chuyển đổi giao thức riêng.

Nếu gateway của bạn cũng cung cấp giao diện tương thích với OpenAI cho các mô hình khác, hãy thêm chúng dưới dạng một nhà cung cấp riêng thuộc loại OpenAI thay vì trộn vào mục này. Dành riêng mục loại Anthropic cho Claude giúp định dạng truyền dữ liệu rõ ràng và tránh nhầm lẫn giữa các giao thức. Tách các giao thức thành những mục nhà cung cấp riêng là một nguyên tắc nhỏ giúp tránh nhiều nhầm lẫn về sau. Khi đó, mỗi mục chỉ có đúng một định dạng truyền dữ liệu cần xem xét.

Đặt Máy chủ API chính xác

Máy chủ API là trường người dùng thường nhập sai nhất. Chỉ nhập địa chỉ gốc của máy chủ, không có /v1 ở cuối, vì Cherry Studio tự nối thêm đường dẫn phiên bản. Tự thêm /v1 sẽ làm đường dẫn bị lặp và khiến yêu cầu thất bại.

Vì vậy, giá trị chỉ là địa chỉ máy chủ gateway. Nếu bạn gặp lỗi 404 hoặc lỗi đường dẫn sau khi thêm nhà cung cấp, nguyên nhân gần như luôn là /v1 thừa trong trường Máy chủ API.

Dấu gạch chéo ở cuối địa chỉ máy chủ cũng gây lỗi tương tự, vì vậy hãy nhập địa chỉ máy chủ thuần túy, không thêm gì phía sau. Khi yêu cầu thất bại, cách chẩn đoán nhanh nhất là kiểm tra lại trường Máy chủ API và xóa mọi phần sau tên máy chủ trước khi tìm ở nơi khác. Khi có lỗi, kiểm tra lại trường này trước sẽ giải quyết ngay phần lớn vấn đề thiết lập. Giá trị bạn cần là địa chỉ máy chủ thuần túy, không có hậu tố.

Khóa URL bằng dấu thăng ở cuối

Cherry Studio hỗ trợ một mẹo nhỏ nhưng quan trọng: kết thúc Máy chủ API bằng dấu # để ứng dụng dùng chính xác URL đó mà không nối thêm gì. Đây là cách buộc ứng dụng dùng một endpoint chính xác khi cơ chế tự động nối thêm gây cản trở.

Với gateway tiêu chuẩn, bạn thường chỉ nhập địa chỉ máy chủ và để Cherry Studio tự nối thêm. Chỉ dùng dấu # khi gateway yêu cầu một đường dẫn chính xác mà cơ chế tự động nối thêm có thể làm sai lệch.

Dấu # đáng ghi nhớ chính vì nó không dễ nhận ra — đây là cách xử lý cho mọi gateway có đường dẫn không khớp với giả định mặc định của Cherry Studio. Nếu bạn thấy /v1/messages được tự động nối thêm không khớp với yêu cầu của gateway, dấu # cho phép bạn tự nhập đầy đủ URL. Ghi nhớ mẹo dấu # ngay từ bây giờ sẽ giúp bạn nhận ra cách khắc phục ngay khi đường dẫn không khớp. Đây là tùy chọn ghi đè có thể xử lý mọi đường dẫn gateway không theo chuẩn.

Chọn mô hình và trò chuyện

Thêm các mô hình Claude bạn muốn vào nhà cung cấp, sử dụng những ID mà gateway cung cấp, chẳng hạn claude-sonnet-4-5 cho trò chuyện hằng ngày và claude-opus-4-8 cho các tác vụ suy luận khó hơn. Sau đó, chúng sẽ xuất hiện trong menu mô hình của Cherry Studio.

Bắt đầu cuộc trò chuyện, chọn một mô hình Claude từ menu và bạn sẽ trò chuyện qua gateway. Vì nhà cung cấp dùng định dạng Anthropic gốc, các tính năng phụ thuộc vào định dạng Messages sẽ hoạt động như mong đợi.

Bạn có thể mở cùng lúc nhiều cuộc trò chuyện với các mô hình Claude khác nhau, điều này rất tiện để so sánh cách Sonnet và Opus xử lý cùng một prompt. Vì tất cả đều chạy qua cùng một nhà cung cấp gateway, việc chuyển mô hình chỉ cần chọn trong menu thay vì cấu hình lại. So sánh các mô hình cạnh nhau là một tiện ích thú vị khi chạy mọi thứ qua một nhà cung cấp duy nhất. Chỉ cần đổi lựa chọn trong menu là bạn có thể thử cùng một prompt với Sonnet và Opus.

# Cherry Studio -> Settings -> Model Services -> + Add
# Provider type: Anthropic   (native /v1/messages)
# API Key:  <your gateway key>
# API Host: https://aiprimetech.io        (root only, NO /v1 -- it auto-appends)
#   end with #  ->  https://aiprimetech.io#   to lock the exact URL
# Model: claude-sonnet-4-5

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

AI Prime Tech là một cổng API độc lập. AI Prime Tech không liên kết với, không được Anthropic chứng thực và không phải là đại lý bán lại của Anthropic. Claude và các tên mô hình liên quan là nhãn hiệu của chủ sở hữu tương ứng.