문서 스냅샷 · CLI 7.30.1 · SDK 2.6.53. Desktop은 자체 릴리스에 포함된 런타임을 사용합니다. 명령과 예제는 영어 원문을 유지합니다. 영어 원문

첫 AX Wiki 만들고 사용하기

시작하기 전에

AX Wiki는 선택된 저장소 소스로 아키텍처와 워크플로 페이지를 만듭니다. AX Code 웹사이트 문서와는 별개의 저장소 지식입니다. 먼저 공급자를 연결하고 사용 가능한 모델을 선택하세요. 생성 시 선택된 근거가 해당 공급자에게 전송되며 사용 요금이 발생할 수 있습니다.

프로젝트 폴더에서 실행합니다. Git 프로젝트는 하위 폴더에서 시작해도 가장 가까운 작업 트리 루트를 사용합니다. 체크아웃을 확인하고 생성 파일을 버전 관리할지 결정하세요.

미리 보기와 생성

계획은 모델 호출 없이 선택된 파일과 페이지를 미리 보여줍니다. 생성 전에 검토하세요:

ax-code wiki plan

설정한 모델로 생성하고 결과를 검증한 다음 로컬 리더를 엽니다:

ax-code wiki generate
ax-code wiki doctor
ax-code wiki viz --open

기본 출력은 .ax-wiki/이며 .ax-wiki/quickstart.md부터 읽습니다. .ax-wiki/.manifest.json은 소스와 해시를 기록합니다. 생성 시 AGENTS.md의 Wiki 안내 블록이 갱신될 수 있습니다. --skip-agents로 이를 건너뛸 수 있습니다. 결과 차이를 검토하세요.

읽고 유용한 질문하기

빠른 시작 페이지에서 인용 파일을 따라가고 워크플로가 어디에 구현되어 있는지 질문합니다. 뷰어는 페이지, 인용, 기록된 관계를 표시합니다. 포그라운드 CLI 뷰어는 Ctrl+C로 종료합니다.

Wiki로 방향을 잡은 뒤 현재 코드와 테스트를 확인합니다. 정확한 심볼, 호출자, 참조는 코드 인텔리전스나 LSP를 사용하세요. 최신 페이지도 완전한 범위, 정확성, 실행 성능의 증거는 아닙니다.

생성 제어

다음 선택 설정을 프로젝트 ax-code.json에 병합합니다. 연결에서 사용 가능한 모델 ID로 바꾸세요. 이 예시는 명시적 명령을 유지하며 백그라운드 유지 관리를 끕니다:

{
  "wiki": {
    "enabled": true,
    "auto": false,
    "model": "provider/model"
  }
}

명시한 --model provider/model는 해당 실행의 Wiki 모델을 덮어씁니다. 추론 모델의 Wiki 생성에는 인식 가능한 낮음·꺼짐 추론 제어가 필요합니다. 정책으로 요청이 거부되면 다른 지원 모델을 선택하세요.

관리자 메모는 보호 블록 안에 두면 업데이트 후에도 보존됩니다:

<!-- AX-WIKI:PROTECTED:START project-note -->

Deployment requires maintainer review.

<!-- AX-WIKI:PROTECTED:END -->

문제 복구

모델 없음 또는 인증 오류: 공급자 접근과 Wiki 모델 설정을 확인합니다. 채팅 모델이 동작해도 별도의 Wiki 모델이 사용 가능하다는 보장은 없습니다.
시간 초과 또는 빌드 중단: ax-code wiki doctor와 .ax-wiki/.build-report.json를 확인하고 원인을 해결한 뒤 재시도합니다. 검증된 임시 페이지를 재사용할 수 있습니다. 빌드 실패가 모든 페이지가 게시되었다는 뜻은 아닙니다.
수동 편집 충돌: 메모를 보호 블록에 보존하고 재시도 전 변경을 검토합니다. --force는 보호 블록 밖 편집을 교체하므로 의도한 경우에만 사용하세요.

다음 단계

Wiki 설정·CI·문제 해결 · 뷰어와 오프라인 내보내기 · 모델 선택 · 문서 홈