Skip to main content
업데이트: 2026-06-06
Zotero 자체는 문헌 관리 도구이며, Crazyrouter 설정 진입점을 직접 내장하고 있지 않습니다. 실제 연동 방식은 일반적으로: 먼저 AI 호출을 지원하는 Zotero 플러그인을 설치한 뒤, 해당 플러그인에서 Crazyrouter의 OpenAI 호환 주소, API 키, 모델명을 입력하는 것입니다. 이 페이지에서 가장 중요한 원칙은 “아무 Zotero AI 플러그인이나 골라서 연동할 수 있다”가 아니라, 먼저 플러그인 유형을 구분하는 것입니다:
  • 직접 연동 가능: 플러그인이 Base API URL / API URL / Endpoint 사용자 지정을 지원함
  • 직접 연동 불가능 또는 공개 메인 경로로 부적합: 플러그인이 공식 OpenAI 키 입력만 지원하며, 사용자 지정 업스트림 주소 입력 항목이 없음

​
먼저 결론부터

Zotero에서 Crazyrouter를 사용하는 공개 권장 연동 방법은 다음과 같습니다:
  • 사용자 지정 OpenAI 호환 주소를 지원하는 Zotero AI 플러그인을 선택합니다
  • 기본 주소를 https://api.crazyrouter.com/v1로 입력합니다
  • API 키를 sk-xxx로 입력합니다
  • 첫 번째 검증 모델은 gpt-5.5를 사용합니다
모든 Zotero AI 플러그인이 사용자 지정 업스트림 주소를 지원하는 것은 아닙니다. 어떤 플러그인이 “OpenAI API 키 입력” 항목만 있고 Base URL 또는 API URL 설정이 없다면, 이 플러그인은 일반적으로 요청을 Crazyrouter로 직접 전환할 수 없습니다. 이런 플러그인은 공개 기본 가이드로 사용하지 않아야 합니다.

​
왜 이렇게 작성했는가

현재 Zotero AI 플러그인 생태계는 편차가 크기 때문입니다:
  • Zotero 공식 문서에 따르면, 플러그인은 커뮤니티 생태계이며 설치 방식은 통일되어 있지만 기능은 통일되어 있지 않습니다
  • 일부 플러그인은 사용자 지정 base API URL을 명확히 지원합니다
  • 일부 플러그인의 공개 문서에는 OpenAI API Key 입력만 기재되어 있습니다
따라서 Crazyrouter 공개 문서에서는 사용자가 “사용자 지정 OpenAI 호환 주소를 지원하는” 플러그인을 선택하도록 우선 안내해야 하며, 모든 플러그인이 기본적으로 직접 연동 가능하다고 가정해서는 안 됩니다.

​
이런 분들께 적합합니다

  • Zotero에서 논문 요약, 번역, 질의응답을 하고 싶은 사용자
  • 문헌 읽기와 Crazyrouter 모델 호출을 하나의 워크플로에 통합하고 싶은 분
  • 문헌 항목, PDF 읽기, 노트 정리 과정에 AI 보조를 추가하고 싶은 분
  • 스크립트를 직접 작성하지 않고, Zotero의 그래픽 인터페이스에서 바로 설정을 완료하고 싶은 분

​
사전 준비 조건

첫 라운드에는 다음만 허용하는 것을 권장합니다:
  • gpt-5.5
  • claude-opus-4-8
  • gemini-3.1-pro

​
Zotero 설치

​
Windows

  1. Zotero 공식 다운로드 페이지를 엽니다
  2. Windows 설치 패키지를 다운로드합니다
  3. 설치 프로그램을 실행합니다
  4. Zotero를 시작합니다

​
macOS

  1. Zotero 공식 다운로드 페이지를 엽니다
  2. macOS 설치 패키지를 다운로드합니다
  3. Zotero를 Applications로 드래그합니다
  4. Zotero를 시작합니다

​
Linux

  1. Zotero 공식 다운로드 페이지를 엽니다
  2. 공식 Linux 패키지를 다운로드합니다
  3. 압축을 풀고 Zotero 공식 안내에 따라 실행합니다
  4. Zotero가 정상적으로 열리는지 확인합니다
