설치

요구 사항

• Node.js 20.11+ (네이티브 ESM)
• 번역 API 키 (아래 참조)

설치

npm

npm install --save-dev champollion

npx (no install)

npx champollion sync

pnpm

pnpm add -D champollion

yarn

yarn add --dev champollion

API 키 발급받기

Champollion에는 번역 백엔드가 필요해요. 다음 중 하나를 선택하세요:

제공업체	환경 변수	적합한 용도
OpenRouter (권장)	OPENROUTER_API_KEY	콘텐츠가 많은 프로젝트, Markdown, 200개 이상의 모델
Gemini (무료 등급)	GEMINI_API_KEY	무료로 시작, 우수한 품질
OpenAI	OPENAI_API_KEY	GPT-4o 직접 액세스
Anthropic	ANTHROPIC_API_KEY	Claude 직접 액세스, 미묘한 뉘앙스의 텍스트
DeepL	DEEPL_API_KEY	유럽 언어, 내장된 격식 수준
Google Translate	GOOGLE_TRANSLATE_API_KEY	대량의 키-값 쌍, 130개 이상의 언어
Microsoft Translator	MICROSOFT_TRANSLATOR_API_KEY	Azure, 100개 이상의 언어
LibreTranslate	LIBRETRANSLATE_API_URL	자체 호스팅, 프라이버시 우선

OpenRouter (recommended)

OpenRouter는 200개 이상의 LLM 모델에 대한 통합 API를 제공해요. 무료 등급도 사용할 수 있어요.

# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...

또는 .env.local에 추가하세요:

OPENROUTER_API_KEY=sk-or-v1-your-key-here

적합한 용도: 콘텐츠가 많은 프로젝트, Markdown 번역, 그리고 콘텐츠 인식 보호(코드 블록, 숏코드, 보간 변수)가 필요한 프로젝트.

Google Translate

export GOOGLE_TRANSLATE_API_KEY=...

적합한 용도: 대량의 키-값 문자열 쌍(130개 이상의 언어). Markdown 콘텐츠에는 권장하지 않아요 — Google Translate는 코드 블록, 숏코드, 보간 변수를 인식하지 못해요.

:::tip 스마트 감지 GOOGLE_TRANSLATE_API_KEY만 설정되어 있고 OpenRouter 키가 없으면, champollion이 자동으로 Google Translate로 전환해요. 설정을 변경할 필요가 없어요. :::

설치 확인

npx champollion --help

사용 가능한 명령어 목록이 표시될 거예요. 이제 빠른 시작을 진행할 준비가 되었어요.