문서
API 상태대시보드
대시보드로 돌아가기

Claude 데스크톱 앱: 사용자 지정 Base URL과 API 키 설정

macOS 또는 Windows용 Claude 데스크톱 앱을 LLMsRelay에 연결하는 방법입니다. 개발자 모드를 켜고 '타사 추론 설정'을 열어 https://api.llmsrelay.com과 키를 입력한 뒤 Code 탭에서 확인합니다.

🇬🇧 Read in English🇷🇺 Читать на русском🇨🇳 中文阅读

LLMsRelay는 독립적으로 운영되는 API 게이트웨이이며 Anthropic, PBC와 제휴하거나 보증받지 않습니다. 제품 및 모델 이름은 호환성을 설명하기 위해서만 사용됩니다.

위치: 개발자 → 타사 추론 설정. 게이트웨이 기본 URL: https://api.llmsrelay.com. 게이트웨이 API 키: sk-cs4-*. 키 그룹: Basic 또는 Pro. Claude 구독: 필요 없음.

시작하기 전에

  • macOS 또는 Windows용 Claude 데스크톱 앱(claude.com/download). 오래된 버전이라면 먼저 업데이트하세요. 타사 추론 설정은 최신 버전에 있습니다.
  • 잔액이 있는 LLMsRelay 계정. 잔액이 없다면 요금제 페이지에서 일회성 사용량 팩을 구매하세요.
  • 약 10분. Claude Pro 또는 Max 구독은 필요 없습니다.

LLMsRelay 키 만들기

  1. 대시보드에서 API 키를 엽니다.
  2. Basic 또는 Pro 그룹에서 키를 만듭니다. 키는 sk-cs4-로 시작합니다.
  3. 키를 복사하고 페이지를 닫지 마세요. 전체 키는 한 번만 표시됩니다.

개발자 모드 켜기

게이트웨이 설정은 숨겨진 개발자 메뉴에 있습니다. 개발자 모드는 이 메뉴를 표시할 뿐이며 파일이나 채팅은 변경하지 않습니다.

macOS

  1. Claude 앱을 열고 앱 창의 아무 곳이나 클릭합니다.
  2. 화면 맨 위의 메뉴 막대에서 다음을 엽니다.

도움말문제 해결개발자 모드 활성화…

영어 인터페이스: Help › Troubleshooting › Enable Developer Mode…

Windows

  1. Claude 앱을 열고 창 왼쪽 위의 세 줄 메뉴 버튼(☰)을 클릭합니다.
  2. 다음을 엽니다.

도움말문제 해결개발자 모드 활성화…

영어 인터페이스: Help › Troubleshooting › Enable Developer Mode…

개발자 모드를 활성화하시겠습니까?라는 확인 창이 개발자 도구와 디버깅 기능에 대한 안내와 함께 나타납니다. 활성화(Enable)를 클릭하세요. 앱이 자동으로 다시 시작됩니다. 다시 시작하면 도움말 옆에 개발자(Developer) 메뉴가 나타납니다. Windows에서는 ☰ 버튼 안에 있습니다.

타사 추론 설정 열기

개발자타사 추론 설정…

영어 인터페이스: Developer › Configure Third-Party Inference…

별도의 설정 창이 열립니다. 여기에는 앱이 모델 요청을 어디로, 어떤 키로 보내는지가 저장됩니다.

LLMsRelay 게이트웨이 입력

아래와 같이 정확하게 입력하세요. 목록에 없는 항목은 비워 둡니다.

추론 공급자 (Inference provider)
Gateway
게이트웨이 기본 URL (Gateway base URL)
https://api.llmsrelay.com — 끝에 /v1이나 슬래시를 붙이지 않습니다
자격 증명 종류 (Credential kind)
정적 API 키(Static API key), 이 항목이 표시되는 경우
게이트웨이 API 키 (Gateway API key)
1단계에서 만든 키(sk-cs4-로 시작)
게이트웨이 인증 방식 (Gateway auth scheme)
bearer를 그대로 둡니다. x-api-key도 LLMsRelay에서 작동합니다.
게이트웨이 기본 URLtext
https://api.llmsrelay.com

변경 사항 적용(Apply Changes)을 클릭한 다음 저장 및 재시작(Save & Restart)을 클릭합니다. 앱이 자동으로 다시 시작됩니다.

LLMsRelay로 앱 시작하기

앱이 다시 시작되면 로그인 화면에 방금 입력한 설정으로 앱을 시작하는 옵션이 나타납니다. Anthropic 계정 로그인이 아니라 이 옵션을 선택하세요. 이메일이나 비밀번호는 입력하지 않아도 됩니다.

이제 앱은 Claude (타사) 모드로 실행됩니다. 별도의 모드이므로 Chat, Cowork, Code가 모두 LLMsRelay를 통해 작동하고, 대화는 이 컴퓨터에 저장되며, claude.ai 계정의 채팅과 프로젝트는 여기에 표시되지 않습니다.

요청이 LLMsRelay를 거치는지 확인

  1. Code 탭을 열고 아무 폴더에서나 세션을 시작합니다.
  2. 짧은 테스트 메시지를 보냅니다.
