Cherry Studio를 Claude에 연결하기

Cherry Studio는 여러 모델과 대화할 수 있는 깔끔한 데스크톱 클라이언트로, 네이티브 Anthropic 형식을 직접 지원합니다. AI Prime Tech 게이트웨이를 Anthropic 유형의 공급자로 추가하면 하나의 호스트와 하나의 키로, 사용하는 다른 모든 모델과 같은 창에서 Claude를 이용할 수 있습니다.

모델 서비스 열기

설정으로 이동해 모델 서비스를 여세요. Cherry Studio가 연결할 수 있는 모든 공급자를 나열하고 새 공급자를 추가하는 곳입니다. 더하기 버튼을 눌러 공급자를 추가하면 유형을 선택하라는 메시지가 표시됩니다.

유형 선택은 통신 형식을 결정하므로 중요합니다. 게이트웨이에서 Claude를 사용하려면 Anthropic 유형을 선택해야 합니다. 이 유형은 OpenAI 방식의 엔드포인트가 아니라 네이티브 /v1/messages 인터페이스를 사용합니다.

Cherry Studio는 공급자를 목록으로 관리하므로 게이트웨이는 이미 설정한 다른 서비스와 나란히 표시되며, 대화마다 공급자를 전환할 수 있습니다. 따라서 멀티 모델 게이트웨이를 편리하게 사용할 수 있습니다. 하나의 공급자 항목에 여러 Claude 모델을 등록하고 필요에 따라 메뉴에서 선택할 수 있습니다. 게이트웨이를 여러 공급자 중 하나로 다루는 방식 덕분에 Cherry Studio는 편리한 멀티 모델 제어 환경이 됩니다. 앱을 벗어나지 않고 대화마다 공급자를 전환할 수 있습니다.

Anthropic 유형 선택

공급자 유형으로 Anthropic을 선택하고 활성화하세요. 그러면 Cherry Studio에 모든 것을 결정하는 두 필드, API 키와 API 호스트가 표시됩니다. 키 필드에 게이트웨이 키를 붙여 넣으세요.

네이티브 Anthropic 유형이므로 Cherry Studio는 게이트웨이가 Claude용으로 제공하는 Messages 형식으로 요청을 보냅니다. 유형을 설정한 뒤에는 별도의 프로토콜 전환 옵션을 신경 쓸 필요가 없습니다.

게이트웨이가 다른 모델용 OpenAI 호환 인터페이스도 제공한다면, 해당 모델을 이 공급자에 섞지 말고 OpenAI 유형의 별도 공급자로 추가하세요. Anthropic 유형의 항목을 Claude 전용으로 유지하면 통신 형식이 명확해지고 프로토콜 간 혼동을 피할 수 있습니다. 프로토콜마다 공급자 항목을 분리하는 작은 습관이 나중에 많은 혼동을 방지합니다. 그러면 각 항목에서 고려해야 할 통신 형식은 정확히 하나가 됩니다.

API 호스트를 올바르게 설정하기

API 호스트는 가장 자주 잘못 설정하는 필드입니다. Cherry Studio가 버전 경로를 직접 추가하므로 끝에 /v1을 붙이지 말고 호스트 루트만 입력하세요. /v1을 직접 추가하면 경로가 중복되어 요청이 실패합니다.

따라서 값에는 게이트웨이 호스트만 들어가야 합니다. 공급자를 추가한 뒤 404 오류나 경로 오류가 발생했다면, API 호스트에 불필요한 /v1이 들어간 것이 거의 항상 원인입니다.

호스트 끝의 슬래시도 같은 유형의 문제를 일으키므로 뒤에 아무것도 붙이지 않은 호스트만 입력하세요. 요청이 실패하면 다른 곳을 확인하기 전에 API 호스트 필드를 다시 살펴보고 호스트 이름 뒤의 모든 내용을 제거하는 것이 가장 빠른 진단 방법입니다. 문제가 발생했을 때 이 필드부터 다시 확인하면 대부분의 설정 문제를 즉시 해결할 수 있습니다. 접미사 없는 호스트만 입력하는 것이 목표입니다.

끝의 해시 기호로 URL 고정하기

Cherry Studio는 작지만 중요한 기능을 지원합니다. API 호스트 끝에 #을 붙이면 클라이언트가 아무것도 추가하지 않고 해당 URL을 그대로 사용합니다. 자동 추가 기능이 방해가 될 때 정확한 엔드포인트를 강제로 지정하는 방법입니다.

일반적인 게이트웨이에서는 보통 호스트만 입력하고 Cherry Studio가 경로를 추가하도록 두면 됩니다. 자동 추가로 경로가 잘못될 수 있어 게이트웨이에 정확한 경로를 지정해야 할 때만 #을 사용하세요.

#은 쉽게 알아차리기 어려운 기능이기 때문에 기억해 둘 가치가 있습니다. 경로가 Cherry Studio의 기본 가정과 맞지 않는 게이트웨이를 위한 우회 수단입니다. 자동으로 추가되는 /v1/messages가 게이트웨이에서 요구하는 경로와 맞지 않는다면, #을 사용해 전체 URL을 직접 지정할 수 있습니다. 지금 이 # 사용법을 기억해 두면 나중에 경로가 맞지 않을 때 해결 방법을 바로 알아볼 수 있습니다. 비표준 게이트웨이 경로를 모두 처리할 수 있는 재정의 방법입니다.

모델을 선택하고 대화하기

게이트웨이가 제공하는 ID를 사용해 원하는 Claude 모델을 공급자 아래에 추가하세요. 예를 들어 일상적인 대화에는 claude-sonnet-4-5, 더 어려운 추론에는 claude-opus-4-8을 사용할 수 있습니다. 그러면 Cherry Studio의 모델 메뉴에 표시됩니다.

대화를 시작하고 메뉴에서 Claude 모델을 선택하면 게이트웨이와 대화하게 됩니다. 공급자가 네이티브 Anthropic 유형이므로 Messages 형식에 의존하는 기능이 예상대로 작동합니다.

서로 다른 Claude 모델로 여러 대화를 동시에 열어 둘 수 있어, Sonnet과 Opus가 같은 프롬프트를 어떻게 처리하는지 비교하기에 편리합니다. 모든 모델이 하나의 게이트웨이 공급자를 통해 실행되므로, 모델 전환은 설정을 다시 하는 작업이 아니라 메뉴에서 선택하는 작업입니다. 모델을 나란히 비교하는 것은 모든 것을 단일 공급자를 통해 실행할 때 누릴 수 있는 소소한 즐거움 중 하나입니다. 메뉴를 한 번 전환하면 같은 프롬프트를 Sonnet과 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

자주 묻는 질문

AI Prime Tech는 독립적인 API 게이트웨이입니다. Anthropic과 제휴 관계가 없으며, Anthropic의 보증을 받거나 Anthropic의 리셀러로 활동하지 않습니다. Claude 및 관련 모델 이름은 각 소유자의 상표입니다.