Claude Desktop 연동
Claude Desktop의 Third-Party Inference를 Letsur 게이트웨이에 연결하세요.
Third-Party Inference에는 게이트웨이 주소, API 키, 모델을 설정하며, 일부 기능은 지원 범위에서 제외됩니다.
시작 전 준비
- AI 게이트웨이 API 키
현재 사용할 수 있는 AI 게이트웨이 API 키를 준비합니다.
- Claude 모델 코드
에셋에 표시된 정확한 모델 코드를 확인합니다.
- 지원되는 Claude Desktop
Developer 메뉴에 Third-Party Inference 설정이 표시되는 버전을 사용합니다.
이 가이드는 사용자가 앱 안에서 직접 연결하는 경로를 다룹니다. 조직 관리자가 MDM으로 배포한 Third-Party Inference 설정이 있으면 그 설정이 우선하며, 앱의 입력 폼은 읽기 전용으로 표시될 수 있습니다.
연결 설정
Third-Party Inference 열기
개발자 모드 활성화
Claude Desktop을 실행하고 메뉴 바에서 도움말 → 문제 해결 → 개발자 모드 활성화를 선택합니다.
타사 추론 설정 열기
메뉴 바에서 개발자 → 타사 추론 설정으로 이동합니다.
게이트웨이 주소와 키 입력
Connection 섹션에서 다음 값을 입력합니다.
| 필드 | 값 |
|---|---|
| Inference provider | Gateway |
| Gateway base URL | https://gw.letsur.ai (/v1을 붙이지 않습니다) |
| Gateway API key | Letsur AI 게이트웨이 API 키 |
| Credential kind | Static API key |
| Gateway auth scheme | x-api-key |
모델 선택
Models 섹션에는 에셋의 정확한 Claude 모델 코드를 입력합니다. 전체 모델 ID를 명시하면 현재 Claude Desktop은 그 목록을 picker에 그대로 사용합니다.
모델 목록을 비우면 앱은 게이트웨이의 GET /v1/models 응답에서 Claude 모델을 자동 탐색합니다. 게이트웨이가 이 endpoint를 제공하지 않거나 모델 ID가 Claude 계열로 인식되지 않으면 picker가 비어 있을 수 있으므로, 이 가이드에서는 전체 모델 ID를 직접 지정하는 방식을 권장합니다.
1M context 표시는 앱이 검증해 주는 값이 아닙니다. 해당 모델과 게이트웨이에서 1M context를 실제로 지원하는지 확인한 경우에만 supports1m 옵션을 사용합니다.
연결 확인
설정 적용
화면에 표시된 저장 및 적용 절차를 완료하고 앱을 재시작합니다.
응답 확인
Cowork 또는 Code에서 새 세션을 열고 메시지를 보냅니다.
Gateway was unreachable이 표시되면 base URL과 네트워크 경로를 먼저 확인합니다.
지원 범위와 제약
Third-Party Inference가 활성화된 Claude Desktop 세션은 로컬 머신에서 실행됩니다. SSH와 Anthropic-hosted cloud 환경 및 Remote Control은 사용할 수 없습니다.
| 기능 | Third-Party Inference |
|---|---|
| Cowork 및 Code 탭 | 지원 |
| Chat 탭 | 관리자 opt-in 시 지원 |
| 파일 접근, 업로드 및 내보내기 | 지원 |
| 로컬 및 원격 MCP | 지원 |
| Skills, plugins 및 hooks | 지원 |
| 프로젝트 및 plugin 공유 | 미지원 |
| Web, Mobile, Voice 및 Claude in Chrome | 미지원 |
| Computer use | 미지원 |
문제 해결
| 증상 | 먼저 확인할 것 |
|---|---|
| 모델 선택기가 비어 있습니다 | Models 섹션에 에셋의 전체 모델 ID를 직접 입력했는지 확인합니다 |
Gateway was unreachable이 표시됩니다 | Gateway base URL에 /v1을 붙이지 않았는지와 네트워크 경로를 확인합니다 |
| 메시지를 보낼 수 없습니다 | API key, auth scheme, 모델 코드와 게이트웨이의 Messages streaming 및 tool use 지원을 확인합니다 |
설정 기준: Claude Desktop gateway deployment , Third-Party feature matrix , Claude Code gateway surface guide 에서 설정 필드, 모델 탐색, 지원 범위를 2026년 8월 7일에 확인했습니다.