---
title: "Cherry Studio 연결"
description: "Cherry Studio에 1折AI를 사용자 지정 서비스 제공자로 추가하고, Anthropic 또는 OpenAI 엔드포인트를 선택한 후 루트 주소, API 키, 모델을 입력합니다."
headingIds: {"원클릭 가져오기":"section-1","구성":"section-2","Anthropic 엔드포인트와 OpenAI 엔드포인트 중 선택":"section-3","자주 묻는 질문":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

[1ZheAI](https://1zheai.com/en/editorial/#publisher)가 관리하는 문서입니다. [출처 및 수정 사항](https://1zheai.com/en/editorial/).

오류를 발견하셨나요? 페이지 주소와 설명을 첨부하여 [고객 지원](mailto:support@1zheai.com)으로 문의해 주세요. API 키나 계정 정보는 보내지 마세요.

</aside>
Cherry Studio는 데스크톱용 AI 대화 클라이언트로, 1折AI를 사용자 지정 서비스 제공자로 추가할 수 있습니다.

## 원클릭 가져오기

콘솔의 **API 키 → 사용 도구 → Cherry Studio**에서 Anthropic 또는 OpenAI 프로토콜을 선택하고 **Cherry Studio 열기**를 클릭합니다. 앱 내에서 가져오기를 확인한 후 모델을 가져오고 서비스 제공자를 활성화하고 테스트합니다. 동일한 이름의 구성이 이미 있는 경우 덮어쓰기 경고를 확인합니다. 가져오기 링크에는 전체 키가 포함되어 있으므로 전달하지 마세요.

브라우저는 앱이 설치되어 있는지 확인할 수 없습니다. 호출되지 않으면 먼저 클라이언트를 설치하고 한 번 실행하거나 아래의 수동 단계를 사용하세요. 프로토콜 형식은 공식 구현을 확인했지만 실제 추론은 실제 버전과 모델에 따라 검증해야 합니다.

## 구성

<Steps>
<Step title="서비스 제공자 추가">

설정(톱니바퀴 아이콘) → **모델 서비스** → 목록 하단의 **+ 서비스 제공자 추가**.

</Step>
<Step title="정보 입력">

| 필드 | 입력 내용 |
|---|---|
| 제공자 이름 | `1折AI` |
| API 키 | `sk-你的Key` |
| 엔드포인트 | **Anthropic**(권장) 또는 **OpenAI** 선택 |
| API 주소 | `https://1zheai.com` |

API 주소에는 루트 주소만 입력하세요. Cherry Studio는 선택한 프로토콜에 따라 `/v1/...`을 자동으로 추가합니다. `/v1/messages`, `/v1/chat/completions` 같은 전체 경로를 붙여넣지 마세요. 끝에 `#`을 추가하지 마세요(`#`로 끝나면 경로가 자동으로 추가되지 않습니다).

</Step>
<Step title="모델 추가">

**모델 목록 가져오기**를 클릭하고 반환된 목록에서 사용할 모델을 추가하거나, **+**를 클릭하여 모델 ID를 직접 입력하세요(예: `claude-sonnet-5-5`). 목록에 추가된 모델만 대화의 모델 선택에 표시됩니다.

</Step>
<Step title="활성화 및 테스트">

서비스 제공자 페이지 오른쪽 상단의 활성화 토글을 켜고, 대화 화면으로 돌아가 1折AI 아래의 모델로 메시지를 보내세요.

</Step>
</Steps>

## Anthropic 엔드포인트와 OpenAI 엔드포인트 중 선택

| 엔드포인트 | 적합한 경우 |
|---|---|
| Anthropic | extended thinking 등 Claude의 네이티브 기능을 사용하고 싶을 때; Agent의 프로토콜 제한은 현재 버전을 기준으로 합니다 |
| OpenAI | OpenAI 형식에 익숙하거나 다른 OpenAI 호환 서비스와 통합 관리하고 싶을 때 |

두 엔드포인트는 동일한 API 키(API key)와 동일한 모델 ID 세트를 사용합니다.

## 자주 묻는 질문

<AccordionGroup>
<Accordion title="모델 목록을 가져오지 못함?">

먼저 API 키에 불필요한 공백이 없는지 확인하세요. 그다음 API 주소가 `https://1zheai.com`인지, 경로가 과도하게 입력되지 않았는지 확인하세요. 가져오지 못해도 사용에는 영향이 없으며, 모델 ID를 직접 입력해도 사용할 수 있습니다.

</Accordion>
<Accordion title="대화에서 404 오류?">

API 주소에 전체 경로를 입력했거나 끝에 `#`을 추가한 경우입니다. 루트 주소 `https://1zheai.com`로 되돌리세요.

</Accordion>
</AccordionGroup>