테스트 메시지text
정확히 한 단어로만 답하세요: pong
  1. Claude가 pong이라고 답합니다. 이 모드에서는 앱이 모델에 접근하는 다른 경로가 없으므로, 답변이 왔다면 요청이 LLMsRelay를 거친 것입니다.
  2. LLMsRelay 대시보드를 엽니다. 1분 안에 사용량 기록에 요청이 표시됩니다.

기술적으로 확인하려면 메시지 입력란에 /status를 입력하세요. Anthropic base URL 줄에 https://api.llmsrelay.com이 표시됩니다.

앱에 표시되는 비용은 Anthropic 정가 기준의 추정치입니다. 실제 청구 금액은 LLMsRelay 대시보드에서 확인하세요.

모델 선택

평소처럼 Code 탭의 모델 선택기에서 모델을 고릅니다. 어떤 모델이 model not found 같은 오류를 반환하면 다른 모델(예: Claude Opus 5.5)을 선택하세요.

키로 사용할 수 있는 모델은 모델 페이지에서 확인하거나 게이트웨이에 직접 물어볼 수 있습니다.

키로 사용할 수 있는 모델bash
curl https://api.llmsrelay.com/v1/models \
  -H "x-api-key: YOUR_SK_CS4_KEY"

타사 모드에서 달라지는 점

  • Chat, Cowork, Code는 LLMsRelay를 통해 작동하며 LLMsRelay 잔액에서 차감됩니다.
  • 대화는 Claude 계정이 아니라 이 컴퓨터에 저장됩니다.
  • Cowork에는 macOS 14 이상, Windows에서는 .msix 패키지로 설치한 앱이 필요합니다. Chat과 Code는 이 조건 없이도 작동합니다.
  • Remote Control을 사용할 수 없습니다. 휴대폰이나 claude.ai/code에서 이 세션을 이어갈 수 없습니다.
  • 환경 선택기에 Anthropic이 호스팅하는 클라우드 환경이 표시되지 않습니다.
  • 설정은 이 컴퓨터에만 저장됩니다. 같은 설정이 필요한 컴퓨터마다 위 단계를 반복하세요.

Claude 계정으로 돌아가기

로그인 화면에서 타사 옵션 대신 Anthropic 로그인을 선택하세요. LLMsRelay 설정은 그대로 저장되어 있어 같은 방법으로 다시 전환할 수 있습니다. 키나 주소를 바꾸려면 언제든 개발자 → 타사 추론 설정…을 다시 여세요.

개발자 모드는 켜 둬도 됩니다. 개발자 메뉴를 추가할 뿐이며 Claude 계정 사용에는 영향을 주지 않습니다.

문제 해결

개발자 메뉴가 없습니다

개발자 모드가 꺼져 있거나 앱이 아직 다시 시작되지 않았습니다. 2단계를 반복하고 다시 시작될 때까지 기다리세요. Windows에서는 왼쪽 위 ☰ 버튼 안에 메뉴가 있습니다. 문제 해결 메뉴에 개발자 모드 활성화 항목이 없다면 앱을 업데이트하세요.

로그인 화면에 타사 옵션이 없습니다

앱이 설정을 읽지 못했습니다. 앱이 실행 중일 때 설정을 저장하면 이런 일이 생깁니다. 앱을 완전히 종료한 뒤(macOS는 Cmd+Q, Windows는 ☰ 메뉴의 종료) 다시 여세요. 추론 공급자가 Gateway인지, 주소와 키가 모두 입력되었는지도 확인하세요.

“Gateway was unreachable” 또는 “추론 제공자에 연결할 수 없습니다”

앱이 주소에 연결하지 못했습니다. 게이트웨이 기본 URL이 정확히 https://api.llmsrelay.com인지 확인하세요. 브라우저에서 api.llmsrelay.com/healthz를 열어 보세요. 열리지 않으면 VPN, 프록시 또는 방화벽이 연결을 막고 있는 것입니다.

“구성된 API 키가 추론 공급자에 의해 거부되었습니다”

게이트웨이가 키를 받아들이지 않았습니다. 설정 창을 다시 열고 공백 없이 키를 다시 붙여 넣으세요. API 키에서 키가 Basic 또는 Pro 그룹에 속하고 취소되지 않았는지 확인하세요.

잔액 때문에 요청이 멈췄습니다

요금제 페이지에서 사용량 팩을 추가하세요. 충전 후 키는 그대로 작동하며 앱에서 바꿀 것은 없습니다.

앱이 여전히 Claude 계정을 사용합니다

타사 설정이 아니라 Anthropic 로그인으로 앱을 시작했거나 설정이 저장되지 않았습니다. 설정 창에서 값을 확인하고 앱을 다시 시작한 뒤, 앱이 claude.ai 계정으로 열렸다면 로그아웃하고 로그인 화면에서 추론 공급자 옵션을 선택하세요. LLMsRelay 대시보드에 보이지 않는 요청은 LLMsRelay를 거치지 않은 것입니다.

터미널에서는 되는데 데스크톱 앱에서는 안 됩니다(또는 그 반대)

두 곳은 따로 설정합니다. 터미널과 편집기는 ~/.claude/settings.json을 읽고, 데스크톱 앱은 타사 추론 설정을 읽습니다. 같은 LLMsRelay 키를 두 곳에서 모두 사용할 수 있습니다.

시작할 준비가 되셨나요?

2분 만에 Claude 전체 모델 API에 연결하세요.

요금 보기