Claude Desktop 연동

Documentation Index

Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

개요

Claude Desktop은 Anthropic의 공식 데스크톱 앱으로, 로컬 환경에서 Claude를 사용할 수 있습니다. 이 가이드는 Claude Desktop을 EvoLink API에 연결하고, Anthropic Messages API와 호환되는 모델을 EvoLink를 통해 사용하는 방법을 설명합니다. 이 가이드에서 다루는 내용:

• Claude Desktop 설치
• 개발자 모드 활성화
• EvoLink 연결 설정
• 재시작 후 모델 선택

​

사전 준비

시작하기 전에 EvoLink API Key를 준비하세요.

​

EvoLink API Key 얻기

• EvoLink 콘솔에 로그인합니다
• 콘솔에서 API Keys를 찾고 Create New Key를 클릭한 뒤 생성된 키를 복사합니다
• API Key는 보통 sk-로 시작합니다. 안전하게 보관하세요

​

1단계: Claude Desktop 다운로드

Claude Desktop 다운로드 페이지를 열고 운영체제에 맞는 버전을 설치합니다.

​

설치 후 확인

설치가 끝나면 Claude Desktop이 정상적으로 실행되는지 확인하세요.

​

2단계: 개발자 모드 활성화

Claude Desktop을 실행한 뒤 Help → Troubleshooting을 클릭하고, 나타나는 창에서 개발자 모드를 활성화합니다. 활성화 후에는 서드파티 추론 설정을 위한 Developer 메뉴가 표시됩니다.

​

3단계: 서드파티 추론 설정 열기

Developer 메뉴에서 서드파티 추론 패널을 열고 아래 표에 맞게 입력합니다.

​

4단계: 저장 후 재시작

설정을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행합니다. 재시작 후 Claude Desktop은 새 서드파티 추론 설정을 사용해야 합니다. 예상 결과: 실행 후 사용 가능한 모델 목록이 보이고, 요청이 EvoLink를 통해 전달됩니다.

​

5단계: 모델 선택

재시작한 뒤 모델 선택 영역에서 사용 가능한 모델이 정상적으로 표시되는지 확인하세요.

​

동작 방식

Claude Desktop은 Anthropic 호환 게이트웨이를 통해 EvoLink와 통신합니다.

1. Claude Desktop이 설정한 게이트웨이 주소로 요청을 보냅니다.
2. EvoLink가 요청을 받아 해당 모델 서비스로 전달합니다.
3. 응답이 돌아오면 Claude Desktop은 로컬에서 대화를 계속 표시합니다.

별도의 로컬 프록시는 필요하지 않습니다.

​

지원 모델

Model list에 표시할 모델을 제한하려면 다음 모델 ID를 사용할 수 있습니다.

​

FAQ

​

Developer 메뉴가 보이지 않음

개발자 모드가 활성화되어 있는지, Claude Desktop을 완전히 재시작했는지 확인하세요.

​

설정 후 연결할 수 없음

다음을 확인하세요.

• Base URL이 올바른지
• API Key가 유효한지
• 인증 방식이 bearer인지
• Claude Desktop을 완전히 종료했다가 다시 실행했는지

​

모델이 보이지 않음

계정과 네트워크가 정상인지 확인한 뒤, 서드파티 추론 설정이 정상적으로 저장되었는지 확인하세요.

​

Model list를 꼭 입력해야 하나요?

아니요. 비워두면 해당 API Key로 사용할 수 있는 모든 모델이 표시됩니다.

​

모델을 수동으로 지정하려면 무엇을 입력하나요?

위의 “지원 모델” 표에 있는 모델 ID를 Claude Desktop이 기대하는 형식으로 입력하세요.