Flaq AI 에이전트 가이드

Flaq AI API 서비스에서 ZCode를 사용하기 위한 실용 가이드

ZCode 데스크톱 AI 코딩 환경을 Flaq AI의 OpenAI 호환 API에 연결한 다음, GLM 5.2, Kimi K3 또는 DeepSeek v4 모델을 사용해 저장소 관련 질문과 코딩 워크플로를 처리하세요. 이 가이드에서는 공식 ZCode 다운로드, 사용자 지정 제공자 설정, 모델 선택 및 간단한 워크스페이스 테스트를 다룹니다.

에이전트 가이드

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1DeepSeek Harness/api/v1ZCode/api/v1

설치

ZCode 설치

macOS, Windows 또는 Linux용 공식 ZCode 데스크톱 앱을 다운로드하고 시스템의 표준 절차에 따라 설치한 뒤, 처음 실행할 때 프로젝트 디렉터리를 선택하세요. 현재 ZCode는 macOS 및 Windows 다운로드 버전과 함께 Linux x64 AppImage도 제공합니다.

1

ZCode 다운로드

공식 설치 페이지를 열고 운영 체제와 아키텍처에 맞는 패키지를 선택하세요.

Apple Silicon 또는 Intel용 .dmg를 선택하고 ZCode를 Applications로 드래그한 다음 Launchpad에서 앱을 여세요.

macOS용 ZCode 다운로드

https://zcode.z.ai/en/docs/install

설정

ZCode를 Flaq AI에 연결

ZCode의 모델 설정을 열고 OpenAI 프로토콜을 사용하는 타사 제공자로 Flaq AI를 추가한 다음, Flaq API 키를 입력하고 선택한 모델 ID를 수동으로 추가하세요. 호환 모델 서비스가 기본 제공자 목록에 포함되어 있지 않더라도 ZCode는 사용자 지정 제공자를 통해 해당 서비스를 사용할 수 있습니다.

ZCode 코딩 워크플로, 여러 단계로 구성된 저장소 작업, 계획 및 코드 분석에 권장되는 기본 모델입니다.

ZCode 채팅 상자에서 모델 이름을 클릭하고 Manage Models를 선택한 다음 Settings → Model Settings를 여세요. Add Provider를 클릭하고 OpenAI 프로토콜을 선택한 뒤, 아래의 Flaq 설정을 입력하고 제공자를 켜세요. 모델 목록이 자동으로 로드되지 않으면 Add Model을 클릭하고 선택한 모델 ID를 수동으로 입력하세요.

  • 정확한 Flaq API 기본 URL을 사용하고 자리 표시자를 Flaq API 키로 바꾸세요.
  • 선택한 모델 ID는 표시된 그대로 정확하게 유지하세요.

Flaq AI 제공자 설정

Provider name: Flaq AIProtocol: OpenAIAPI base URL: https://api.flaq.ai/api/v1API key: Your_Flaq_Api_KeyModel ID: glm-5.2-text-to-textEnable provider: On

검증

ZCode에서 Flaq 확인

모델 선택기에서 구성한 Flaq 모델을 선택하고 프로젝트 디렉터리를 현재 워크스페이스로 연 다음, 새 ZCode Agent 세션을 시작하고 먼저 읽기 전용 저장소 작업을 보내세요.

이 프롬프트를 사용하여 선택한 모델이 파일 변경을 요청하지 않고 현재 워크스페이스의 정보를 바탕으로 응답하는지 확인하세요.

프로젝트 액세스 테스트

List the files in this project and summarize its main purpose. Do not modify any files.

공식 웹사이트

공식 ZCode 웹사이트 방문

최신 데스크톱 다운로드, 설치 지침, 모델 구성 문서, 릴리스 노트 및 제품 업데이트는 공식 ZCode 웹사이트에서 확인하세요.

공식 ZCode 웹사이트

공식 ZCode 웹사이트를 열어 앱을 다운로드하고 macOS, Windows 및 Linux용 최신 설정 절차를 확인하세요.

문제 해결

ZCode 자주 묻는 질문

이 가이드의 설정으로 사용할 경우 token 사용량이 크게 늘어날 수 있습니다.