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

AX Code 문서

상태: 활성 범위: 공개, 현재 상태 최종 검토: 2026-10-09 담당: AX Code 유지관리자

AX Code는 검토할 수 있고 되돌릴 수 있는 작업을 위한 코딩 에이전트 런타임입니다. 모든 세션은 파일 스냅샷이 있는 구조화된 이벤트 로그로 기록되고, 후보 구현은 저장소 자신의 검사와 대조하여 검증할 수 있으며, 아무것도 자동으로 병합되지 않습니다. AX Code를 쓰는 이유가 그것이 무엇을 최적화하는지, 누구를 위한 것인지, 의도적으로 주장하지 않는 것이 무엇인지를 설명합니다.

루트 README가 AX Code를 설치하고 실행하는 가장 짧은 길입니다. 작업 흐름을 구성하거나, 런타임 경계를 이해하거나, AX Code를 다른 시스템과 통합해야 할 때 이 허브를 사용합니다.

내부 프로세스 기록(PRD, ADR, 명세, 로드맵, 구현 계획, 경쟁 검토, 감사 작업 파일)은 이 공개 트리가 아니라 .internal/ 아래에 있습니다. 아래의 “문서 경계”를 보십시오. 공개 페이지는 여기에 링크된 페이지입니다.

공개 웹사이트: ax-code.app/ko/docs/. 이미 설치된 경우에는 업그레이드와 복구에서 시작합니다. 소스 접근과 공개 다운로드는 별개입니다. 소스 접근을 보십시오.

작업으로 고르기

외부 MCP 클라이언트를 통한 선택적 공유 터미널 탐색은 MCP로 실시간 TUI 공유를 보십시오.

실험적인 브라우저 브리지(페이지를 읽고, 선택적으로 클릭하고 채움)는 WebMCP 브라우저 브리지를 보십시오.

AX Trust 캐시를 통해 고른 파일에 대해 독립적으로 묻는 일은 고정 맥락 질문을 보십시오.

하고 싶은 일	여기서 시작
내 작업에 AX Code가 맞는지 판단	AX Code를 쓰는 이유
설치하기 전에 AX Code를 이해	여기서 시작
에이전트가 한 일을 검토하거나 비교하거나 실행 취소	실행 증거
여러 모델이 같은 변경을 시도하게 하기	검증된 다중 모델 변경
설치 또는 런타임 경로를 고르기	설치와 런타임 경로
호스트, CLI, 사용자 지정, 로컬 공급자를 연결	지원 공급자와 모델
Apple Silicon에서 관리형 로컬 추론을 켜기	AX Engine 모델 선택
현재 Tiel 대 MTPLX 속도 수치를 읽기	Tiel 동료 요약(2026년 9월 20일)
무료 티어 모델 API로 AX Code를 시험	무료 티어 API 빠른 시작
안전한 파일 시스템과 네트워크 경계로 에이전트를 실행	샌드박스 모드
클라우드나 네트워크 인프라를 안전하게 관리	클라우드 운영 모드
사람 없이, 또는 CI에서 실행	자율 모드
스크립트나 CI에서 일회성 `ax-code run` CLI를 호출	헤드리스 CLI
반복 프롬프트를 실행하거나 오래 남는 작업을 예약	루프 모드와 예약 작업
실행이 주의를 필요로 할 때 소리나 음성으로 알림	오디오 알림
프로세스나 호스트가 끝나도 예약 작업을 유지	장기 실행 작업
로컬, 클라우드, 하이브리드, council, arena 실행을 고르기	실행 모드
외부 도구와 데이터를 연결	MCP 통합
WebMCP로 에이전트가 Chrome에서 읽고 행동하게 하기	WebMCP 브라우저 브리지
애플리케이션에 AX Code를 넣기	`@defai-digital/ax-code-sdk`
다른 언어용 클라이언트를 생성	HTTP 및 OpenAPI 호환성
데스크톱 또는 네이티브 호스트를 만들기	네이티브 SDK 전송

시작하기

