FAQ

yaku란 무엇인가요?

yaku(訳, 일본어로 “번역”)는 터미널에서 텍스트, 파일, 개발 출력물을 번역하는 CLI 도구입니다. stdin, 파일 또는 인수로 입력을 받아 번역된 텍스트를 stdout으로 출력합니다. jq나 sed처럼 동작하지만, 자연어를 대상으로 합니다.

yaku는 다른 번역 도구와 어떻게 다른가요?

왜 yaku인가?에서 Google 번역, 범용 AI CLI(llm, sgpt, aichat), Translate Shell과의 상세 비교를 확인할 수 있습니다.

yaku는 무료인가요?

CLI는 오픈 소스(BSD 3-Clause 라이선스)이며 자체 API 키로 무료로 사용할 수 있습니다. api.yakulang.com의 호스팅 서비스는 설정 없이 작동하며 무료 플랜이 포함되어 있습니다. 플랜 세부 사항과 할당량 제한은 호스팅 서비스 & 플랜을 참조하세요.

yaku는 어떤 LLM을 지원하나요?

네 가지 백엔드를 지원합니다:

백엔드	기본 모델	사용 방법
Hosted (api.yakulang.com)	서버 측	기본값 — 설정 없이 작동
Google Gemini	gemini-2.5-flash	yaku config set backend gemini
OpenAI	gpt-4o-mini	yaku config set backend openai
Anthropic	claude-haiku-4-5-20251001	yaku config set backend anthropic

OpenAI 백엔드는 OpenAI 호환 API(Groq, Together.ai, DeepSeek, Ollama)에서도 작동합니다. 백엔드를 참조하세요.

yaku는 어떤 언어를 지원하나요?

선택한 LLM 백엔드가 번역할 수 있는 모든 언어를 지원합니다. yaku는 하드코딩된 언어 목록을 유지하지 않으며, 언어 코드를 모델에 직접 전달합니다. 언어를 참조하세요.

yaku가 내 텍스트를 저장하나요?

로컬 백엔드(Gemini, OpenAI, Anthropic): yaku는 텍스트를 LLM API로 직접 보내고 결과를 반환합니다. yaku가 저장하는 것은 없습니다. 데이터 처리에 대해서는 LLM 제공자의 개인정보 처리방침을 확인하세요.

호스팅 백엔드: 텍스트는 번역을 위해 api.yakulang.com으로 전송됩니다. 호스팅 서비스는 응답이 반환된 후 텍스트를 보존하지 않습니다.

yaku를 오프라인에서 사용할 수 있나요?

네, OpenAI 호환 백엔드를 통해 로컬 모델을 사용할 수 있습니다. 예를 들어 Ollama를 사용하면:

yaku --backend openai \
  --api-base http://localhost:11434/v1 \
  --model llama3 \
  --to ko "Bonjour"

백엔드 — OpenAI 호환 제공자를 참조하세요.

일관된 용어를 어떻게 보장하나요?

용어집 파일을 사용합니다. 프로젝트 루트에 .yaku-glossary.yaml을 생성하세요:

ko:
  Kubernetes: ~     # 영어 유지
  container: 컨테이너   # 항상 이렇게 번역

yaku가 자동으로 파일을 로드하고 모든 번역 프롬프트에 용어를 주입합니다.

나만의 LLM 프롬프트를 사용할 수 있나요?

네, 로컬 백엔드에서 가능합니다. --prompt 옵션은 yaku의 내장 시스템 프롬프트를 완전히 대체합니다:

yaku --to ko --prompt my-prompt.txt -f docs.en.md

커스텀 프롬프트는 로컬 백엔드(Gemini, OpenAI, Anthropic)에서만 작동합니다. 호스팅 백엔드는 서버 측 프롬프트를 사용하며 --prompt를 무시합니다. 커스텀 프롬프트를 참조하세요.

버그는 어떻게 신고하나요?

yaku 버전(yaku version), 실행한 명령어, 오류 메시지를 포함하여 이슈를 열어 주세요.