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

터미널 렌더링

상태: 현재 범위: TUI 터미널 프로필 선택, 덮어쓰기, 시각 능력의 경계 최종 검토: 2026-10-03 담당: AX Code TUI 유지관리자

AX Code는 시작할 때 환경에서 터미널 프로필을 고릅니다. 프로필은 터미널 설정을 제어하며, 모니터 해상도나 글꼴 선명도는 제어하지 않습니다.

터미널 환경	자동 프로필	식별
Ubuntu를 포함한 WSL의 Windows Terminal	고급	비어 있지 않은 `WT_SESSION`, 충돌하는 `TERM_PROGRAM` 없음
GNOME Terminal과 그 밖의 VTE 호스트	고급	양의 십진수 `VTE_VERSION`, `TERM=xterm` 또는 `xterm-256color`, 그리고 충돌하는 `TERM_PROGRAM` 없음
Ghostty	고급	`TERM_PROGRAM=ghostty` 또는 `TERM=xterm-ghostty`
macOS Terminal.app	호환	`TERM_PROGRAM=Apple_Terminal`
알 수 없는 터미널, SSH/mosh, tmux, screen, Zellij	호환	보수적인 폴백

명시적인 TERM_PROGRAM는 상속된 바깥 터미널 표식보다 우선합니다. dumb, linux, vt100 같은 제한된 터미널 유형도 호환 모드로 남습니다. Ubuntu나 WSL이라는 신원만으로는 고급 프로필이 켜지지 않습니다.

고급 프로필은 대체 화면, 네이티브 렌더링 스레드, 터미널 능력 감지를 사용합니다. 호환 프로필은 네이티브 렌더링 스레드 없이 주 화면을 사용합니다. 둘 다 마우스 상호작용(마우스 캡처 참조)과 키보드 프로토콜 협상을 켜고, 60 FPS를 목표로 합니다. 실제 프레임 속도는 작업량과 터미널에 따라 다릅니다.

Windows Terminal은 직접 세션이 식별되면 어느 프로필에서든 24비트 시각 효과를 유지합니다. 색 지원이 픽셀 그래픽이나 Nerd Font 지원을 뜻하지는 않습니다. 고급 모드는 글꼴, 글꼴 크기, 디스플레이 배율을 바꾸지 않습니다.

마우스 캡처

AX Code는 기본적으로 터미널 마우스 입력을 캡처하므로, TUI 안의 컨트롤을 클릭할 수 있습니다. 바닥글 단축 칩(빠른 모델, 자율, 샌드박스), 대화 상자와 자동 완성 옵션, 클릭하여 포커스, 드래그 선택, TUI 안의 휠 스크롤이 해당합니다. 캡처가 켜져 있으면 터미널이 실행 중인 프로그램에 마우스를 넘기므로, 터미널 자체의 오른쪽 클릭 메뉴와 네이티브 텍스트 선택은 보이지 않습니다. 많은 터미널은 수정 키로 여전히 그 기능을 보여 줍니다. 보통 Shift와 오른쪽 클릭이고, 때로는 Option이나 Alt입니다. 터미널과, 그 사이에 tmux, screen, Zellij가 있는지에 따라 다릅니다.

마우스를 터미널에 되돌리려면 mouse을 false로, tui.json 안에 설정합니다.

{
  "mouse": false
}

AX_CODE_DISABLE_MOUSE=1는 tui.json과 관계없이 캡처를 끕니다. 프로젝트 수준의 tui.json 파일은 신뢰하지 않는 입력이므로 이 변수가 있습니다. 저장소가 사용자의 뜻에 반해 터미널 자체의 마우스 동작을 계속 억제할 수 있으면 안 됩니다. 이 변수는 캡처를 끄기만 하며, 강제로 켤 수는 없습니다.

제외는 순수한 이득이 아니라 교환입니다.

되찾는 것: 터미널의 네이티브 오른쪽 클릭 메뉴, 네이티브 텍스트 선택, 복사와 붙여넣기. 호환 프로필에서는 터미널 자신의 스크롤백이 휠을 처리합니다.
잃는 것: 바닥글 단축 칩, 클릭하여 포커스, 클릭 가능한 대화 상자와 자동 완성 옵션, 드래그 선택, 그리고 터미널 스크롤백이 없는 고급(대체 화면) 프로필에서의 TUI 안 휠 스크롤. 그 동작에는 키보드 제어가 남아 있습니다.