Zotero 공식 문서에 따르면, 플러그인은 주로 데스크톱 버전에 설치됩니다. 이런 종류의 AI 플러그인은 일반적으로 모바일 기기를 첫 라운드 설정 진입점으로 사용하기에 적합하지 않습니다.

​
Zotero AI 플러그인 선택 방법

공개 문서에서는 다음 조건을 만족하는 플러그인을 우선 선택하는 것을 권장합니다:
  • Base API URL, API URL 또는 Endpoint를 입력할 수 있음
  • API Key를 입력할 수 있음
  • 모델명을 수동으로 입력할 수 있음
  • Zotero 환경설정에서 이러한 파라미터를 수정할 수 있으면 더 좋습니다

​
권장하는 공개 판단 방법

플러그인 문서에서 다음과 같은 기능을 명확히 언급하고 있다면, 일반적으로 Crazyrouter 연동에 더 적합합니다:
  • Customize base API URL
  • API URL
  • Custom endpoint
  • Model preferences
예를 들어, zotero-chatgpt의 공개 README에는 사용자 지정 base API URL 지원이 명확히 언급되어 있습니다. 반면 Aria의 공개 README는 OpenAI API Key와 모델 선호 설정 입력에 중점을 두고 있으며, 공개 설명에서 “사용자 지정 업스트림 주소”를 주요 기능으로 다루고 있지 않습니다. 따라서 Crazyrouter 문서에서는 “사용자 지정 OpenAI 호환 주소를 지원하는 플러그인을 선택”하는 것을 더 안정적인 메인 경로로 삼아야 합니다.

​
권장 설정 형식

플러그인마다 필드명이 다를 수 있지만, 처음에는 아래와 같은 방식으로 입력하는 것을 권장합니다:
플러그인에서 “기본 주소”를 입력하도록 요구한다면 https://api.crazyrouter.com/v1을 우선 입력하십시오. 플러그인이 “완전한 채팅 인터페이스 주소”를 명확히 요구하는 경우에만 https://api.crazyrouter.com/v1/chat/completions를 입력하십시오.

​
설정 단계

1

1단계: Zotero 전용 Crazyrouter 토큰 생성

처음에는 다음만 허용하는 것을 권장합니다:
  • gpt-5.5
  • claude-opus-4-8
처음부터 많은 모델을 한꺼번에 개방하지 마십시오. 이렇게 하면 문제 해결이 더 쉬워집니다.
2

2단계: Zotero 데스크톱 버전 설치

사용 중인 시스템에 맞춰 Zotero를 설치하고, 논문 항목을 정상적으로 가져오거나 볼 수 있는지 확인합니다.
3

3단계: AI 플러그인 다운로드 및 설치

Zotero 공식 플러그인 설치 문서에 따라, 먼저 플러그인의 .xpi 파일을 다운로드한 다음 Zotero에서:
  • Tools를 엽니다
  • Plugins로 이동합니다
  • .xpi 파일을 플러그인 창으로 드래그합니다
완료 후 Zotero를 재시작합니다.
4

4단계: 플러그인 설정으로 진입

일반적인 진입 경로는 다음과 같습니다:
  • Edit → Preferences
  • 플러그인 자체의 환경설정 페이지
  • 플러그인 사이드바 또는 툴바 진입점
플러그인마다 위치가 다를 수 있지만, 핵심은 API와 모델 설정 영역을 찾는 것입니다.
5

5단계: Crazyrouter 주소, 키, 모델 입력

플러그인이 기본 주소 모드를 지원한다면 다음과 같이 입력하는 것을 권장합니다:
  • Base API URL: https://api.crazyrouter.com/v1
  • API Key: sk-xxx
  • Model: gpt-5.5
플러그인이 완전한 인터페이스 주소만 지원한다면 대신 다음을 입력합니다:
  • Endpoint: https://api.crazyrouter.com/v1/chat/completions
6

6단계: 플러그인이 요구하면 Zotero 재시작

일부 플러그인은 API 키, 모델, 또는 환경설정을 수정한 후 Zotero를 재시작해야 적용됩니다. 첫 설정을 완료한 후에는 한 번 재시작하는 것을 권장합니다.
7

7단계: 최소 학술 시나리오로 첫 라운드 검증

