zai-org/ZCode

어떤 프로젝트인가요?

핵심 기능

• 01터미널 UI, 브라우저 UI, 데스크톱 앱이 하나의 에이전트 백엔드를 공유합니다.
• 02웹 모드는 기본적으로 localhost에서 제공되며 LAN 사용을 위한 액세스 토큰을 지원합니다.
• 03모노레포 구조에서 데스크톱, 웹, 서버, 공유 UI, CLI 패키지를 분리합니다.
• 04빌드 스크립트로 macOS, Windows, Linux용 데스크톱 번들을 생성합니다.
• 05CLI 릴리스는 체크섬과 설치 스크립트가 포함된 tarball로 제공됩니다.

활용 사례

• 원격 프로젝트에서 SSH 세션을 통해 터미널로 AI 코딩 에이전트를 실행합니다.
• 로컬 프로젝트 폴더를 대상으로 브라우저 기반 코딩 워크스페이스를 사용합니다.
• 오픈소스 코드베이스를 기반으로 에이전트를 확장하거나 UI 플러그인을 개발합니다.

빠른 시작

1. 1

   사전 요구 사항을 설치합니다: Git, Node.js 24.14.0, pnpm 10.33.2 (mise.toml 참조)

2. 2

   저장소 루트에서 종속성과 로컬 리소스를 준비합니다

   pnpm bootstrap
3. 3

   데스크톱 앱을 개발 모드로 시작합니다

   pnpm dev:desktop

사용 전 알아둘 점

• !설정을 시작하기 전에 Node.js 24.14.0과 pnpm 10.33.2를 설치해야 합니다.
• !소스에서 빌드한 데스크톱 앱은 로컬에서 서명되지 않으며, macOS에서는 격리 속성을 수동으로 제거하지 않으면 첫 실행이 차단될 수 있습니다.
• !CLI 릴리스를 패키징하려면 다운로드 기본 URL을 설정하고 직접 호스팅해야 합니다.

토픽

자주 묻는 질문

ZCode은(는) 무엇인가요?

Z.ai의 AI 코딩 워크스페이스로, 공통 TypeScript 코드베이스를 기반으로 데스크톱 앱, 브라우저 UI, 터미널 에이전트를 제공합니다. ZCode는 Z.ai의 AI 코딩 워크스페이스입니다. Electron 데스크톱 앱, 로컬 백엔드에서 제공하는 웹 클라이언트, 그리고 하나의 `zcode` 명령으로 터미널 UI(TUI), 웹 인터페이스 또는 에이전트를 실행하는 CLI 패키지, 세 가지 형태로 제공됩니다.

ZCode은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ZCode은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ZCode은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. ZCode의 마지막 커밋은 2026년 10월 19일입니다.

ZCode은(는) 어디에 사용할 수 있나요?

원격 프로젝트에서 SSH 세션을 통해 터미널로 AI 코딩 에이전트를 실행합니다. 로컬 프로젝트 폴더를 대상으로 브라우저 기반 코딩 워크스페이스를 사용합니다. 오픈소스 코드베이스를 기반으로 에이전트를 확장하거나 UI 플러그인을 개발합니다.

ZCode는 어떻게 설치하나요?

사전 요구 사항을 설치합니다: Git, Node.js 24.14.0, pnpm 10.33.2 (mise.toml 참조) 저장소 루트에서 종속성과 로컬 리소스를 준비합니다: pnpm bootstrap 데스크톱 앱을 개발 모드로 시작합니다: pnpm dev:desktop

ZCode은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/zai-org/ZCode