설정

설정 파일

yaku는 YAML 파일에 설정을 저장합니다. 다음으로 위치를 확인합니다:

yaku config path

처음 yaku config set을 실행하면 파일이 자동으로 생성됩니다. 직접 편집할 수도 있습니다. yaku는 주석과 서식을 보존합니다.

모든 설정 필드

필드	타입	기본값	설명
`api-key`	`string`		로컬 백엔드(Gemini, OpenAI, Anthropic)용 LLM API 키.
`default-target`	`string`		기본 대상 언어. `--to`를 생략할 수 있습니다.
`backend`	`string`	`hosted`	LLM 백엔드: `hosted`, `gemini`, `openai`, `anthropic`. 설정 시 검증됨.
`model`	`string`	`backend` 기본값	모델명 재정의 (예: `gemini-2.5-flash`, `gpt-4o-mini`).
`api-base`	`string`		모든 로컬 백엔드의 API 베이스 URL 오버라이드. OpenAI 호환 제공자에서 주로 사용.
`hosted-url`	`string`	`https://api.yakulang.com`	호스팅 서비스 API 엔드포인트. 인증 엔드포인트는 자동으로 유도됩니다(`api.` 접두사 제거).
`prompt`	`string`		커스텀 시스템 프롬프트 파일 경로. 모든 번역에 적용됩니다.

설정 파일 예제

api-key: AIzaSy...your-gemini-key
default-target: ko
backend: gemini
model: gemini-2.5-flash

설정 관리

# 값 설정
yaku config set default-target ko

# 값 읽기 (파일만, 환경 변수 무시)
yaku config get default-target

# 설정 파일 위치 확인
yaku config path

환경 변수

환경 변수는 설정 파일 값을 재정의합니다. CI/CD, 컨테이너, 프로젝트 간 전환에 유용합니다.

변수	재정의하는 설정 필드	예제
`YAKU_API_KEY`	`api-key`	`export YAKU_API_KEY=AIza...`
`YAKU_DEFAULT_TARGET`	`default-target`	`export YAKU_DEFAULT_TARGET=ko`
`YAKU_BACKEND`	`backend`	`export YAKU_BACKEND=openai`
`YAKU_MODEL`	`model`	`export YAKU_MODEL=gpt-4o`
`YAKU_API_BASE`	`api-base`	`export YAKU_API_BASE=https://api.groq.com/openai/v1`
`YAKU_HOSTED_URL`	`hosted-url`	`export YAKU_HOSTED_URL=https://api.staging.yakulang.com`

환경 변수 재정의 동작

YAKU_* 환경 변수가 설정되면 — 빈 문자열이라도 — 해당 설정 파일 값을 재정의합니다. 키 소스가 실패할 때 조용한 폴백을 방지합니다:

# 명시적으로 비어 있음 → 설정 파일 재정의, 키가 빈 값
YAKU_API_KEY="" yaku --backend gemini --to ko "test"
# Error: YAKU_API_KEY is set but empty (check your key source).

백엔드별 API 키 폴백

YAKU_API_KEY가 전혀 설정되지 않고(빈 문자열도 아님) 설정 파일에 api-key도 없으면, yaku는 해결된 백엔드(—backend 옵션 포함)에 따라 다음 백엔드별 환경 변수를 확인합니다:

백엔드	폴백 변수
`gemini`	`GOOGLE_API_KEY`
`openai`	`OPENAI_API_KEY`
`anthropic`	`ANTHROPIC_API_KEY`

다른 도구(예: Google Cloud SDK 또는 OpenAI CLI)의 기존 환경 변수를 추가 설정 없이 사용할 수 있습니다. --backend와 결합하면 설정을 변경하지 않고 제공자 간 전환이 가능합니다:

export GOOGLE_API_KEY=your-gemini-key
export OPENAI_API_KEY=your-openai-key
yaku --backend gemini --to ko "Hello"
yaku --backend openai --to ko "Hello"

우선순위

같은 설정이 여러 곳에 지정되면 가장 높은 우선순위의 소스가 적용됩니다:

명령줄 옵션 (최고) — 예: --to ja
환경 변수 — 예: YAKU_DEFAULT_TARGET=ja
설정 파일 — ~/.config/yaku/config.yaml
내장 기본값 (최저)

예제: 설정 파일에 default-target: ko가 있지만 yaku --to ja를 실행하면 대상 언어는 ja입니다.

오류 처리

설정 파일 없음: yaku가 내장 기본값을 사용합니다. 오류 없음.
YAML 구문 오류: yaku가 stderr에 경고를 출력하고 기본값으로 계속합니다.
알 수 없는 설정 키: yaku config set이 위 목록에 없는 키를 거부합니다.
유효하지 않은 설정 값: yaku config set이 값을 검증합니다. backend는 hosted, gemini, openai, anthropic 중 하나여야 합니다. default-target 필드는 유효한 BCP 47 언어 코드여야 합니다.