Standard와 Business — 오픈 소스 Standard, 무료 상업적 사용, 계획된 독점 Business, 공개 접근 상태입니다.
AX Code를 쓰는 이유 — AX Code가 최적화하는 것, 의도한 대상, 차이, 주장하지 않는 것입니다.
여기서 시작 — 제품의 사고 모델과 용도별 가장 짧은 경로입니다.
설치와 런타임 경로 — 지원 플랫폼, 패키지, 업데이트, 기여자 실행기입니다.

런타임 가이드

위키 증거 시각화 — 기록된 위키 페이지와 소스 관계의 로컬 그래프를 열거나, 오프라인 HTML을 내보냅니다. AX Code 자신의 위키에서 온 방사형, 힘 기반, 페이지 초점 스크린샷이 포함됩니다.
대화 재요약 — /recap로 최근 작업을 따라잡고, 유휴 배너를 구성합니다.
오디오 알림 — 실행이 주의를 필요로 할 때의 시스템 소리와, 선택하는 음성 알림입니다.
실행 증거 — 그래프, 비교, 재생, 위험, 롤백, 분기, 추적, 감사 내보내기입니다.
검증된 다중 모델 변경 — council과 arena 작업 흐름을 처음부터 끝까지 다룹니다.
샌드박스 모드 — 격리 모드, 보호 경로, 네트워크 제어, 우선순위입니다.
클라우드 운영 모드 — 계획, 승인, 적용 작업 흐름, 승인 토큰, cloudops 에이전트 태세입니다.
자율 모드 — 사람 없는 실행, 승인, 헤드리스 사용, 안전장치입니다.
헤드리스 CLI — 스크립트, CI, 에이전트 호출자를 위한 일회성 ax-code run 명령입니다.
TUI 언어와 설정 — 인터페이스와 대화의 언어, 처음 설정입니다.
TUI 애니메이션 — 열고 닫는 쌍, 터미널 능력, 렌더링 폴백입니다.
루프 모드와 예약 작업 — 반복 프롬프트, 오래 남는 일정, 장기 실행 한도입니다.
장기 실행 작업 — 감독되는 서비스 예시, 복구의 의미, 운영 검사입니다.
실행 모드 — 에이전트, 하이브리드, council, arena 동작입니다.
다중 모델 라우팅 모범 사례 — 프리미엄 추론과 비용이 낮은 지원 작업을 나누되, 정확성이 민감한 작업을 조용히 약하게 만들지 않습니다.
모델 복구 — 정확한 모델 선택, 명시적 폴백 구성과 진단입니다.
자동 경로 — 전문가 라우팅과 선택적 복잡도 라우팅입니다.
모델 effort — 사고 수준과 공급자별 동작입니다.
성능 — 코딩 도구 프로필과 로컬 요청 시간 진단입니다.
메모리 사용 — 메모리 프로필, 캐시 보존, 백그라운드 출력 한도입니다.
로컬 증거 캐시 — 선택적 SQLite와 RocksDB 증거 재사용, 자격 확인, 롤백입니다.
수명 주기 훅 — 훅 이벤트와 함께 제공되는 정책 팩입니다.
실행 보고서 — 워크스페이스 사용량, 활동, 모델과 도구 내역, 세션별 보고서입니다.

공급자

지원 공급자와 모델 — 공급자 ID, 자격 증명, 모델 발견입니다.
무료 티어 API 빠른 시작 — 호환되는 비용 없는 경로, 제약, 안전한 평가입니다.
사용자 지정 공급자와 게이트웨이 공급자 — OpenAI 및 Anthropic과 호환되는 엔드포인트입니다.
MTPLX와 oMLX 설정 — 소스 체크아웃의 로컬 프리셋, 발견, 도구, 인증입니다.
Tiel 동료 요약(2026년 9월 20일) — 현재 Tiel과 Cyber-Tiel 대 MTPLX 네이티브 API 수치입니다. 완성 기본값은 194.88이고, 최대 디코드는 249.01입니다.
AX Code와 OpenCode 클라이언트 재시험 — 클라이언트와 런타임 조합 여섯 가지, 활성 MTP, 처음과 반복의 시간, 코드 검사입니다.
로컬 추론 측정 — 시간과 비교 가능성의 한계가 있는, 날짜가 적힌 AX Code와 OpenCode 및 런타임 시험입니다.
AX Engine 모델 선택 — 로컬 모델 순위와 메모리 안내입니다.

