Claude Desktop 설정 튜토리얼(데스크톱 클라이언트)
Claude Desktop은 Anthropic의 공식 데스크톱 클라이언트입니다(Windows / macOS). 공식 계정으로 로그인하지 않아도 대화 요청을 NextHub로 보낼 수 있는 '서드파티 추론 게이트웨이'설정 항목이 내장되어 있습니다.
Claude Code와는 다른 제품입니다
Claude Desktop(데스크톱 클라이언트)과 Claude Code(커맨드 라인 / VS Code 확장)는 서로 다른 두 제품이며, 설정이 공유되지 않으므로 각각 설정해야 합니다. 이 페이지에서는 데스크톱 클라이언트를 다루며, 커맨드 라인 설정은 Claude Code 수동 설정을 참고하세요.
준비 사항
- Claude 계열 그룹의 ApiKey: claude code(0.37x), Claude Max(0.5x) 또는 Claude-AWSB(0.7x). 자세한 내용은 ApiKey 관리를 참고하세요. Claude Desktop은 Anthropic Messages 프로토콜을 사용하며 주소 체계는 Claude Code와 동일합니다
- claude.com/download에서 사용 중인 운영체제에 맞는 설치 파일을 다운로드합니다
Windows 설치 참고 사항
Windows 설치 프로그램은 실행 중에 Anthropic 공식 서비스에 접근합니다. 네트워크 환경에서 직접 연결할 수 없다면 설치 프로그램이 있는 디렉터리에서 cmd를 열고 프록시 환경 변수를 설정한 뒤 설치 프로그램을 실행하세요(포트는 본인의 값으로 변경하세요):
set HTTP_PROXY=http://127.0.0.1:7897
set HTTPS_PROXY=http://127.0.0.1:7897
"Claude Setup.exe"macOS는 일반적인 방법으로 설치하면 됩니다.
수동 설정(개발자 모드)
1. 개발자 모드 활성화
Claude Desktop을 열고 로그인 화면으로 이동하세요:
- Windows: 마우스로 메일 입력창을 클릭해 포커스를 맞춘 뒤
Tab키로 포커스를 좌측 상단 메뉴로 옮기고, 엔터를 눌러 Help → Troubleshooting → Enable developer mode 순서로 진입합니다 - macOS: 좌측 상단 메뉴에서 Help → Troubleshooting → Enable developer mode 순서로 바로 진입합니다
활성화하면 소프트웨어가 자동으로 재시작할 때까지 기다리세요.
2. 서드파티 추론 게이트웨이 설정
같은 방법으로 메뉴를 열어 Developer → Configure third-party inference 순서로 진입한 뒤, 아래 표대로 입력하세요:
| 필드 | 입력 내용 |
|---|---|
| Gateway base URL | https://api.nexthub.cc |
| Gateway auth scheme | x-api-key |
| Gateway API key | 당신의 NextHub ApiKey(Claude 계열 그룹) |
| Skip login-mode chooser | 켜기 |
우측 하단의 Apply locally 버튼을 클릭하면 설정이 적용됩니다.
'테스트 통과'를 기다리지 마세요
이 페이지는 서드파티 게이트웨이 모드를 사용하며, Anthropic 공식 계정 로그인 검증이 아닙니다. 따라서 '연결 성공 / 테스트 통과' 안내는 나타나지 않으며, 기다릴 필요도 없습니다. Apply locally를 클릭한 뒤 바로 대화창으로 돌아가 메시지를 보내고, 응답이 오면 설정이 적용된 것입니다.
3. 검증
새 대화를 만들어 메시지를 하나 보내고, Claude의 응답이 정상적으로 도착하면 연동에 성공한 것입니다.
첫 메시지의 소액 호출
새 대화를 만든 뒤 소비 내역에 선택한 모델과 다른 소액 호출이 하나 기록될 수 있습니다. 이는 클라이언트가 대화 제목을 자동으로 생성하면서 발생하는 것이며, 금액이 매우 작아 정상적인 현상입니다.
CC-Switch로 설정하기(선택 사항)
수동 절차가 번거롭다면 CC-Switch의 Claude Desktop 패널을 사용하세요. Claude Code에 이미 설정된 공급자를 원클릭으로 가져올 수 있습니다:
- CC-Switch를 열고 좌측 앱 전환기에서 Claude Desktop을 선택합니다(보이지 않으면 설정 → 일반 → 앱 가시성에서 진입 항목이 숨겨져 있지 않은지 확인하세요)
- 처음 진입하면 'Claude Code에 이미 있는 공급자 가져오기'를 클릭하고, 또는 우측 상단의
+버튼을 눌러 수동으로 추가합니다. 인터페이스 주소에는https://api.nexthub.cc, API Key에는 Claude 계열 그룹의 API 키를 입력합니다 - 공급자 카드에서 '활성화'를 클릭한 뒤 Claude Desktop을 완전히 종료하고 다시 실행하세요(Claude Code처럼 설정을 핫 리로드하지 않으므로, 창을 닫는 것이 프로그램 종료를 의미하지는 않습니다)
재시작 후 나타나는 두 가지 경고는 오탐입니다
완전히 재시작한 뒤 대화 페이지에 '설정이 확인되지 않음''네트워크 연결' 같은 경고 배너가 나타날 수 있습니다. 이는 게이트웨이 모드에서 흔히 발생하는 오탐이므로 무시해도 되며, 메시지를 정상적으로 주고받을 수 있으면 설정이 적용된 것입니다. 응답이 오지 않는다면 다음을 순서대로 확인하세요. CC-Switch가 실행 중인지, 인터페이스 주소와 ApiKey가 올바른지, 완전 재시작을 했는지입니다.