Cherry Studio × AI Code With
Cherry Studio 서드파티 API / 릴레이 설정 튜토리얼
Cherry Studio 데스크톱 클라이언트에서 AI Code With OpenAI 호환 API를 사용하세요. 사용자 지정 제공자를 추가하고 API 키와 API 주소를 입력하면 DeepSeek, Gemini, GLM, Kimi, Grok 등 더 많은 모델을 Cherry Studio에서 바로 사용할 수 있습니다. 이 페이지에서는 설정 단계, 일반적인 오류, FAQ를 다룹니다.
Cherry Studio를 먼저 다운로드하고 설치한 다음, 설정에서 AI Code With 사용자 지정 제공자를 추가하세요. API 키는 Cherry Studio에만 입력하며, 이 페이지에서는 절대 입력하지 않습니다.
- Provider Name
- AI Code With
- API Address
- https://api.aicodewith.ai/v1
- API Key
- sk-xxxxxxxx
- Model
- deepseek-flash
빠른 설정
나중에 사용할 터미널을 위해 이 키를 저장하세요
이 도구는 키를 자체 설정에 저장합니다. 로그인한 후 키를 복사하여 아래 단계의 API 키 필드에 붙여넣으세요.
sk-***로그아웃한 방문자에게는 자리 표시자만 표시됩니다. 로그인하면 키를 채워 드립니다. Sign in · 콘솔에서 키 받기
복사는 명령을 클립보드에 넣을 뿐입니다. 아직 터미널에서 실행하거나 도구 설정에 키를 붙여넣어야 합니다. API 키 받는 방법
아래 3단계에 따라 설치하고, 사용자 지정 공급자를 추가하고, 테스트 메시지를 보내세요 — 약 3분.
Cherry Studio는 사용자 지정 공급자를 지원하는 데스크톱 AI 클라이언트입니다. 아래 3단계에서 필드를 채우고, 값을 복사하고, 확인하세요.
Cherry Studio 다운로드 및 설치
공식 페이지에서 사용 중인 플랫폼(Windows, macOS 또는 Linux)용 설치 프로그램을 다운로드하여 설치합니다. Cherry Studio를 실행하고 첫 실행 설정을 완료하세요.
AI Code With를 사용자 지정 공급자로 추가
Settings를 열고 Model Services로 이동합니다. 공급자 목록에서 New API를 선택하거나 하단의 Add provider를 클릭한 다음 토글을 활성화합니다. AI Code With API 키를 붙여넣고(키는 사용자 컴퓨터에 남아 있습니다) API 주소를 https://api.aicodewith.ai/v1로 설정합니다. 먼저 Check를 클릭해 연결을 확인할 수 있습니다.
In Settings → Model Services, select New API, enter your API key and the API address https://api.aicodewith.ai/v1. Enable the toggle, then use Check and Sync models. 모델 추가 및 확인
Sync models를 클릭해 사용 가능한 모델을 가져오거나 +를 클릭하고 Model ID를 입력합니다. 그런 다음 새 대화를 시작하고 해당 모델을 선택한 뒤 테스트 메시지를 보냅니다. 선택한 모델에서 정상적인 답변이 오면 설정이 작동하는 것입니다 — AI Code With 사용 기록에서 시간과 모델로 호출을 대조하세요. 내장 Feedback 어시스턴트의 답변을 성공적인 연결로 간주하지 마세요.
권장 모델
제공자를 추가한 후 모델 동기화를 클릭하여 모델을 자동으로 가져오거나, +를 클릭하고 다음 모델 ID 중 하나를 입력하세요(권장 모델은 기본적으로 선택되어 있으며 바로 복사할 수 있습니다):
1개 선택됨
Claude
GPT
Gemini
DeepSeek
GLM
Kimi
Grok
전체 모델 목록은 AI Code With 문서와 가격 페이지를 따릅니다. 이 사이트는 별도의 모델 목록을 유지하지 않습니다.
After Sync models, add the models you need. The full list follows what this account can see. Then start a new chat, pick that model, send a test message, and match the call in AI Code With usage records.
작동 방식
Cherry Studio는 사용자 지정 제공자를 로컬 설정에 저장합니다. 메시지를 보내면 요청이 OpenAI 호환 엔드포인트를 통해 AI Code With로 전달된 다음 선택한 모델로 전달됩니다. 제공자 이름, API 키, API 주소는 위의 빠른 설정에 입력합니다. 이 섹션은 경로만 설명합니다.
- 데스크톱 클라이언트
- Cherry Studio가 채팅 UI, 모델 선택기, 로컬 설정을 관리합니다. 플러그인이나 구성 파일은 필요하지 않습니다.
- 사용자 지정 제공자
- Cherry Studio가 모델 공급업체 대신 AI Code With를 가리키도록 하는 하나의 OpenAI 호환 제공자 항목입니다.
- 요청 경로
- Cherry Studio → 사용자 지정 제공자 → API 주소 → 모델. 모델을 변경해도 저장된 API 주소는 다시 작성되지 않습니다.
필드, 복사 작업, 확인은 빠른 설정에 있습니다. 이 섹션은 요청이 모델에 도달하는 방법만 설명합니다.
자주 묻는 질문
Cherry Studio에서 AI Code With를 사용하려면 어떤 플러그인이 필요한가요?
없습니다. Cherry Studio는 데스크톱 클라이언트입니다. 설정 → 모델 서비스에서 New API를 선택한 다음 API 주소 https://api.aicodewith.ai/v1와 AI Code With API 키를 입력하세요.
API 주소에는 무엇을 입력해야 하나요?
https://api.aicodewith.ai/v1을 입력하세요. 설정 → 모델 서비스에서 New API를 선택하고 해당 주소를 API 주소 필드에 넣으세요. /v1 접미사를 유지하고 /v1/models 같은 추가 경로를 덧붙이지 마세요.
모델 목록을 가져올 수 없으면 어떻게 하나요?
모델 동기화가 아무것도 반환하지 않으면 +를 클릭하고 Model ID를 수동으로 입력하세요(예: deepseek-flash). 저장하면 채팅 보기에서 모델을 선택할 수 있습니다.
API 키는 어디서 얻나요?
AI Code With 대시보드의 키 관리에서 API 키를 생성하세요. 키는 한 번만 표시되므로 잘 저장한 다음 Cherry Studio 제공자 설정에 붙여넣으세요.
설정이 작동하는지 어떻게 확인하나요?
제공자 토글을 활성화하고, 새 대화를 시작하고, 방금 추가한 모델을 선택한 다음 메시지를 보내세요. 해당 모델의 답변만 성공으로 간주하세요. 내장된 피드백 도우미를 성공적인 연결로 간주하지 마세요. 그런 다음 AI Code With 사용 기록에서 시간과 모델로 호출을 일치시키세요.
Cherry Studio가 설치되어 있지 않나요?
Cherry Studio 웹사이트에서 Windows, macOS 또는 Linux 빌드를 다운로드하여 설치하세요.
Cherry Studio 다운로드
다운로드 페이지를 방문하여 플랫폼에 맞는 설치 프로그램을 선택하세요. 지원 플랫폼: Windows, macOS(Intel 및 Apple Silicon), Linux(x86_64 및 ARM64).
다운로드 페이지에서 다운로드전체 설치 안내는 Cherry Studio 문서를 따릅니다. 이 사이트는 설치 프로그램을 호스팅하거나 수정하지 않습니다.
일반 오류 문제 해결
가장 빈번한 문제는 4가지 범주로 나뉩니다.
401 / 유효하지 않은 API 키
증상: 요청이 401, Unauthorized 또는 Invalid API Key를 반환합니다.
원인: 보통 API 키가 유효하지 않거나, 잘못 입력되었거나, 추가 문자와 함께 복사된 경우입니다.
- Cherry Studio 제공자 설정에 API 키를 다시 붙여넣으세요(추가 공백 없이)
- 키가 유효한 AI Code With API 키인지 확인하세요
- 메시지 전송을 다시 시도하세요
Model Not Found / 잘못된 모델 ID
증상: 요청에서 Model Not Found 또는 알 수 없는 모델이 보고됩니다.
원인: Model ID가 잘못 입력되었거나 해당 모델을 현재 사용할 수 없습니다.
- 제공자 설정의 Model ID가 이 페이지의 ID와 일치하는지 확인하세요
- 키로 해당 모델에 접근할 수 있는지 확인하세요
- AI Code With 가격 페이지에서 모델을 사용할 수 있는지 확인하세요
API 주소 오류
증상: 테스트 시 또는 메시지 전송 시 요청이 실패하거나 모델 목록이 비어 있습니다.
원인: API 주소의 경로가 잘못되었거나 /v1이 누락되었습니다.
- 값이 https://api.aicodewith.ai/v1인지 확인하세요(/v1 포함)
- 끝에 있는 /v1/models 또는 추측한 경로를 제거하세요
- 설정을 저장하고 다시 테스트하세요
모델 동기화 결과가 비어 있음
증상: 모델 동기화를 클릭해도 모델이 반환되지 않습니다.
원인: API 주소에 연결할 수 없거나, 네트워크가 제한되어 있거나, 엔드포인트가 모델 목록 자동 가져오기를 지원하지 않습니다.
- API 주소가 https://api.aicodewith.ai/v1로 시작하는지 확인하세요
- 네트워크를 바꾸고 다시 시도하세요
- +를 클릭하고 Model ID를 입력하여 제공자를 수동으로 사용하세요