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

여기서 시작

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

루트의 README가 AX Code를 설치하는 가장 빠른 길이라면, 이 페이지는 AX Code를 이해하는 가장 빠른 길입니다.

에디션과 제공

AX Code Standard부터 시작합니다. 개인 사용과 상업적 사용 모두 무료인 오픈 소스 에디션입니다. 로컬 모델이나 클라우드 모델을 사용합니다. AX Engine은 지원되는 Apple Silicon Mac에서 네이티브 로컬 추론 경로를 제공합니다. 기존의 권한, 변경 검토, 로컬 실행 증거는 핵심 능력으로 남습니다.

Business는 AX Trust를 통한 조직 거버넌스와 AutomatosX를 통한 업무 흐름을 위해 계획된 독점 제품입니다. 직장에서 Standard를 쓴다고 해서 그 자체로 Business 라이선스가 필요해지지는 않습니다. 자세한 내용은 Standard와 Business를 보십시오.

서명된 설치 프로그램과 런타임 아카이브는 download.ax-code.com에서 익명으로 받을 수 있습니다. 설치 가이드와 업그레이드 및 복구 가이드를 읽습니다. 공개 기술 문서는 소스 접근과 별개로 ax-code.app/ko/docs/에 있습니다. 이미 설치했습니까? 프로젝트에서 터미널을 열고 ax-code를 실행한 뒤, TUI 안에서 /connect로 공급자를 고릅니다. 프로젝트에 대한 질문으로 시작하고, 작은 변경을 요청한 다음, 커밋하기 전에 diff와 프로젝트 검사를 검토합니다. 설치된 런타임에 진단이 필요하면 ax-code doctor를 사용합니다.

AX Code란 무엇인가

AX Code는 AI 코딩 런타임입니다. 다음을 하나로 묶습니다.

• 서로 다른 코딩 작업을 위한 에이전트
• 명시적인 도구 실행
• 모델과 공급자 선택
• 지속되는 세션 상태
• 구성할 수 있는 격리와 권한
• TUI, SDK, 서버 모드, MCP 같은 통합 표면

이것이 중요한 이유는, 실제 저장소에서 AI 코딩이 쓸모 있으려면 에이전트에게 허용된 일을 제어하고, 세션을 넘어 맥락을 보존하고, 채팅 창 하나 밖에서도 같은 작업 흐름을 다시 쓸 수 있어야 하기 때문입니다.

가치가 나오는 곳

AX Code는 에이전트가 끝낸 다음 순간을 최적화합니다. 만든 결과를 남길지 결정하는 순간입니다.

• 증거. 모든 세션은 형식이 있는 이벤트 로그와 파일 스냅샷으로 기록됩니다. 그래서 대화가 끝난 뒤에 무슨 일이 있었는지를 ax-code graph, compare, replay, risk, audit가 다시 구성할 수 있습니다.
• 검증. 게이트를 강제할 수 있는 곳, 즉 arena 후보와 게이트가 있는 리팩터 적용에서는 저장소 자신의 typecheck, lint, 테스트 명령이 결과를 받아들일지 결정합니다.
• 되돌릴 수 있음. 스냅샷은 세션만이 아니라 단계마다 복구할 수 있습니다. 저장소 밖에 둔 Git 객체 저장소에서 가져옵니다.
• 사용자의 결정. AX Code는 순위를 매기고, 점수를 매기고, 보고합니다. 사용자를 대신해 병합하지는 않습니다.

이를 뒷받침하는 것은 권한 규칙과 격리 모드가 있는 명시적 도구, 오래 남는 세션, 저장소 관례를 위한 AGENTS.md, 공급자를 옮길 수 있는 성질, 그리고 TUI, CLI, VS Code 확장, SDK, 헤드리스 서버, MCP 통합 뒤의 하나의 런타임입니다. 이것은 토대이며, AX Code를 고르는 이유는 아닙니다. AX Code를 쓰는 이유를 보십시오.

명령 자체는 실행 증거를 보십시오.

사고 모델

AX Code를 다섯 계층으로 생각합니다.

1. 공급자 계층. 실행할 모델 백엔드를 고릅니다.
2. 에이전트 계층. 작업에 맞는 에이전트를 고르거나, 라우팅의 도움을 받습니다.
3. 도구 계층. 에이전트는 숨은 능력이 아니라 명시적인 도구를 통해 행동합니다.
4. 세션 계층. 대화, 결정, 상태가 유지됩니다.
5. 제어 계층. 격리, 권한, 감사 동작이 경계를 정합니다.

나머지 문서는 이 계층에 대응합니다.

