Claude Code와 Cherry Studio를 서드파티 API 릴레이에 연결하는 튜토리얼(5분 만에 시작)

2026-09-28 ｜ RouteAPI 팀 ｜ 5 min read

Claude Code는 Anthropic 공식 터미널 코딩 에이전트이고, Cherry Studio는 중국에서 가장 인기 있는 데스크톱 AI 클라이언트 중 하나입니다. 둘 다 기본적으로 공식 엔드포인트에 연결되어 공식 정가로 과금됩니다. 이 글에서는 요청을 API 릴레이로 전환하는 방법을 알려드립니다. 설정 항목 두 개만 바꾸면 됩니다.

목차

1. 먼저 API Key 받기 2. Claude Code 설정 3. Cherry Studio 설정 4. 확인 및 자주 묻는 질문

1. 먼저 API Key 받기

  1. RouteAPI를 열고 가입 또는 로그인(Google 원클릭 로그인 지원);
  2. 왼쪽의 "API 키" → 키 생성 후 sk-xxxx 형태의 키를 복사;
  3. 잔액이 부족하면 충전 페이지에서 온라인 충전. 결제가 완료되면 자동으로 반영됩니다.

2. Claude Code 설정

Claude Code는 환경 변수로 업스트림 주소를 지정합니다. 셸 설정 파일(~/.zshrc 또는 ~/.bashrc)에 적어 넣으면 됩니다.

# 릴레이 사용(Anthropic 호환 프로토콜)
export ANTHROPIC_BASE_URL=https://route-api.site
export ANTHROPIC_AUTH_TOKEN=sk-당신의-키

# 또는 OpenAI 호환 프로토콜 사용(사용자 지정 base_url을 지원하는 도구용)
export OPENAI_BASE_URL=https://route-api.site/v1
export OPENAI_API_KEY=sk-당신의-키

저장 후 source ~/.zshrc를 실행(또는 터미널 재시작)한 다음 평소처럼 claude 명령을 사용하면 됩니다. 모델명은 모델 카탈로그를 참고하세요.

3. Cherry Studio 설정

  1. Cherry Studio 열기 → 왼쪽 아래 "설정" → "모델 서비스";
  2. "추가"를 선택해 OpenAI 호환 공급자를 생성(또는 기존 공급자를 직접 편집);
  3. API 주소에 https://route-api.site/v1을 입력하고, API Key에 sk- 키를 입력;
  4. "모델 목록 가져오기"를 클릭하거나, 모델 설정에서 사용할 모델명을 수동으로 추가(예: claude-sonnet-4-6, gpt-5.6-terra);
  5. 채팅 화면으로 돌아가 상단에서 모델을 전환하면 시작할 수 있습니다.

4. 확인 및 자주 묻는 질문

설정이 맞는지 어떻게 확인하나요? 메시지를 한 번 보내서 정상적으로 답변이 오면 성공입니다. 콘솔의 "사용 기록"에 이번 호출의 토큰 사용량과 비용이 함께 표시됩니다.

401 오류가 나나요? 키가 완전히 복사되었는지, 주소가 /v1으로 끝나는지 확인하세요.

잔액 부족이라고 나오나요? 충전 페이지에서 충전하고 잔액이 반영된 뒤 다시 시도하세요.

어떤 모델을 지원하나요? Claude, GPT, Grok 등 모든 모델은 모델 카탈로그에서 확인하세요. 모두 공식 참조 가격의 49%로 통일 과금됩니다.

모델

모델 →