# 탭으로 번역 — Liu Terminal

> Liu Terminal Translate-on-Tab. 토큰을 절약하기 위해 코딩 에이전트에 전송하기 전에 프롬프트 라인 입력을 실시간으로 번역합니다.

URL: https://liu.software/ko/docs/translate/  
Language: ko  
Updated: 2026-10-17

## Translate-on-Tab

비영어권 프롬프트 텍스트를 코딩 에이전트에 전송하기 전에 사용자의 컴퓨터에서 영어(또는 다른 대상 언어)로 번역하여 토큰 사용량을 줄이고 에이전트의 정확도를 높입니다.

## 실행 방법

Liu가 지원되는 에이전트와 연관되어 있다고 감지한 터미널 프롬프트에서 입력하는 동안, translate\_tab\_window\_sec (기본값 0.4초) 내에 Ctrl 키와 Cmd 키를 동시에 두 번 누릅니다. Liu는 이 키 입력을 가로채서 현재 프롬프트 행을 번역하고 (코드/텍스트 혼합 세그먼트 인식), 엔터를 치기 전에 해당 행을 번역 결과로 대체합니다.

**키 입력:** Ctrl+Cmd를 두 번 누릅니다 (Tab 단독 입력이 아닙니다). Cmd+K → Toggle Translate, Translate: Cycle Target Language, Translate: Cycle Backend 또는 Settings: Translate를 통해 토글하거나 재설정할 수 있습니다.

## 백엔드

translate\_backend는 정수형 열거형(enum)입니다 (src/translate/translate.h):

- **0 — Agent** — 지정된 프롬프트 템플릿을 사용하여 번역을 진행하도록 일회성 CLI 에이전트(claude / codex / opencode / grok)를 실행합니다.
- **1 — Local LLM** — 기본값. USE\_LOCAL\_LLM이 내장 컴파일된 경우 Metal 가속화된 로컬 GGUF 모델을 사용하며, 완전히 오프라인으로 작동합니다.
- **2 — API** — 클라우드 제공업체: anthropic, openai, openrouter 또는 사용자 지정 OpenAI 호환 베이스 URL. api\_key 값이 비어있을 경우 ANTHROPIC\_API\_KEY / OPENAI\_API\_KEY / 등 환경 변수를 사용합니다.

## 활성 에이전트

번역은 선택된 에이전트와 연결된 프롬프트에서만 실행됩니다. 기본적으로 Claude, Codex, OpenCode, Grok, Antigravity, Cline 및 Command Code가 활성화됩니다(모든 translate\_active\_in\_\* 플래그가 true). 설정 → Translate 또는 config.json에서 구성합니다.

## 구성 키

~/.config/Liu/config.json 파일의 설정값 (기본값은 translate\_config\_default에 정의됨):

```
{
  "translate_enabled": true,
  "translate_backend": 1,
  "translate_source_lang": "Turkish",
  "translate_target_lang": "English",
  "translate_tab_window_sec": 0.4,
  "translate_active_in_claude": true,
  "translate_active_in_codex": true,
  "translate_active_in_opencode": true,
  "translate_active_in_grok": true,
  "translate_active_in_antigravity": true,
  "translate_active_in_cline": true,
  "translate_active_in_commandcode": true
}
```

번역이 진행되는 동안 로딩 표시기가 나타납니다. 로컬 백엔드를 선택한 경우 설정에서 로컬 모델 다운로드 및 경로 관리를 처리할 수 있습니다.

[다음 설정 →](https://liu.software/ko/docs/config.md)