업데이트: 2026-06-06
연동 튜토리얼
이 문서 페이지에는2026-03-23에 Crazyrouter 프로덕션 환경에서 재검증된 시작 경로만 작성되어 있습니다.
가장 빠르게 시작하려면 먼저 세 가지 연동 방식을 구분하세요.
- OpenAI 호환:
https://api.crazyrouter.com/v1 - Anthropic 네이티브:
https://api.crazyrouter.com - Gemini 네이티브:
https://api.crazyrouter.com/v1beta/models/...
최소 마이그레이션 원칙
OpenAI 호환 클라이언트에서 Crazyrouter로 마이그레이션할 때는 보통 두 가지만 변경하면 됩니다.base_url을https://api.crazyrouter.com/v1로 변경api_key를 Crazyrouter의sk-xxx로 변경
OpenAI에서 마이그레이션
gpt-5.5는/v1/chat/completions를 통해 정상적으로 응답함- reasoning 요약이나 OpenAI 스타일 web search가 필요하다면
/v1/responses로 전환하는 것을 우선하세요
Anthropic에서 마이그레이션
방안 A: OpenAI 호환 레이어 계속 사용
방안 B: Anthropic 네이티브 Messages 사용
- 일반적인 Claude 대화:
claude-opus-4-8을 우선 사용 - thinking block이 명확히 필요한 경우:
claude-opus-4-8을 우선 사용
Gemini에서 마이그레이션
방안 A: OpenAI 호환 레이어
방안 B: Gemini 네이티브
- 기존 OpenAI SDK 코드만 재사용: 먼저 호환 레이어 사용
- 구조화된 출력, Google Search, thinking이 필요: Gemini 네이티브를 우선 사용
환경 변수 방식
OpenAI 호환 레이어를 사용한다면, 먼저 다음을 설정하는 것을 권장합니다.- Linux / macOS
- Windows
시작 권장 사항
Crazyrouter는 OpenAI, Anthropic, Gemini 세 가지 프로토콜을 모두 지원합니다. 더 안정적인 방법은 보통 “모든 모델을 강제로 동일한 프로토콜로 처리”하는 것이 아니라, 능력에 따라 가장 적합한 진입점을 선택하는 것입니다.