Claude Desktop

Claude 데스크톱 앱의 서드파티 추론(게이트웨이) 기능으로 PleumRouter를 연결합니다.

Claude Desktop은 Anthropic의 데스크톱 앱입니다. 개발자 모드의 Configure Third-Party Inference 폼에서 게이트웨이 주소와 키를 넣으면 PleumRouter로 모델을 호출합니다. 이 방식에서는 Anthropic 계정으로 로그인하지 않습니다. 터미널 도구는 Claude Code를 보세요.

서드파티 도구입니다. Claude Desktop은(는) PleumRouter가 만들거나 보증하는 제품이 아니며, 모든 기능이 PleumRouter의 모델에서 동작한다고 보장하지 않습니다. Claude Desktop은(는) 제작사 모델에 맞춰 개발돼 있어, 다른 모델로 연결하면 도구 호출·추론 표시·이미지 입력 등이 다르게 동작할 수 있습니다.

PleumRouter 소스 코드와 Claude Desktop 공식 문서를 바탕으로 작성하고 2026-09-27에 마지막으로 검토했습니다. 도구가 업데이트되면 설정이 달라질 수 있으니 Claude Desktop 공식 문서를 우선하세요.

왜 Claude Desktop에 PleumRouter를 쓰나요?#

선불 크레딧으로 사용한 만큼만 결제합니다. 도구 제작사의 구독과 별개로 시장 통화 크레딧이 차감됩니다.
키마다 예산과 한도를 겁니다. API 키별 일·주·월 예산과 모델 허용 목록, 팀 예산으로 에이전트의 폭주 비용을 막습니다.
한 키로 여러 모델을 씁니다. Claude·GPT·Gemini·오픈 모델을 골라 쓰고, 공급자 장애 시 자동 재시도·폴백이 동작하며, 사용량은 대시보드에서 봅니다.

빠른 시작#

API 키 발급
대시보드 → API 키에서 plm_로 시작하는 키를 만드세요. 데스크톱 앱 전용 키를 따로 만들어 이름을 구분해 두면 폐기하기 쉽습니다.
개발자 모드 켜기
앱을 열고 Help → Troubleshooting → Enable Developer Mode를 선택하세요. Mac은 화면 맨 위 메뉴바, Windows는 로그인 화면 왼쪽 위 ☰ 메뉴에 있습니다. Anthropic 계정으로 로그인하지 마세요.

Gateway 설정 입력

Developer → Configure Third-Party Inference에서 Connection을 Gateway로 고르고 아래 값을 넣으세요. 주소에 /v1을 붙이지 않습니다.

Configure Third-Party Inference

Connection            Gateway
Gateway base URL      https://apirouter.pleum.ai
Credential kind       Static API key
Gateway API key       plm_xxxxxxxxxxxxxxxx
Gateway auth scheme   bearer

적용하고 다시 시작
Apply locally(버전에 따라 Apply Changes)를 누르면 앱이 다시 시작됩니다. 게이트웨이(서드파티)로 계속하는 버튼이 보이면 그것을 고르세요. 모델 칸이 있으면 claude-sonnet-5처럼 카탈로그 ID를 넣고, 짧은 메시지에 응답이 오면 연결 성공입니다.

작동 방식#

Gateway 모드의 앱은 Anthropic 프로토콜(Messages)로 게이트웨이에 직접 요청합니다. Base URL이 https://apirouter.pleum.ai이면 앱이 /v1/messages로 보내고, 인증은 Authorization: Bearer plm_…입니다. Claude Code와 같은 엔드포인트라 PleumRouter 쪽 동작도 같습니다. 이 앱은 설정 파일이 아니라 앱 안의 폼이 정석입니다. 숨은 Application Support 폴더의 파일을 추측해서 고치지 마세요.

설정 레퍼런스#

항목	설명
ConnectionGateway	게이트웨이 백엔드를 고릅니다.
Gateway base URLhttps://apirouter.pleum.ai	`/v1` 없는 루트 주소입니다. 끝의 `/`도 붙이지 않습니다.
Credential kindStatic API key	고정 API 키 방식입니다. OIDC 관련 칸은 비워 둡니다.
Gateway API keyplm_…	PleumRouter API 키.
Gateway auth schemebearer	`Authorization: Bearer` 헤더로 보냅니다.
Allowed egress hosts(필요 시)	Workspace restrictions 탭. 웹 가져오기(WebFetch)가 막히면 허용할 호스트를 추가합니다.

