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

안정성

상태: 활성
범위: 현재 상태
최종 검토: 2026-07-18
담당: ax-code 런타임

AX Code가 긴 대화형 세션과 헤드리스 실행에서 안정적으로 유지되는 방법입니다.

계층

계층	강화한 내용	주요 모듈
TUI 수명 주기	일시 중지와 재개, 크래시 후 터미널 복원, 세션을 떠날 때의 메모리 정리	ADR-047, `cli/tui/util/*`
프로세스 결함	중단, 취소, 깨진 파이프는 무시합니다. 실제 크래시는 여전히 종료합니다	`util/harmless-interrupt`, TUI 크래시 처리기, CLI 부팅 훅
시간 제한	unhandledRejection 없이 두는 도구, LSP, MCP 한계	`util/timeout.withTimeout`
스트림	유휴 감시, 끊겨도 다시 붙는 재연결	`session/llm-impl` 유휴 감시, `resilient-stream`
권한	이중 제출 래치와 응답 시간 제한	`permission-submit-latch`, 권한 프롬프트
저장소 위키	경로 봉쇄, 매니페스트를 마지막에 쓰는 원자적 기록, 보호된 내용, 쓰기 전 검증	`packages/ax-wiki`, `src/wiki/*`

지원되는 런타임 스택은 다음과 같습니다.

런타임: 번들된 Node
UI: AX Code TUI + Solid(주 기본 UI)
렌더: Zig(프로덕션). 네이티브 라이브러리는 저장소 안에 완전히 포함되어 있습니다 (독립 실행형 ax-tui 프레임워크 안에 벤더링되며, vendor/manifest.json로 해시가 고정됩니다) — 설치와 런타임 모두 업스트림 @opentui/* npm 패키지는 관여하지 않습니다
Yoga는 선택할 수 있는 모드가 아닙니다. AX Code TUI의 네이티브 렌더러가 기본으로 남습니다

신호	기대 동작
사용자 중단 / Esc / 도구 취소 (`AbortError`)	처리되지 않으면 warn으로 기록합니다. TUI는 종료하지 않습니다
셸이 닫힐 때의 깨진 파이프 (`EPIPE`)	무해한 것으로 무시합니다
잡히지 않은 애플리케이션 예외	터미널을 재설정하고 0이 아닌 코드로 종료합니다
스트림 유휴가 너무 김	스트림 유휴 감시로 턴을 중단합니다(구성 가능)

스트림 유휴 시간 제한은 AX_CODE_STREAM_IDLE_TIMEOUT_MS로 덮어씁니다(0는 비활성화합니다).

권한 응답의 성질은 다음과 같습니다.