처음부터 복잡한 리뷰 작업을 하지 마십시오. 처음에는 다음만 권장합니다:
  • 요약이 있는 문헌 하나를 선택합니다
  • 또는 비교적 작은 PDF 하나를 엽니다
  • 요약 / 번역 / 간단한 질의응답을 한 번 실행합니다
테스트 프롬프트는 다음을 사용할 수 있습니다:

​
권장 검증 순서

다음 순서로 진행하는 것을 권장합니다:
  1. 먼저 Zotero 본체와 플러그인이 모두 정상적으로 열리는지 확인합니다
  2. 먼저 gpt-5.5를 검증합니다
  3. 먼저 단일 문헌 요약을 수행합니다
  4. 그다음 번역을 수행합니다
  5. 그다음 여러 문헌 비교, 장문 분석 또는 대량 작업을 수행합니다

​
권장 모델

​
Zotero에 적합한 사용 방식

​
단일 논문 요약

첫 라운드 검증으로 가장 적합합니다. 컨텍스트가 단순하고 결과를 판단하기 쉽기 때문입니다.

​
PDF 번역

먼저 한 페이지 또는 짧은 단락으로 테스트한 후, 점진적으로 범위를 확대하는 것을 권장합니다.

​
여러 문헌 비교

첫 단계로는 권장하지 않습니다. 단일 문헌 요약과 번역이 이미 안정화된 후에, 여러 문헌 비교, 리뷰 개요, 연구 공백 추출 등 더 복잡한 작업을 시도하십시오.

​
노트 정리

플러그인이 결과를 Zotero 노트에 다시 작성하는 것을 지원한다면, 먼저 짧은 요약부터 시작하고 처음부터 대량으로 긴 노트를 생성하지 마십시오.

​
토큰 모범 사례

​
검증 체크리스트

  • Zotero 데스크톱 버전을 설치했습니다
  • 사용자 지정 OpenAI 호환 주소를 지원하는 AI 플러그인을 설치했습니다
  • Zotero 전용 Crazyrouter 토큰을 생성했습니다
  • 기본 주소를 https://api.crazyrouter.com/v1 또는 완전한 인터페이스 주소로 입력했습니다
  • sk-xxx를 올바르게 입력했습니다
  • 먼저 gpt-5.5만 설정했습니다
  • 설정 변경 후 필요에 따라 Zotero를 재시작했습니다
  • 단일 문헌 요약 또는 단일 번역 검증을 완료했습니다
  • Crazyrouter 백엔드 로그에서 해당 요청을 확인할 수 있습니다

​
자주 발생하는 오류와 해결 방법

​
FAQ

​
Zotero에서 Crazyrouter를 직접 설정할 수 있나요?

일반적으로 Zotero 본체에서 직접 설정하는 것이 아니라, OpenAI 호환 인터페이스를 지원하는 AI 플러그인을 통해 설정합니다.

​
어떤 유형의 플러그인이 Crazyrouter 연동에 가장 적합한가요?

Base API URL, API URL 또는 Endpoint 사용자 지정을 지원하는 플러그인을 우선 선택하십시오.

​
플러그인이 OpenAI API 키만 입력할 수 있다면 어떻게 하나요?

이런 유형의 플러그인은 일반적으로 Crazyrouter 업스트림으로 직접 변경할 수 없으며, 공개 기본 방안으로 적합하지 않습니다. 사용자 지정 주소를 지원하는 플러그인으로 교체하는 것을 권장합니다.

​
기본 주소는 무엇을 입력해야 하나요?

https://api.crazyrouter.com/v1을 우선 입력하십시오.

​
첫 번째 모델은 무엇을 입력해야 하나요?

먼저 gpt-5.5를 입력하십시오.

​
여러 문헌 분석이나 복잡한 리뷰는 언제 시도해야 하나요?

단일 문헌 요약과 단일 번역이 이미 안정화된 후에, 작업 복잡도를 점진적으로 높여가십시오.
목표가 “먼저 Zotero에서 Crazyrouter를 정상적으로 작동시키는 것”이라면, 가장 중요한 것은 처음부터 가장 강력한 플러그인을 추구하는 것이 아니라, 먼저 선택한 플러그인이 실제로 사용자 지정 OpenAI 호환 주소를 지원하는지 확인한 다음 gpt-5.5로 단일 문헌 요약을 정상적으로 작동시키는 것입니다.