통합

MCP 통합 — 신뢰, 권한, 리소스, 서버 보안입니다.
ACP — IDE 호스트를 위한 Agent Client Protocol 정상 경로입니다.
AX Wiki — 소스가 뒷받침하는 저장소 지식과 CI 작업 흐름입니다.
VS Code 통합 — 편집기 명령, 설정, 작업 흐름입니다. 마켓플레이스 목록에서 설치합니다.

SDK와 서비스 경계

@defai-digital/ax-code-sdk — 자사 TypeScript와 JavaScript 임베딩입니다.
네이티브 SDK 전송 — gRPC 형태의 데스크톱 및 네이티브 경계와 폴백 동작입니다.
HTTP 및 OpenAPI 호환성 — 서버 모드와 다른 언어용으로 생성된 클라이언트입니다.
OpenAPI 스냅샷 — 기준이 되는 HTTP 경로와 스키마 계약입니다.

아키텍처와 신뢰성

의미 계층 — 그래프와 LSP의 출처, 감사, 재생 경계입니다.
로컬 엔진 아키텍처 — AX Code가 AX Engine 사이드카를 쓰는 이유입니다.
런타임 안정성 — 취소, 크래시, 스트림, 시간 제한, TUI 신뢰성 계약입니다.

참조

구성 JSON 스키마 — 생성된 구성 입력 계약입니다.
TypeScript 네이티브 지원 — 소스 컴파일러, 언어 서비스, 진단, 호환성입니다.
스킬과 플러그인 카탈로그 — 함께 제공되는 스킬, 프로젝트 스킬, 플러그인, 평가입니다.
격리 정책 팩 — 기계가 읽을 수 있는 정책 예시입니다.
릴리스 검증 — 기준이 되는 Minisign 공개 키와 검증 명령입니다.
Windows 런타임 무결성 — 서명, 설치된 파일 검증, 바이러스 검사 증거입니다.
보안 정책 — 위협 모델, 자격 증명 저장, 지원되는 버전입니다.

문서 경계

docs/에는 릴리스된 런타임에 있는 동작에 대한 공개 안내가 들어 있습니다. 계획 자료, 릴리스 목표, 구현 정책, 임시 분석은 여기에 속하지 않습니다.

내용	위치
아키텍처 결정	`.internal/adr/`
제품 요구와 기술 명세	`.internal/prd/`와 `.internal/spec/`
로드맵, 구현 계획, 릴리스 목표, 검토, 감사	`.internal/reports/`
릴리스된 동작과 공개 통합 안내	`docs/`

모든 공개 Markdown 페이지는 위쪽에 상태, 범위, 최종 검토일, 담당을 밝혀야 합니다. 복사한 경로 목록이나 빨리 낡는 다른 스냅샷보다, 생성된 계약이나 구현 소스로 연결하는 쪽을 선호합니다.

유지 점검 목록

릴리스 전이나 상당한 문서 변경 전에 다음을 합니다.

명령, 기본값, 플래그, 공급자 ID, 런타임 레이블을 구현과 대조하여 확인합니다.
같은 동작을 여러 입구 페이지에 반복하지 않고, 가장 좁은 기준 가이드를 갱신합니다.
pnpm run test:scripts를 실행하여 깨진 로컬 링크, 고아 페이지, 빠진 페이지 메타데이터를 잡습니다.
승인된 내보내기 매니페스트를 갱신하고 node script/export-public-docs.mjs --website /path/to/ax-code.app를 실행한 뒤, 웹사이트 검사와 빌드, Workers 동작 확인을 실행합니다. 웹사이트 빌드는 커밋된 스냅샷을 쓰며 소스 접근이 필요하지 않습니다. 새로운 공개 페이지와 자산은 매니페스트에서 명시적으로 승인되어야 합니다.
제안, 프로젝트 개발 메모, 릴리스 목표, 역사적 결정 기록은 공개 탐색이 아니라 .internal/ 아래에 둡니다.