모델 선택#

모델 칸이 있으면 PleumRouter 카탈로그 ID를 그대로 넣으세요. 정확한 ID는 모델 카탈로그나 GET /v1/models에서 확인합니다. Claude 모델(claude-sonnet-5, claude-opus-5-5 등)이 가장 자연스럽고, 다른 회사 모델을 넣으면 Anthropic이 지원하는 조합이 아니라서 기능 동작을 보장하지 않습니다.

지원 범위#

기능	상태	설명
스트리밍·도구 호출	✓ 지원	Claude Code와 같은 `/v1/messages` 엔드포인트를 씁니다.
이미지 입력	✓ 지원	선택한 모델이 이미지 입력을 지원할 때만 동작합니다.
SSH·Remote Control	✗ 미지원	게이트웨이 모드에서는 제공되지 않는 제한입니다. 고장이 아닙니다.
웹 가져오기(WebFetch)	△ 일부	샌드박스가 막을 수 있어 Allowed egress hosts에 호스트를 추가해야 합니다.
Claude 계정에 묶인 기능	? 미확인	계정으로 로그인하지 않으므로 계정 연동 기능은 제공되지 않을 수 있습니다.
Claude가 아닌 모델	△ 일부	연결은 되지만 Anthropic이 지원하는 조합이 아닙니다.

문제 해결#

증상	원인과 조치
Gateway 항목이 보이지 않습니다	개발자 모드를 켠 뒤 설정을 적용하고 앱을 완전히 종료(Mac은 Cmd+Q)했다가 다시 여세요.
연결 오류가 납니다	Gateway base URL이 정확히 `https://apirouter.pleum.ai`인지 확인하세요. `/v1`이나 끝의 `/`가 붙으면 실패합니다.
401 Unauthorized	Credential kind가 Static API key, auth scheme이 bearer, 키가 `plm_`로 시작하는지 확인하고 OIDC 칸은 비우세요.
모델이 보이지 않거나 model not found	카탈로그 ID를 정확히 입력했는지 `GET /v1/models`로 확인하고, 402가 함께 나오면 크레딧 잔액과 키 예산을 확인하세요.
웹 가져오기가 막힙니다	Developer → Configure Third-Party Inference의 Workspace restrictions 탭에서 Allowed egress hosts에 호스트를 추가하세요.
다시 열었더니 로그인 화면이 나옵니다	Anthropic 로그인 대신 게이트웨이로 계속하는 버튼을 선택하세요. 설정이 사라졌다면 3단계를 다시 적용하세요.

지원 범위와 면책#

제휴·보증 없음. PleumRouter는 Claude Desktop의 제작사와 제휴 관계가 아니며 이 문서는 참고용입니다. Claude Desktop의 동작·지원 범위·정책은 제작사가 정하고 예고 없이 바뀔 수 있습니다.
약관은 사용자 책임입니다. 도구 제작사와 모델 제공사의 이용약관·사용 정책을 지킬 책임은 사용자에게 있습니다.
비용이 빨리 쌓일 수 있습니다. 에이전트는 한 작업에서 모델을 수십~수백 번 호출하고 긴 컨텍스트를 반복 전송합니다. 사용량만큼 PleumRouter 크레딧이 차감되므로, 처음에는 API 키에 일·주·월 예산을 걸어 두세요.
키는 비밀번호처럼 다루세요. 설정 파일이나 셸 프로필에 평문으로 두면 같은 PC의 다른 프로그램이 읽을 수 있습니다. 설정 파일을 git에 커밋하지 말고, 유출이 의심되면 대시보드에서 즉시 폐기하고 새로 발급하세요.
코드가 외부로 전송됩니다. 프롬프트·코드·파일 내용은 선택한 모델의 제공사로 전송되며 국외 서버일 수 있습니다. 민감한 코드는 데이터 처리 위치, 개인정보 마스킹, 개인정보처리방침을 확인한 뒤 사용하세요.
상표. 모든 제품명과 상표는 각 소유자의 자산이며, 호환성을 설명하기 위해서만 사용합니다.