업데이트: 2026-06-06ChatBox는 Windows, macOS, Linux를 지원하고 Web 버전도 있는 일반적인 크로스 플랫폼 AI 클라이언트입니다. Crazyrouter를 연동할 때는 특정 제조사 사전 설정을 찾기보다 ChatBox의
OpenAI API Compatible 또는 OpenAI API 방식으로 설정하는 것을 권장합니다.
이 방식의 장점은 다음과 같습니다.
- 설정이 간단하여 일반 사용자가 빠르게 연동하기 적합
- Crazyrouter에서 이미 허용된 모델로 바로 전환 가능
- 데스크톱 대화, 지식 베이스 질의응답, 파일 보조 독해 등의 사용 시나리오에 적합
먼저 결론부터
다음 설정 조합을 우선 사용하는 것을 권장합니다.- Provider / API Mode:
OpenAI API Compatible또는OpenAI API - API Host:
https://api.crazyrouter.com - API Path: 기본값 유지 또는 비워둠
- API Key:
sk-xxx - 첫 검증 모델:
gpt-5.5
ChatBox 공식 문서에 따르면,
API Path는 일반적으로 수동으로 입력할 필요가 없으며 기본값이 바로 OpenAI 호환 채팅 경로입니다. 따라서 Crazyrouter 문서에서는 API Host를 루트 도메인인 https://api.crazyrouter.com으로 작성하고, 먼저 /v1/chat/completions를 수동으로 추가하지 않는 것을 권장합니다.이런 분께 추천합니다
- 데스크톱 환경에서 Crazyrouter를 빠르게 사용하고 싶은 사용자
- 다중 모델로 일상 대화, 번역, 요약, 작문 보조를 하고 싶은 분
- 로컬 지식 베이스나 파일 질의응답 기능을 Crazyrouter와 결합하고 싶은 분
- 코드를 작성하지 않고 GUI에서만 설정을 완료하고 싶은 분
사전 준비 사항
첫 라운드에는 다음만 허용하는 것을 권장합니다.
gpt-5.5claude-opus-4-8gemini-3.1-pro
ChatBox 설치
Windows
- ChatBox 공식 사이트 열기
- Windows 설치 패키지 다운로드
- 더블클릭하여 설치
- 완료 후 ChatBox 실행
macOS
- ChatBox 공식 사이트 열기
- macOS 설치 패키지 다운로드
Applications로 드래그- 처음 열 때 시스템 보안 경고가 나타나면 시스템 안내에 따라 허용을 완료
Linux
- ChatBox 공식 사이트 열기
- 사용 중인 배포판에 맞는 설치 패키지 또는 데스크톱 버전 다운로드
- 설치 후 ChatBox 실행
권장 설정 방식
ChatBox 버전마다 인터페이스 명칭이 약간 다를 수 있으며, 흔히 볼 수 있는 진입점은 다음과 같습니다.SettingsModel ProviderAI ProviderAdd
OpenAI API 제공자가 내장되어 있다면 바로 선택하면 되고, 없다면 OpenAI API Compatible 제공자를 새로 추가하세요.
설정 단계
1
1단계: Crazyrouter에서 ChatBox 전용 토큰 생성
처음에는 1~2개의 모델만 허용하는 것을 권장합니다. 예:
gpt-5.5claude-opus-4-8
2
2단계: ChatBox 설정 열기
ChatBox를 실행한 후, 왼쪽 하단의 설정 진입점을 클릭하고 다음으로 이동합니다.
Model Provider- 또는
AI Provider
3
3단계: OpenAI 호환 제공자 선택 또는 추가
두 가지 경우를 권장합니다.
- 이미
OpenAI API가 있다면 바로 선택 - 없다면
Add를 클릭하여OpenAI API Compatible제공자를 새로 추가
4
4단계: Crazyrouter 연결 정보 입력
다음과 같이 입력하는 것을 권장합니다.
API Host:https://api.crazyrouter.comAPI Path: 기본값 유지 또는 비워둠API Key:sk-xxx
Crazyrouter로 작성할 수 있습니다.5
5단계: 첫 모델 추가
처음에는 모델 하나만 추가하는 것을 권장합니다.
gpt-5.5
claude-opus-4-8gemini-3.1-pro
6
6단계: Check 또는 Save로 먼저 연결 테스트
사용 중인 ChatBox 버전에
Check 버튼이 있다면 먼저 Check를 클릭하세요.Save만 있다면 먼저 저장한 후, 메인 화면으로 돌아가 새 대화를 만들어 테스트하세요.7
7단계: 메인 화면에서 첫 최소 검증 수행
새 채팅을 만들고, 현재 모델이 안정적으로
gpt-5.5인지 확인한 후 다음을 입력하세요.OK 또는 그와 유사한 결과가 반환되면, ChatBox에서 Crazyrouter로 이어지는 주 경로가 이미 연결된 것입니다.권장 검증 순서
다음 순서로 진행하는 것을 권장하며, 처음부터 많은 모델과 기능을 한 번에 켜지 마세요.- 먼저 토큰 1개만 설정
- 먼저 모델 1개
gpt-5.5만 설정 - 먼저 순수 텍스트 채팅만 검증
- 그다음 두 번째 모델 추가
- 마지막으로 지식 베이스, 파일 질의응답, 복잡한 대화 파라미터를 활성화
권장 모델
ChatBox의 일반적인 기능을 Crazyrouter와 어떻게 조합할까
일반 채팅
가장 간단하며 설정이 올바른지 검증하는 데 우선 사용합니다.지식 베이스 / 파일 질의응답
일반 채팅이 이미 정상 작동한 후에 활성화하는 것을 권장합니다. 첫 테스트 시:- 파일은 최대한 작게
- 내용은 최대한 명확하게
- 먼저 단일 파일 질의응답을 검증
다중 모델 전환
ChatBox에서 서로 다른 작업 분업을 하기에 적합합니다. 예:- 기본 기준 채팅:
gpt-5.5 - 중요 요약 및 작문:
claude-opus-4-8 - 첫 라운드 표준 검증:
gpt-5.5
파라미터 권장 사항
ChatBox 버전이 일반적인 샘플링 파라미터를 지원한다면, 처음에는 보수적으로 유지하는 것을 권장합니다.토큰 모범 사례
검증 체크리스트
- ChatBox를 설치하고 정상적으로 실행할 수 있음
- ChatBox 전용 Crazyrouter 토큰을 생성함
-
OpenAI API또는OpenAI API Compatible을 선택함 -
API Host를https://api.crazyrouter.com으로 입력함 -
API Path를 기본값으로 유지하거나 비워둠 -
sk-xxx를 성공적으로 입력함 - 먼저
gpt-5.5만 추가함 -
Check또는 최소 대화로 검증을 완료함 - Crazyrouter 백엔드 로그에서 해당 요청을 확인할 수 있음
자주 발생하는 오류와 해결 방법
FAQ
ChatBox에서 어떤 Provider를 선택해야 하나요?
OpenAI API 또는 OpenAI API Compatible을 우선 선택하세요.
API Host에는 무엇을 입력해야 하나요?
https://api.crazyrouter.com을 입력하세요.
/v1/chat/completions를 수동으로 입력해야 하나요?
일반적으로 필요하지 않습니다. ChatBox 공식 문서에 따르면 API Path는 보통 기본값이 있으므로 먼저 기본값을 유지하거나 비워두면 됩니다.
첫 모델은 무엇을 입력하는 것이 좋나요?
먼저gpt-5.5를 입력하세요.
언제 더 많은 모델과 지식 베이스를 추가해야 하나요?
최소 채팅 링크 검증이 통과된 후, 점차 늘려나가세요.“먼저 ChatBox를 정상 작동시키는 것”이 목표라면, 가장 좋은 방법은 한 번에 많은 모델과 기능을 설정하는 것이 아니라 먼저
gpt-5.5로 최소 채팅 링크 검증을 성공시키는 것입니다.