이 페이지는 영어 문서의 번역입니다. 명령, 식별자, 예제는 그대로입니다. 런타임 7.24.4 · SDK 2.6.7. 영어 원문

TUI 언어와 처음 설정

상태: 활성

범위: 현재 상태

최종 검토: 2026-09-14

담당: ax-code 런타임

AX Code TUI는 영어(en), 번체 중국어(zh-TW), 간체 중국어(zh-CN), 일본어(ja), 한국어(ko), 스페인어(es), 브라질 포르투갈어(pt-BR), 프랑스어(fr), 독일어(de), 러시아어(ru), 인도네시아어(id), 터키어(tr), 베트남어(vi), 이탈리아어(it)를 지원합니다. 현지화된 화면에는 설정, 탐색, 자주 쓰는 명령, 키보드 도움말, 프롬프트 조작, 공급자 선택, 권한 결정, 세션 대화 상자, 런타임 상태, Council/Arena 표시가 포함됩니다.

/language(별칭 /lang)를 실행하면 인터페이스 언어와 대화 언어를 따로 고릅니다. 언어 선택기는 각 언어를 그 언어의 문자로 보여 줍니다. 인터페이스 변경은 바로 적용됩니다. 대화 변경은 이후 프롬프트와 모델을 쓰는 슬래시 명령에 적용되며, Council과 Arena 요청도 포함됩니다. Auto은 기존 대화 동작을 유지합니다. 사용자가 명시한 지시와 프로젝트 규칙이 이 설정보다 우선합니다. 셸 명령은 바꾸지 않고 그대로 보냅니다.

원래 사용자 메시지는 보존됩니다. 대화 설정은 따로 전달되며, AX Code는 실행 전에 작업을 번역하지 않습니다. 코드 주석, 커밋, 문서는 프로젝트 규칙을 따르며, 대화 언어를 명시하면 기본으로 영어를 요청합니다. 기술 식별자, 경로, 명령, 가공하지 않은 도구 출력, 인용된 증거는 바꾸지 않습니다.

처음 설정

공급자나 세션이 구성되지 않은 새 대화형 설치는 초기화 뒤에 빠른 설정을 제안합니다.

인터페이스 언어를 고릅니다. 열네 개 언어가 함께 나오며, 짧은 터미널에서는 화살표 키로 목록을 스크롤합니다.
기존 연결 대화 상자로 공급자를 연결하고 모델을 고릅니다. 설치된 코딩 CLI, 클라우드 API, 로컬 런타임, 프라이빗 GPU 엔드포인트, AX Trust 게이트웨이 중에서 맞는 것을 고릅니다.
작업을 시작합니다. 읽기 전용 검토는 첫 작업으로 적합합니다. 승인하기 전에 명령과 그 범위를 확인합니다.

설정을 건너뛰었다가 /setup로 다시 열 수 있습니다. 공급자 설정을 취소하면 점검 목록으로 돌아갑니다. 이미 구성된 사용자, 다시 연 세션, 명시적인 --prompt 실행은 중단되지 않습니다. 불러오기 오류와 연결 오류는 구성되지 않은 설치와 구분됩니다. 모델을 고르면 구성 준비가 된 것으로 봅니다. 첫 요청이 실제 연결을 확인합니다. 설정은 권한을 부여하거나, 런타임을 설치하거나, 모델을 자동으로 내려받지 않습니다.

구성

선택적 기본값은 tui.json에 두며, 런타임의 이전 language 설정에는 두지 않습니다.

{
  "interface_language": "zh-TW",
  "conversation_language": "ja"
}

인터페이스 값: en, zh-TW, zh-CN, ja, ko, es, pt-BR, fr, de, ru, id, tr, vi, it. 대화에는 auto도 쓸 수 있습니다. 기본값은 en과 auto입니다. /language로 고른 값은 로컬 TUI 상태에 저장되며 이 파일 기본값보다 우선합니다. 다시 바꾸려면 /language를 사용합니다. 언어 선택은 자격 증명이나 서버 정책을 바꾸지 않습니다.

Council/Arena 현지화는 표시 이름만 바꿉니다. 구성원의 증거, 지지 수, 순위, 검증 상태, 원문 오류는 그대로입니다. 공급자가 제공하는 권한 문구, 특수 도구 출력, 특수 진단 화면은 원래 언어로 나올 수 있습니다. 가공하지 않은 도구 출력, 기술 식별자, 사용자 내용, 문서는 번역하지 않습니다.

기여자는 pnpm --dir packages/ax-code run check:tui-locales으로 전체 카탈로그, 자리 표시자, NFC 정규화, 검토된 공통 표기, 핵심 메뉴 소스 가드, 언어를 바꾸는 동안의 네이티브 대화 상자 렌더링을 검증합니다. 언어마다 따로 검토한 카탈로그를 유지합니다. 문자 변환만으로 번체 중국어를 만들지 마십시오.

베트남어 카탈로그는 NFC를 사용합니다. 표시를 자를 때는 분해된 입력을 포함해 자소 클러스터를 보존합니다. 네이티브 렌더링 검사는 36열과 80열 터미널을 다룹니다. 모호한 너비의 문자를 두 칸으로 그리도록 설정된 터미널은 터미널별 검증이 따로 필요합니다. 현재 렌더러는 모호한 넓은 문자 시험 모드를 제공하지 않습니다.