Claude Desktop
Anthropic이 개발한 데스크톱용 AI 어시스턴트 앱입니다. jiminbox 유저는 타사 추론을 통해 jiminbox에서 제공하는 LLM 모델을 Claude Desktop에서 사용할 수 있습니다.
개요
Claude Desktop은 Anthropic에서 제공하는 공식 데스크톱 애플리케이션입니다. 기본적으로는 Anthropic의 Claude 모델을 사용하지만, jiminbox에서 제공하는 타사 추론(Third-party Inference) 기능을 활용하면 타 사의 모델을 Claude Desktop UI 내에서 사용할 수 있습니다.
설치 요구사항
시스템 요구사항
- macOS: macOS 12+ (Apple Silicon 및 Intel 모두 지원)
- Windows: Windows 10/11 64비트
- 별도의 Node.js나 CLI 설치 불필요
API Key 보안 주의
API Key는 비밀번호처럼 중요한 인증 정보입니다. 설정 파일이나 클라이언트에 입력한 API Key를 다른 사람에게 공유하거나 Git 저장소에 커밋하지 마세요. 유출되었다고 생각되면 기존 키를 폐기하고 새 키를 발급받으세요.
설치 가이드
1. Claude Desktop 다운로드 및 설치
- Claude 공식 다운로드 페이지에 접속합니다.
- 사용 중인 운영체제(macOS 또는 Windows)에 맞는 설치 파일을 다운로드합니다.
- 다운로드한 파일을 실행하여 설치를 진행합니다.
- macOS:
.dmg파일을 열고 Claude 아이콘을 Applications 폴더로 드래그 - Windows:
.exe설치 파일을 실행하고 안내에 따라 진행
- macOS:
- 설치가 완료되면 Claude Desktop 앱을 실행합니다.
설치 확인
앱 실행 후 Claude 로그인 화면이 나타나면 설치가 정상적으로 완료된 것입니다.
로그인 화면이 나오면 다음단계로 넘어가주세요
2. jiminbox API 키 발급
Claude Desktop에서 jiminbox 모델을 사용하려면 API 키가 필요합니다.
- api.jiminbox.com에 접속하여 로그인합니다.
- 좌측 Token Management 메뉴로 이동 후 Create Token 버튼을 클릭합니다.
- 식별 가능한 이름을 입력하고 Submit 버튼을 클릭하여 API 키를 발급받습니다.
자세한 발급 방법은 jiminbox 빠른 시작 가이드를 참고하세요.
3. 타사 추론 설정 (필수)
jiminbox 유저는 Claude Desktop에서 타사 추론(Third-party Inference) 기능을 활성화하여 jiminbox의 LLM 모델을 사용해야 합니다.
3-1. 개발자 모드 활성화
Claude Desktop 앱을 엽니다(로그인할 필요가 없음).
- 좌측 상단의 메뉴 바에서 도움말 → 문제 해결 → 개발자 모드 활성화를 선택합니다.
- 개발자 모드가 활성화되면 메뉴에 개발자 항목이 새로 추가됩니다.
개발자 모드 확인
메뉴 바에 개발자 항목이 보이면 활성화된 것입니다.
3-2. 타사 추론 구성
개발자 모드 활성화 후, 타사 추론 설정 UI를 엽니다.
- 메뉴에서 개발자 → 타사 추론 구성으로 이동합니다.
- 아래 표의 필수 항목을 하나씩 입력합니다.
| 필드 | 값 | 설명 |
|---|---|---|
| 추론 공급자 | gateway | 타사 API 게이트웨이 사용 |
| 게이트웨이 기본 URL | https://api.jiminbox.com | jiminbox API 엔드포인트 |
| 게이트웨이 API 키 | sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | jiminbox 빠른 시작 가이드에서 발급받은 키 |
설정 팁
언급하지 않은 설정에 대해서는 기본값을 유지하는것을 권장합니다.
- 모든 필드를 입력한 후 로컬에 적용을 클릭합니다.
설정 예시 (화면에 표시되는 내용)
추론 공급자 (inferenceProvider): gateway
게이트웨이 기본 URL (inferenceGatewayBaseUrl): https://api.jiminbox.com
게이트웨이 API 키 (inferenceGatewayApiKey): sk-your-api-key-here
주의
- 게이트웨이 기본 URL은 반드시
https://api.jiminbox.com으로 입력하세요./v1이나/v1beta접미사는 붙이지 않습니다.
3-3. 설정 파일 내보내기 (선택)
설정 UI 하단의 내보내기 버튼을 클릭하면, 배포용 설정 파일을 다운로드할 수 있습니다.
| OS | 내보내기 파일 | 배포 방법 |
|---|---|---|
| macOS | .mobileconfig | Jamf, Kandji, Mosyle, Intune for Mac 등 MDM 솔루션으로 배포 |
| Windows | .reg | 그룹 정책, Intune, 또는 레지스트리 임포트로 배포 |
기업/팀 배포 시
개인 사용자는 이 단계를 건너뛰어도 됩니다. 기업 환경에서 다수의 PC에 동일한 설정을 적용하려면 내보낸 파일을 IT 관리자에게 전달하세요.
3-4. Claude Desktop 재시작
설정을 저장한 후 Claude Desktop을 완전히 종료했다가 다시 실행합니다.
- Claude Desktop을 종료합니다 (Cmd + Q 또는 Ctrl + Q).
- 앱을 다시 실행합니다.
- 왼쪽 탐색 메뉴에 Cowork 탭과 Code 탭이 표시되는지 확인합니다.
정상 동작 확인
- Chat 탭이 보이지 않음 → 타사 추론 모드가 정상적으로 활성화된 것입니다. 이 모드에서는 Anthropic 서비스 없이 jiminbox 모델만 사용합니다.
- Cowork 및 Code 탭이 보임 → 타사 추론이 정상적으로 구성되었습니다.
3-5. 모델 선택 및 연결 확인
- Claude Desktop 하단의 모델 선택 드롭다운을 클릭합니다.
- jiminbox에서 제공하는 claude 호환 모델이 표시되는지 확인합니다.
- 원하는 모델을 선택하고 간단한 테스트 메시지(예: “안녕하세요”)를 보냅니다.
- 응답이 정상적으로 오면 연결 성공입니다.
모델
현재 사용가능한 antropic의 모델들은 claude code의 원활한 작동을 위해 임의로 설정한 이름으로, 실제 작동하는 모델과 다릅니다.
- Haiku: glm-5(실제 작동 모델)
- Opus: glm-5.1
- Sonnet: glm-5
사용에 유의 바랍니다.
문제 해결
- “인증 실패” 오류: API Key가 올바른지,
sk-접두사가 포함되었는지 확인하세요.- “모델을 찾을 수 없음”: 모델 ID의 대소문자와 하이픈(-)이 정확한지 확인하세요. jiminbox Pricing에서 최신 모델 목록을 확인하세요.
- “연결 시간 초과”: 네트워크 상태를 확인하고, 방화벽이
api.jiminbox.com도메인을 차단하지 않는지 확인하세요.- “Quota exceeded”: jiminbox 빠른 시작 가이드에서 사용량 한도를 확인하세요.
4. MCP 서버 설정 (선택 사항)
Claude Desktop의 강력한 기능 중 하나는 MCP(Model Context Protocol) 서버 연동입니다. MCP를 통해 로컬 파일시스템, 데이터베이스, GitHub 등 외부 도구와 연동할 수 있습니다.
기본 설정 예시
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Desktop"]
}
}
}MCP 서버 설치 전 준비
일부 MCP 서버는 Node.js가 필요합니다. Node.js가 설치되어 있지 않다면 node.js 설치 가이드를 참고하세요.
주의
MCP 서버는 로컬 시스템에 직접 접근할 수 있습니다. 신뢰할 수 있는 서버만 설치하세요.
마무리
이제 Claude Desktop이 jiminbox API와 연동되어 사용 준비가 완료되었습니다.
- 일반 대화: 바로 Claude와 대화를 시작할 수 있습니다.
- 파일 분석: 이미지, PDF, 문서를 첨부하여 AI에게 분석을 요청할 수 있습니다.
- 프로젝트 관리: 사이드바에서 프로젝트별 대화를 관리할 수 있습니다.
- MCP 확장: MCP 서버를 연동하여 로컬 도구와 연결할 수 있습니다.
추가 가이드
- jiminbox 빠른 시작 가이드 — API 키 발급 및 사용량 확인
- opencode 설치 가이드 — OpenCode CLI/Desktop 설치 및 jiminbox API 연동
- opencode.json 템플릿 — OpenCode 설정 템플릿
도움이 필요하신가요?
설치나 설정 중 문제가 발생하면 jiminbox 관리자에게 문의해 주세요.