다음 경로를 고르기

빨리 시험하고 싶습니다

• 설치와 첫 실행은 루트 README에서 시작합니다.
• 지원되는 설치 경로는 컴파일된 런타임을 사용합니다.
  • macOS Apple Silicon과 Linux용 Bash 릴리스 설치 프로그램: curl -fsSL -H "Accept: application/vnd.github.raw+json" "https://api.github.com/repos/defai-digital/ax-code/contents/install?ref=main" | bash
  • macOS CLI의 Homebrew 대안: brew tap defai-digital/tap && brew trust defai-digital/tap && brew install defai-digital/tap/ax-code
  • Windows PowerShell용 GitHub 릴리스 설치 프로그램: powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"
• Bash 설치 프로그램은 Windows의 기준이 되는 설정 경로가 아닙니다.
• npm 패키지는 더 이상 지원되는 설치나 업그레이드 경로가 아닙니다. 플랫폼 정책, 런타임 레이블, 로컬 실행기 표는 설치와 런타임 경로를 보십시오.
• 모델을 설정하려면 /connect 또는 ax-code providers login를 사용합니다. Cloud API 공급자, CLI 공급자, AX Engine, 모델 ID는 지원 공급자와 모델을 보십시오. 비용 없이 평가하는 경로는 무료 티어 API 빠른 시작을 사용합니다.
• 실제 프로젝트를 연 뒤 ax-code init를 실행하여 AGENTS.md가 로컬 관례를 캡처하게 합니다.
• 더 엄격한 안전 경계가 필요하면, 더 넓은 편집 전에 샌드박스 모드를 켭니다.

팀이나 회사 저장소에서 안전하게 쓰고 싶습니다

• AX Code는 자율 모드가 켜지고 샌드박스 모드가 꺼진 상태로 시작합니다. full-access이며, 파일 시스템과 네트워크 접근에는 제한이 없습니다.
• 팀, 회사, 신뢰할 수 없는 작업, 사람이 없는 작업에서는 작업을 시작하기 전에 --sandbox workspace-write 또는 read-only를 켭니다.
• 실행 경계는 샌드박스 모드를 읽습니다.
• 에이전트가 사람 없이 실행될 때는 자율 모드를 읽습니다.
• 위협 모델과 자격 증명 저장의 세부 사항은 보안 정책을 읽습니다.
• 작업 흐름에서 출처와 재생이 중요하면 의미 계층을 읽습니다.

넣어서 쓰거나 자동화하고 싶습니다

• TypeScript 앱에 넣으려면 @defai-digital/ax-code-sdk의 헤드리스 또는 gRPC 진입점을 사용합니다.
• 서비스 경계, 생성된 클라이언트, 기준이 되는 OpenAPI 계약에는 HTTP 및 OpenAPI 호환성을 사용합니다.
• 에이전트에 외부 도구나 서비스가 필요하면 ax-code mcp add를 사용합니다.

저장소를 이해하거나 피드백을 남기고 싶습니다

• 나머지 공개 문서는 문서 허브를 읽습니다.
• 현재의 외부 기여 정책은 CONTRIBUTING.md를 읽습니다.

AX Code가 맞지 않을 때

AX Code는 의도적으로 자동 완성이나, 호스트가 제공하는 채팅 상자보다 큽니다. 다음과 같으면 과할 수 있습니다.

• 인라인 코드 제안만 필요하고, 에이전트가 도구를 실행하기를 원하지 않을 때
• 로컬 런타임 없이 호스트된 SaaS만 필요할 때
• 세션이 유지되거나, 재생하거나, SDK와 서버에 통합하거나, 저장소 수준의 지침이 필요 없을 때
• 로컬 CLI 프로세스가 허용되지 않는 환경에서 일할 때

그런 경우에는 더 가벼운 편집기 도우미가 더 단순할 수 있습니다. AX Code는 에이전트가 제어와 연속성, 통합의 경계가 있는 실제 개발 작업 흐름 안에서 움직여야 할 때 가장 강합니다.

흔한 첫 명령

ax-code
ax-code providers login
ax-code models
ax-code run --model qwen -- "Review this change"
ax-code init
ax-code index
ax-code mcp add
ax-code doctor

Grok은 Grok Build CLI를 통해서만 실행됩니다. grok-build-cli를 /connect에서 선택합니다. AX Code는 로컬 grok 명령을 호출하고, 그 CLI 로그인과 세션을 다시 사용합니다. 이전의 직접 xai 클라우드 API 공급자는 더 이상 지원되지 않습니다.

문서 지도