캡처가 켜져 있는 동안 오른쪽 클릭은 터미널 메뉴 대신 TUI 자신의 컨텍스트 메뉴를 엽니다. 클릭 위치에 작은 복사 / 붙여넣기 메뉴입니다. 화면에 선택이 있으면 복사가 켜지고, 텍스트 입력이 포커스되어 있으면 붙여넣기가 켜집니다. 프롬프트와 대화 상자 안의 입력도 포함됩니다. 메뉴는 Escape, 아무 키 입력, 스크롤, 또는 메뉴 밖 클릭으로 닫힙니다. 캡처가 꺼지면 클릭은 터미널이 처리합니다.

프로필 덮어쓰기

고급 모드를 요청하려면 AX_CODE_TUI_ADVANCED_TERMINAL=1를, 호환 모드를 요청하려면 0을 설정합니다. 명시적 덮어쓰기는 원격 세션과 다중화된 세션을 포함하여 자동 감지보다 우선합니다. 변수를 제거하면 자동 선택이 돌아옵니다. true/false, yes/no, on/off도 받습니다.

현재 셸과 그 자식 프로세스에 대해 PowerShell에서 다음을 사용합니다.

$env:AX_CODE_TUI_ADVANCED_TERMINAL = "1"
ax-code

# Use compatible mode if startup or rendering has problems.
$env:AX_CODE_TUI_ADVANCED_TERMINAL = "0"
ax-code

# Restore automatic selection.
Remove-Item Env:AX_CODE_TUI_ADVANCED_TERMINAL -ErrorAction SilentlyContinue

한 번의 실행에 대해 Bash 또는 Zsh에서 다음을 사용합니다.

AX_CODE_TUI_ADVANCED_TERMINAL=1 ax-code
AX_CODE_TUI_ADVANCED_TERMINAL=0 ax-code

셸 시작 파일이 이 변수를 export하면 그 export를 제거하고 unset AX_CODE_TUI_ADVANCED_TERMINAL를 실행하여 자동 선택을 복원합니다.

픽셀 애니메이션

열고 닫는 애니메이션은 렌더러가 Kitty 그래픽, 유효한 픽셀 크기, 로컬 TTY, 대체 화면, 멀티플렉서 없음을 확인할 때만 픽셀을 사용합니다. 능력이 없거나 그래픽이 실패하면 텍스트 폴백을 사용합니다. 자동 고급 모드는 이 검사를 건너뛰지 않습니다.

모든 픽셀 애니메이션 프레임, 즉 Digital Code, Foliage, 랜드마크 장면은 1920x1080으로 제한됩니다. 이 애니메이션 프레임은 렌더러의 60 FPS 목표와 별도로 20 FPS 일정으로 갱신됩니다. 미리보기는 TUI 열고 닫는 애니메이션을 보십시오.

확인된 Sixel 지원이 있고 Kitty 그래픽이 없는 Windows Terminal 세션은 텍스트 폴백 대신, 640x360과 256 KiB로 제한된 정적 Sixel 스플래시 프레임 하나를 보여 줍니다. AX_CODE_SIXEL_SPLASH=0는 이를 끄고, =1는 모든 Sixel 터미널이 이를 보여 주게 합니다(테스트 경로). 해체할 때 스플래시 영역을 오버레이 배경으로 다시 칠합니다. Sixel에는 이미지 id 삭제가 없기 때문입니다.

Windows Terminal 글꼴

AX Code는 터미널 글꼴을 바꿀 수 없습니다. 파일 유형 아이콘(Nerd Font의 사적 사용 글리프)은 패치된 글꼴이 설치되어 있을 때만 Windows Terminal에서 렌더링됩니다. 권장 글꼴은 Cascadia Code NF입니다. 설치한 뒤 설정 > 프로필 > 모양 > 글꼴에서 프로필 글꼴로 지정합니다. 앱 안의 힌트가 Windows Terminal 사용자에게 이 설정을 한 번 안내합니다. 아이콘이 이미 렌더링되거나 AX_CODE_NERD_FONT=0로 제외하면 이 힌트는 나타나지 않습니다.