Claude Desktop
Claude Desktop에서 AI 게이트웨이의 Claude 모델로 Cowork와 Code를 사용하세요.
앱의 Third-Party Inference 설정을 사용하며 조직에서 배포한 설정이 있으면 그 설정을 따릅니다.
시작 전 준비
- AI 게이트웨이 API 키
현재 사용할 수 있는 AI 게이트웨이 API 키를 준비합니다.
- Claude 모델 코드
에셋에서 Messages를 지원하는 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의 모델 선택기에 해당 목록이 그대로 표시됩니다.
모델 목록을 비우면 앱은 게이트웨이의 GET /v1/models 응답에서 Claude 모델을 자동 탐색합니다. 게이트웨이가 이 endpoint를 제공하지 않거나 모델 ID가 Claude 계열로 인식되지 않으면 모델 선택기가 비어 있을 수 있으므로, 이 가이드에서는 전체 모델 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 스트리밍 및 도구 호출(tool use) 지원을 확인합니다 |
설정 기준: Claude Desktop gateway deployment , Third-Party feature matrix , Claude Code gateway surface guide 에서 설정 필드, 모델 탐색, 지원 범위를 2026년 8월 7일에 확인했습니다.