Cherry Studio

300개 이상의 모델과 서비스를 지원하는 올인원 AI 데스크톱 클라이언트

소개

Cherry Studio는 Windows, macOS, Linux를 지원하는 무료 오픈소스(AGPL-3.0) AI 데스크톱 클라이언트입니다. OpenAI 호환 API와 Anthropic 네이티브 API를 모두 지원하여 TokenMix와 완벽하게 연동됩니다. 몇 분 안에 설정을 완료하고 Claude, GPT, DeepSeek 등의 모델을 하나의 인터페이스에서 이용할 수 있습니다.

사전 준비

• GitHub Releases에서 Cherry Studio를 다운로드하여 설치하세요. (Windows .exe, macOS .dmg, Linux .AppImage)
• tokenmix.ai에서 계정을 생성하고 콘솔 → API Keys에서 sk-tm-으로 시작하는 API 키를 발급받으세요.

설정 단계

방법 A — OpenAI 호환 인터페이스 (권장, 전체 모델 지원)

1. Cherry Studio를 열고 왼쪽 사이드바의 설정 아이콘(⚙️)을 클릭하세요.
2. 모델 서비스로 이동합니다.
3. 서비스 추가 → 서비스 유형에서 OpenAI를 선택합니다.
4. 다음 정보를 입력합니다:
   • 이름: TokenMix
   • API 키: sk-tm-xxx 키 붙여넣기
   • API 주소: https://api.tokenmix.ai/v1
5. 카드 우측 상단의 스위치를 ON으로 설정합니다.
6. 모델 관리 → 모델 추가에서 claude-sonnet-4.6 등의 모델 ID를 입력합니다.

방법 B — Anthropic 네이티브 API

1. 위의 1~2 단계를 반복합니다.
2. 서비스 추가 → 서비스 유형에서 Anthropic을 선택합니다.
3. 다음을 입력합니다:
   • API 키: sk-tm-xxx
   • API 주소: https://api.tokenmix.ai/v1
4. claude-sonnet-4.6, claude-opus-4.8 등의 모델을 추가합니다.

확인

새 채팅 창에서 테스트 메시지를 전송하세요. 몇 초 안에 모델 응답이 오면 성공입니다. API 키 옆의 연결 확인(🔗)이 초록색이 되면 설정이 완료된 것입니다.

자주 묻는 질문

Q: 연결 확인에서 오류가 발생합니다. A: API 주소가 /v1로 끝나는지 확인하세요(이후 슬래시 없음). 콘솔에서 복사한 키에 불필요한 공백이 포함되지 않았는지도 확인하세요.

Q: 모델 목록이 비어 있습니다. A: 모델 관리에서 모델 ID를 직접 추가해야 합니다. TokenMix 모델 페이지에 표시된 정확한 short_id(예: claude-sonnet-4.6, gpt-5.4)를 사용하세요.

Q: 여러 서비스 제공자를 동시에 사용할 수 있나요? A: 네. Cherry Studio는 여러 서비스 제공자를 추가할 수 있으며 대화마다 전환할 수 있습니다. TokenMix와 다른 서비스는 독립적으로 공존합니다.