AI 코딩 작업대 ZCode 개발 및 배포 워크플로우
zai-org/ZCode
GitHubZCode는 AI 기반의 통합 코딩 작업대(Workbench)로, 데스크톱 애플리케이션, 웹 브라우저 인터페이스, 터미널 에이전트 기능을 모두 제공하는 포괄적인 개발 환경입니다.
- 플랫폼은 이 세 가지 주요 모드를 하나의 통일된 명령줄 인터페이스(CLI)를 통해 통합하여 사용자에게 일관되고 편리한 코딩 워크플로우를 제공합니다.
- 개발자는 복잡하게 분리되었던 AI 코드 생성 및 실행 과정을 단일 환경에서 경험하며, 개발 생산성을 극대화할 수 있다는 점이 핵심 강점입니다.
- 다만, 개발과 배포 과정이 매우 상세하고 특정 Node.js 버전 및 pnpm 등 복잡한 빌드 환경을 요구하므로 높은 기술 이해도가 필요합니다.
ZCode는 AI 기반의 통합 코딩 작업대(Workbench)로, 데스크톱 애플리케이션, 브라우저 인터페이스, 그리고 터미널 기능을 제공합니다. 개발을 시작하려면 Git과 Node.js 24.14.0, pnpm 10.33.2 버전을 준비해야 하며, 프로젝트 루트 디렉토리에서 `pnpm bootstrap` 명령어를 실행하여 워크스페이스 의존성을 설치하고 데스크톱 로컬 실행 리소스를 준비할 수 있습니다.
개발 환경은 여러 모드로 나뉘어 운영됩니다. 데스크톱 개발 시에는 `pnpm dev:desktop`을 사용하며, 이는 로컬 리소스 준비와 데스크톱 에이전트 빌드를 거쳐 Electron 및 소스 코드 감시를 시작합니다. 웹 코드를 수정할 때는 `pnpm dev:web` 명령어를 사용하여 Web 개발 서버(기본 http://localhost:5173)와 백엔드 서비스(기본 http://localhost:3030)를 동시에 구동할 수 있습니다.
최종 배포 패키지를 생성하려면, 먼저 다운로드 루트 주소(`ZCODE_DIST_BASE_URL`)를 설정한 후 `pnpm build:zcode` 명령어를 실행해야 합니다. 이 명령어는 CLI/TUI, 백엔드, Web을 순차적으로 빌드하고 TUI의 네이티브 라이브러리 및 런타임 의존성을 수집하여 배포 패키지를 구성합니다. 생성된 결과물은 `releases/<version>/zcode-<version>.tar.gz` 형태로 제공됩니다.
용어 풀이
- 에이전트
- 목표를 받으면 스스로 계획을 세우고 도구를 써서 여러 단계의 작업을 해내는 AI.