본문으로 건너뛰기

Claude Desktop

게이트웨이의 Claude 모델로 Cowork와 Code 연결하기

앱의 Third-Party Inference에서 주소, 키와 모델을 설정하는 방법과 조직에서 배포한 설정이 우선하는 조건을 안내합니다.

페이지 목차

시작 전 준비

설정을 마치면 Claude Desktop의 Cowork와 Code가 AI 게이트웨이를 거쳐 에셋의 Claude 모델을 호출합니다. 앱의 Third-Party Inference 설정에 게이트웨이 주소, API 키와 모델 코드를 입력하고, 새 세션에서 모델 응답을 확인합니다.

  • AI 게이트웨이 API 키

    현재 사용할 수 있는 AI 게이트웨이 API 키를 준비합니다.

  • Claude 모델 코드

    에셋에서 Messages를 지원하는 Claude 모델의 정확한 코드를 확인합니다. Claude Desktop에는 Messages의 스트리밍과 도구 호출을 지원하는 모델 및 게이트웨이가 필요합니다. 사용할 모델과 게이트웨이 조합이 두 기능을 지원하는지 확인하기 어렵다면 아래 문의 안내를 따르세요.

  • 지원되는 Claude Desktop

    Developer 메뉴에 Configure Third-Party Inference… 항목이 표시되는 버전을 사용합니다. Gateway auth scheme 필드는 Claude Desktop 1.3036.0 이상에서 지원됩니다.

이 가이드는 사용자가 앱 안에서 직접 연결을 설정하는 방법을 다룹니다.

조직이 배포한 설정이 있으면 앱에서 직접 입력한 값은 무시됩니다

조직 관리자가 MDM 프로필 등으로 배포한 설정이 있으면 그 설정이 우선하고, 앱의 설정 창은 읽기 전용으로 열립니다. 관리자가 업데이트 정책이나 네트워크 프록시 같은 앱 동작 설정만 배포했다면 설정 창을 계속 편집할 수 있습니다.

Claude Desktop에 넣을 값은 아래 단계에 모두 있습니다. API 형식별 기본 URL과 인증 헤더 전체는 인증과 기본 URL에 정리돼 있습니다.

연결 설정

  1. 개발자 모드 활성화

    Claude Desktop을 실행합니다. macOS에서는 메뉴 바에서, Windows에서는 로그인 화면 왼쪽 위의 애플리케이션 메뉴(☰)에서 Help > Troubleshooting > Enable Developer Mode를 선택합니다. 앱이 다시 시작되고 Developer 메뉴가 표시됩니다.

  2. Third-Party Inference 설정 창 열기

    Developer > Configure Third-Party Inference… 항목을 선택합니다. 설정 창의 왼쪽 목록에서 Connection 섹션을 먼저 엽니다.

  3. 게이트웨이 주소와 키 입력

    Connection 섹션에서 Inference provider를 지정한 뒤 Gateway credentials 항목에 다음 값을 입력합니다.

    필드값
    Inference providerGateway
    Gateway base URLhttps://gw.letsur.ai (/v1을 추가하지 않습니다)
    Gateway API key렛서 AI 게이트웨이 API 키
    Credential kindStatic API key
    Gateway auth schemex-api-key

    Gateway auth scheme의 앱 기본값은 Bearer입니다. 게이트웨이는 Anthropic Messages 요청에 x-api-key 헤더 인증을 권장하므로 x-api-key를 선택합니다.

  4. 모델 입력

    Models 섹션에 에셋의 정확한 Claude 모델 코드를 입력합니다. 입력한 모델이 Chat, Cowork와 Code의 모델 선택기에 표시되고, 목록의 첫 항목이 새 대화와 세션의 기본 모델이 됩니다. 모든 항목이 전체 모델 코드이면 앱은 GET /v1/models 호출을 생략합니다.

    모델 목록을 비우면 앱이 게이트웨이의 GET /v1/models 응답에서 모델을 자동으로 찾습니다. 앱은 Claude 모델로 인식한 모델 코드만 표시하므로, 이 API를 사용할 수 없거나 앱이 모델 코드를 인식하지 못하면 모델 선택기가 비어 있을 수 있습니다. 전체 모델 코드를 직접 입력하는 방식을 권장합니다.

    게이트웨이와 모델이 100만 토큰 요청을 받는다고 확인한 경우에만 supports1m을 지정하세요

    1M context는 100만 토큰 컨텍스트 창을 뜻합니다. 모델 항목에 supports1m을 지정하면 모델 선택기에 같은 모델이 1M context window 항목으로 하나 더 표시됩니다. 게이트웨이와 모델이 100만 토큰 요청을 받지 않으면 이 항목으로 보낸 요청이 실패합니다.

  5. 설정 적용

    Apply Changes를 선택하고 확인합니다. 설정이 이 기기에 저장되고 앱이 다시 시작됩니다.

    앱이 다시 시작되면 Developer 메뉴가 사라집니다. 1단계에서 Third-Party Inference 설정 전에 개발자 모드를 켰기 때문입니다. 설정 창을 다시 열려면 Help > Troubleshooting > Enable Developer Mode를 한 번 더 선택하세요. 그다음부터는 메뉴가 유지됩니다.

연결 확인

Cowork 또는 Code에서 새 세션을 열고 메시지를 보냅니다. 모델 응답이 표시되면 Claude Desktop이 게이트웨이를 거쳐 모델을 호출한 것입니다. Gateway was unreachable이 표시되면 base URL과 네트워크 경로를 먼저 확인합니다.

지원 범위와 제약

아래 기능의 사용 가능 여부는 앱 버전, 조직 또는 기기 설정, 선택한 모델과 게이트웨이의 지원 범위에 따라 달라집니다. 이 가이드에서는 텍스트 응답으로 모델 연결을 확인합니다. 도구와 확장 기능의 실제 동작은 별도로 확인합니다.

사용할 기능Claude Desktop의 조건
Cowork 및 CodeThird-Party Inference에서 제공합니다. SSH 원격 실행은 Code의 SSH 원격 세션 조건을 따릅니다
ChatChat 대화도 설정한 추론 공급자로 요청을 보냅니다. 현재 버전에서는 Chat과 Cowork를 합친 Unified Claude가 기본으로 켜져 있어, Cowork를 실행할 수 있는 기기에서는 홈 화면에서 보낸 메시지가 Cowork 세션으로 시작됩니다. 이 동작은 렛서 스페이스의 Admin 역할 설정과 별개입니다
파일 접근, 업로드 및 내보내기Third-Party Inference에서 제공합니다. 적용되는 설정을 확인합니다
MCP, Skills, plugins 및 hooks앱의 확장 기능으로 사용할 수 있습니다. 조직 배포와 사용 설정은 공식 확장 안내 를 따릅니다. 선택한 모델과 게이트웨이에서 도구가 실제로 동작하는지도 확인합니다
프로젝트와 사용자 간 공유프로젝트 기능을 사용할 수 있으나 사용자 간 공유는 지원되지 않습니다. 조직의 플러그인 배포는 사용자 간 공유와 별개입니다
Claude in ChromeEnterprise 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일에 확인했습니다. 이 확인에는 렛서 게이트웨이와의 실제 연동 시험이 포함되지 않습니다.