CLI 옵션

사용법

yaku [옵션] [텍스트]

텍스트는 위치 인수, -f(파일), stdin 파이프로 제공할 수 있습니다. 자세한 내용은 입력 & 출력을 참조하세요.

옵션	타입	기본값	설명
`--to`	`string`	설정 `default-target`	필수. 대상 언어 코드 (예: `zh-TW`, `ja`, `ko`).
`--from`	`string`	자동 감지	소스 언어 코드. 생략하면 LLM이 자동 감지합니다.
`--mode`	`string`	`translate`	`translate` — 대상 언어로 번역. `polish` — 이미 대상 언어로 작성된 글 다듬기. 다듬기 모드 참조.
`--context`	`string`		LLM을 위한 도메인 힌트 (예: `"Kubernetes 문서"`, `"격식 있는 이메일"`). 모호한 용어를 해소합니다.

옵션	약자	타입	기본값	설명
`--file`	`-f`	`string[]`		입력 파일 경로. 여러 파일은 반복: `-f a.md -f b.md`.
`--output`	`-o`	`string`	stdout	번역된 텍스트를 stdout 대신 파일에 씁니다.
`--format`		`string`	자동 감지	입력 포맷 강제: `text`, `md`, `json`, `yaml`. 생략 시 `-f` 파일 확장자에서 자동 감지.

옵션	타입	기본값	설명
`--backend`	`string`	`hosted`	LLM 백엔드: `hosted`, `gemini`, `openai`, `anthropic`. 백엔드 참조.
`--model`	`string`	`backend` 기본값	모델명 재정의 (예: `gemini-2.5-flash`, `gpt-4o`, `claude-sonnet-4-5-20250514`).
`--api-base`	`string`		모든 로컬 백엔드의 API 베이스 URL 오버라이드 (예: `https://api.groq.com/openai/v1`). OpenAI 호환 제공자에서 주로 사용.

옵션	타입	기본값	설명
`--glossary`	`string`	자동 감지	용어집 YAML 파일 경로. 자동 감지를 재정의합니다. 용어집 참조.
`--no-glossary`	`bool`	`false`	기본 위치에 용어집 파일이 있더라도 용어집 로드를 완전히 건너뜁니다.

옵션	타입	기본값	설명
`--prompt`	`string`	내장	커스텀 시스템 프롬프트 파일 경로. 전체 내장 프롬프트를 대체합니다. 커스텀 프롬프트 참조.

옵션	타입	기본값	설명
`--verbose`	`bool`	`false`	번역 후 모델명, 토큰 수, 경과 시간을 stderr에 출력합니다.

--verbose 출력 예제 (stderr):

Model: gemini-2.5-flash | Tokens: 42 in / 38 out | Time: 1.2s

~/.config/yaku/config.yaml의 설정 파일을 관리합니다.

사용 가능한 모든 키는 설정을 참조하세요.

브라우저 기반 기기 인증 플로로 호스팅 서비스에 인증합니다. 미리 입력된 인증 코드와 함께 브라우저가 열립니다. 로그인하고 승인을 클릭하면 됩니다. 자격 증명은 ~/.config/yaku/.credentials에 저장됩니다.

yaku login
# 브라우저가 열려 인증을 완료합니다

서버에서 세션을 취소하고 로컬 자격 증명을 삭제합니다. 서버에 연결할 수 없으면 자격 증명이 유지되므로 재시도할 수 있습니다.

yaku logout

# 서버 취소가 실패해도 로컬 자격 증명을 강제 삭제
yaku logout --force

옵션	설명
`--force`	서버가 취소를 확인했는지 여부에 관계없이 로컬 자격 증명을 삭제합니다. 세션은 만료될 때까지 서버에서 유효할 수 있습니다.

호스팅 서비스에 조회하여 현재 인증 상태를 표시합니다.

yaku whoami
# Logged in as Jane Doe ([email protected], github)

로그인하지 않은 경우:

Not logged in (using anonymous quota)

세션이 만료되었거나 유효하지 않은 경우:

Session expired or invalid. Run yaku login to re-authenticate.

서버에 연결할 수 없는 경우:

hosted service unreachable. Check your network connection

호스팅 서비스의 현재 사용량 할당량을 표시합니다. 플랜 등급, 일일 및 월간 요청 수, 요청당 글자 수 제한을 표시합니다. 로컬 백엔드 사용 시 할당량이 적용되지 않음을 보고합니다.

플랜 등급과 제한은 호스팅 서비스 & 플랜을 참조하세요.

CLI 버전을 출력합니다.

yaku version
# yaku v0.1.0