Cài đặt

Yêu cầu

• Node.js 20.11+ (native ESM)
• Một API key dịch thuật (xem bên dưới)

Cài đặt

npm

npm install --save-dev champollion

npx (no install)

npx champollion sync

pnpm

pnpm add -D champollion

yarn

yarn add --dev champollion

Lấy API Key

Champollion cần một backend dịch thuật. Hãy chọn một trong các nhà cung cấp sau:

Nhà cung cấp	Biến môi trường	Phù hợp nhất cho
OpenRouter (khuyên dùng)	OPENROUTER_API_KEY	Các dự án nhiều nội dung, Markdown, hơn 200 mô hình
Gemini (gói miễn phí)	GEMINI_API_KEY	Bắt đầu với chi phí bằng 0, chất lượng tốt
OpenAI	OPENAI_API_KEY	Truy cập trực tiếp GPT-4o
Anthropic	ANTHROPIC_API_KEY	Truy cập trực tiếp Claude, văn bản sắc thái tinh tế
DeepL	DEEPL_API_KEY	Các ngôn ngữ châu Âu, tích hợp sẵn mức độ trang trọng
Google Translate	GOOGLE_TRANSLATE_API_KEY	Các cặp key-value số lượng lớn, hơn 130 ngôn ngữ
Microsoft Translator	MICROSOFT_TRANSLATOR_API_KEY	Azure, hơn 100 ngôn ngữ
LibreTranslate	LIBRETRANSLATE_API_URL	Tự host (self-hosted), ưu tiên quyền riêng tư

OpenRouter (recommended)

OpenRouter cung cấp một API hợp nhất cho hơn 200 mô hình LLM. Có sẵn gói miễn phí.

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

Hoặc thêm vào .env.local:

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

Phù hợp nhất cho: các dự án nhiều nội dung, dịch thuật Markdown, và các dự án cần bảo vệ nội dung đặc biệt (khối mã, shortcode, biến nội suy).

Google Translate

export GOOGLE_TRANSLATE_API_KEY=...

Phù hợp nhất cho: các cặp chuỗi key-value số lượng lớn (hơn 130 ngôn ngữ). Không khuyên dùng cho nội dung Markdown — Google Translate không thể nhận biết các khối mã, shortcode hoặc biến nội suy.

:::tip Phát hiện thông minh Nếu chỉ có GOOGLE_TRANSLATE_API_KEY được thiết lập (không có key OpenRouter), champollion sẽ tự động chuyển sang Google Translate. Không cần thay đổi cấu hình. :::

Xác minh cài đặt

npx champollion --help

Bạn sẽ thấy danh sách các lệnh có sẵn. Bạn đã sẵn sàng cho phần Bắt đầu nhanh.