Claude Desktop
게이트웨이의 Claude 모델로 Cowork와 Code 연결하기
앱의 Third-Party Inference에서 주소, 키와 모델을 설정하는 방법과 조직에서 배포한 설정이 우선하는 조건을 안내합니다.
페이지 목차
시작 전 준비
설정을 마치면 Claude Desktop의 Cowork와 Code가 AI 게이트웨이를 거쳐 에셋의 Claude 모델을 호출합니다. 앱의 Third-Party Inference 설정에 게이트웨이 주소, API 키와 모델 코드를 입력하고, 새 세션에서 모델 응답을 확인합니다.
- AI 게이트웨이 API 키
현재 사용할 수 있는 AI 게이트웨이 API 키를 준비합니다.
- 지원되는 Claude Desktop
Developer 메뉴에 Configure Third-Party Inference… 항목이 표시되는 버전을 사용합니다. Gateway auth scheme 필드는 Claude Desktop 1.3036.0 이상에서 지원됩니다.
이 가이드는 사용자가 앱 안에서 직접 연결을 설정하는 방법을 다룹니다.
조직 관리자가 MDM 프로필 등으로 배포한 설정이 있으면 그 설정이 우선하고, 앱의 설정 창은 읽기 전용으로 열립니다. 관리자가 업데이트 정책이나 네트워크 프록시 같은 앱 동작 설정만 배포했다면 설정 창을 계속 편집할 수 있습니다.
Claude Desktop에 넣을 값은 아래 단계에 모두 있습니다. API 형식별 기본 URL과 인증 헤더 전체는 인증과 기본 URL에 정리돼 있습니다.
연결 설정
개발자 모드 활성화
Claude Desktop을 실행합니다. macOS에서는 메뉴 바에서, Windows에서는 로그인 화면 왼쪽 위의 애플리케이션 메뉴(☰)에서 Help > Troubleshooting > Enable Developer Mode를 선택합니다. 앱이 다시 시작되고 Developer 메뉴가 표시됩니다.
Third-Party Inference 설정 창 열기
Developer > Configure Third-Party Inference… 항목을 선택합니다. 설정 창의 왼쪽 목록에서 Connection 섹션을 먼저 엽니다.
게이트웨이 주소와 키 입력
Connection 섹션에서 Inference provider를 지정한 뒤 Gateway credentials 항목에 다음 값을 입력합니다.
필드 값 Inference provider GatewayGateway base URL https://gw.letsur.ai(/v1을 추가하지 않습니다)Gateway API key 렛서 AI 게이트웨이 API 키 Credential kind Static API keyGateway auth scheme x-api-keyGateway auth scheme의 앱 기본값은
Bearer입니다. 게이트웨이는 Anthropic Messages 요청에x-api-key헤더 인증을 권장하므로x-api-key를 선택합니다.모델 입력
Models 섹션에 에셋의 정확한 Claude 모델 코드를 입력합니다. 입력한 모델이 Chat, Cowork와 Code의 모델 선택기에 표시되고, 목록의 첫 항목이 새 대화와 세션의 기본 모델이 됩니다. 모든 항목이 전체 모델 코드이면 앱은
GET /v1/models호출을 생략합니다.모델 목록을 비우면 앱이 게이트웨이의
GET /v1/models응답에서 모델을 자동으로 찾습니다. 앱은 Claude 모델로 인식한 모델 코드만 표시하므로, 이 API를 사용할 수 없거나 앱이 모델 코드를 인식하지 못하면 모델 선택기가 비어 있을 수 있습니다. 전체 모델 코드를 직접 입력하는 방식을 권장합니다.게이트웨이와 모델이 100만 토큰 요청을 받는다고 확인한 경우에만supports1m을 지정하세요1M context는 100만 토큰 컨텍스트 창을 뜻합니다. 모델 항목에
supports1m을 지정하면 모델 선택기에 같은 모델이 1M context window 항목으로 하나 더 표시됩니다. 게이트웨이와 모델이 100만 토큰 요청을 받지 않으면 이 항목으로 보낸 요청이 실패합니다.설정 적용
Apply Changes를 선택하고 확인합니다. 설정이 이 기기에 저장되고 앱이 다시 시작됩니다.
앱이 다시 시작되면 Developer 메뉴가 사라집니다. 1단계에서 Third-Party Inference 설정 전에 개발자 모드를 켰기 때문입니다. 설정 창을 다시 열려면 Help > Troubleshooting > Enable Developer Mode를 한 번 더 선택하세요. 그다음부터는 메뉴가 유지됩니다.
연결 확인
Cowork 또는 Code에서 새 세션을 열고 메시지를 보냅니다. 모델 응답이 표시되면 Claude Desktop이 게이트웨이를 거쳐 모델을 호출한 것입니다. Gateway was unreachable이 표시되면 base URL과 네트워크 경로를 먼저 확인합니다.
지원 범위와 제약
아래 기능의 사용 가능 여부는 앱 버전, 조직 또는 기기 설정, 선택한 모델과 게이트웨이의 지원 범위에 따라 달라집니다. 이 가이드에서는 텍스트 응답으로 모델 연결을 확인합니다. 도구와 확장 기능의 실제 동작은 별도로 확인합니다.
| 사용할 기능 | Claude Desktop의 조건 |
|---|---|
| Cowork 및 Code | Third-Party Inference에서 제공합니다. SSH 원격 실행은 Code의 SSH 원격 세션 조건을 따릅니다 |
| Chat | Chat 대화도 설정한 추론 공급자로 요청을 보냅니다. 현재 버전에서는 Chat과 Cowork를 합친 Unified Claude가 기본으로 켜져 있어, Cowork를 실행할 수 있는 기기에서는 홈 화면에서 보낸 메시지가 Cowork 세션으로 시작됩니다. 이 동작은 렛서 스페이스의 Admin 역할 설정과 별개입니다 |
| 파일 접근, 업로드 및 내보내기 | Third-Party Inference에서 제공합니다. 적용되는 설정을 확인합니다 |
| MCP, Skills, plugins 및 hooks | 앱의 확장 기능으로 사용할 수 있습니다. 조직 배포와 사용 설정은 공식 확장 안내 를 따릅니다. 선택한 모델과 게이트웨이에서 도구가 실제로 동작하는지도 확인합니다 |
| 프로젝트와 사용자 간 공유 | 프로젝트 기능을 사용할 수 있으나 사용자 간 공유는 지원되지 않습니다. 조직의 플러그인 배포는 사용자 간 공유와 별개입니다 |
| Claude in Chrome | Enterprise Admin Console로 관리하는 조직에서만 사용할 수 있습니다. Enterprise Admin Console을 사용하려면 Anthropic 담당자를 통해 조직을 준비해야 합니다. MDM, 로컬 설정 파일 또는 bootstrap 서버로 설정한 경우에는 앱의 내장 브라우저를 사용합니다 |
| claude.ai 웹 접속, 모바일 및 음성 | Third-Party Inference에서는 지원되지 않습니다 |
| Anthropic 호스팅 클라우드 환경과 Remote Control | 게이트웨이 구성이 적용되면 환경 선택기에 Anthropic 호스팅 클라우드 환경이 표시되지 않고 Remote Control도 사용할 수 없습니다 |
전체 기능과 설정 조건은 공식 기능표 , Unified Claude 안내 , 조직 또는 기기 설정 과 Enterprise Admin Console 안내 에서 확인합니다.
Code의 SSH 원격 세션
일반 세션은 로컬 머신에서 실행됩니다. Code의 SSH 원격 세션은 beta이며 기본으로 꺼져 있습니다.
연결 전에 조직의 자격 증명 취급 기준과 SSH 설정 조건 을 확인하세요.
원격 세션을 사용하려면 다음 조건을 갖춰야 합니다.
- Claude Desktop 1.40609.0 이상
- Code 설정의 허용 호스트 목록(
sshHostAllowlist)에 접속할 호스트 지정 - 원격 호스트에서 게이트웨이에 접근하고 게이트웨이 인증서를 신뢰할 수 있는 네트워크 환경. 앱은 로컬 머신의 프록시 설정과 CA 인증서를 원격 호스트에 전달하지 않습니다
문제 해결
| 증상 | 다음 행동 |
|---|---|
| 설정을 적용한 뒤 Developer 메뉴가 보이지 않습니다 | 개발자 모드를 Third-Party Inference 설정 전에 켰다면 앱이 다시 시작될 때 메뉴가 사라집니다. Help > Troubleshooting > Enable Developer Mode를 다시 선택하면 이후에는 유지됩니다. 조직에서 관리하는 앱에서 메뉴 항목 자체가 없다면 설정 담당자에게 개발자 모드 허용 여부를 확인합니다 |
| 모델 선택기가 비어 있습니다 | Models 섹션에 에셋 화면의 전체 모델 코드를 직접 입력했는지 확인합니다 |
Gateway was unreachable이 표시됩니다 | 앱이 시작할 때 Gateway base URL에 연결하지 못했다는 뜻입니다. base URL의 /v1 포함 여부와 네트워크 경로를 확인합니다 |
| 메시지를 보낼 수 없습니다 | 앱에 입력한 API key, auth scheme과 모델 코드를 위 설정 값과 대조하고, 에셋 화면에서 그 모델의 Messages 지원 여부를 확인합니다. 오류가 표시되면 오류 처리에서 대응 방법을 확인합니다 |
설정이 맞아도 메시지를 보낼 수 없거나 사용할 조합이 스트리밍과 도구 호출을 지원하는지 확인하기 어렵다면, 로그인 후 플랫폼 내 문의 기능으로 Claude Desktop 버전, 모델 코드, 오류 문구와 발생 시각을 보내세요. 문의에 API 키는 포함하지 마세요.
설정 기준: Deploy Claude Desktop on 3P with an LLM gateway , In-app configuration , Models and effort levels , Deploy with MDM , Features , Unified Claude , Chat , Built-in browser and Claude in Chrome , Deploy with Enterprise Admin Console , MCP, plugins, skills, and hooks , SSH remote sessions , Claude Code 게이트웨이 연결의 Desktop app 항목 의 메뉴 경로, Connection 필드와 기본값, 모델 목록과 supports1m, 관리형 설정 우선순위, 기능별 사용 조건과 SSH 원격 세션 조건을 2026년 11월 13일에 확인했습니다. 이 확인에는 렛서 게이트웨이와의 실제 연동 시험이 포함되지 않습니다.