고급 사용법
일반 사용자는 데스크톱 앱을 사용하세요
컴퓨터에서 AI로 파일, 표, 이미지를 처리하고 싶을 뿐이라면 **다운로드 페이지**에서 데스크톱 앱을 설치하세요. 이 페이지는 명령줄, 스크립트, 서버 배포 방식이며 터미널을 사용할 줄 알아야 합니다. 잘못 설치하면 열 수 없습니다.
이 페이지는 개발자, 운영자, 고급 사용자를 위한 것입니다. 세 방법 중 하나만 선택하면 되고 기능은 데스크톱 버전과 같습니다.
1. 명령줄 버전(단일 파일)
단일 실행 파일로 런타임을 내장하고 있어 대상 머신에 Node를 설치할 필요가 없습니다.
현재 안정 버전: v0.3.25 · 빌드 시간: 2026-11-08 13:06:55(UTC)
未能识别你的系统。 请从下面选择对应平台的安装包。
不确定选哪个？第一个通常就对了。
플랫폼별 설명
Windows — Windows 10 / Server 2016 이상이 필요합니다. Windows 7, 8, 8.1과 Server 2008 R2 / 2012는 실행할 수 없습니다. C++ 런타임을 설치해도 해결되지 않습니다. 자세히는 Windows 지원 버전을 참고하세요.
산출물에 Authenticode 서명이 없어 첫 실행 시 SmartScreen 경고가 나올 수 있습니다. '추가 정보 → 실행'을 선택하세요. exe를 더블 클릭하면 실행됩니다. zqagent를 직접 입력하려면 zqagent.exe로 이름을 바꾸고 PATH에 추가하세요.
macOS — 산출물은 확장자 없는 실행 파일이며, 첫 실행 시 격리 속성을 해제해야 합니다:
chmod +x zqagent-macos-arm64
xattr -d com.apple.quarantine zqagent-macos-arm64더블 클릭으로 설치하고 싶거나 터미널을 다루고 싶지 않다면 데스크톱 앱의
.dmg를 사용하세요.
Linux — glibc 2.28 미만의 오래된 시스템(CentOS 7 / Kylin V10 등)은 아래 설치 스크립트를 사용하세요. glibc 2.17 호환 빌드를 자동으로 선택합니다.
2. 한 줄 설치 스크립트(Linux / macOS)
자동으로 다운로드, 검증, 설치하고 자동 시작 서비스로 등록합니다:
curl -fsSL https://agent.cd-zq.com/install.sh | sh포트나 데이터 디렉터리 지정, 서명 검증 공개 키 명시가 필요하면 먼저 스크립트를 내려받아 실행합니다:
curl -fsSLO https://agent.cd-zq.com/install.sh
# Linux: sudo로 시스템 서비스 설치. 데이터 기본 위치는 실행 사용자 홈(~/.zqagent_data)
sudo sh install.sh --port 8787
# 다른 곳에 두려면 명시적으로 지정(로그도 자동으로 따라감)
sudo sh install.sh --port 8787 --data-dir /srv/zqagent
# macOS: 기본으로 현재 사용자 디렉터리(~/Library/Application Support/zqagent)에 기록. sudo 불필요
sh install.sh --port 8787설치 후 sudo sh -s -- status|logs|restart|rollback|uninstall로 서비스를 관리합니다 (macOS에서 일반 사용자로 설치했다면 sudo 제외). 자세히는 설치를 참고하세요.
3. 스크립트와 API 연동
| 용도 | 입구 |
|---|---|
| npm 설치 | npm i -g @zqagent/core |
| 라이브러리로 임베드 | 아키텍처 설명 |
| 멀티 테넌트 노드 서비스 | REST API |
| 와이어 프로토콜 | wire-protocol |
| MCP 외부 도구 | MCP |
| 21개 내장 도구 | 내장 도구 |
| CLI 명령과 승인 세부 사항 | CLI 사용 가이드 |
이전 버전
正在加载历史版本…
다운로드 검증
각 버전의 SHA-256과 크기는 버전 목록에 기록되어 있어 내려받은 파일을 대조할 수 있습니다:
# 현재 버전 목록(JSON)
curl -s https://agent.cd-zq.com/downloads/zqagent/stable.json
# 일반 텍스트 형식(플랫폼 버전 URL SHA-256 크기)
curl -s https://agent.cd-zq.com/downloads/zqagent/stable.txt
# 내려받은 파일 대조
sha256sum zqagent-linux-x64