Flaq AI Agent Guide
Practical Guide for Using ZCode with Flaq AI's API Services
Connect the ZCode desktop AI coding environment to Flaq AI's OpenAI-compatible API, then use GLM 5.2, Kimi K3, or DeepSeek v4 models for repository questions and coding workflows. This guide covers the official ZCode download, custom provider setup, model selection, and a simple workspace test.
Install
Install ZCode
Download the official ZCode desktop app for macOS, Windows, or Linux, install it with the standard flow for your system, and choose a project directory during first launch. ZCode currently provides a Linux x64 AppImage alongside its macOS and Windows downloads.
Download ZCode
Open the official installation page and choose the package that matches your operating system and architecture.
Choose the Apple Silicon or Intel .dmg, drag ZCode into Applications, and open the app from Launchpad.
Download ZCode for macOS
Configure
Connect ZCode to Flaq AI
Open ZCode's model settings, add Flaq AI as a third-party provider using the OpenAI protocol, enter your Flaq API key, and manually add the selected model ID. ZCode can use compatible model services through custom providers even when they are not included in its built-in provider list.
Recommended default for ZCode coding workflows, multi-step repository tasks, planning, and code analysis.
Kimi K3 model for long-horizon coding, extended technical context, analysis, and agent-style text workflows.
DeepSeek v4 Pro model for repository analysis, coding questions, and tasks that benefit from stronger reasoning.
Faster DeepSeek v4 Flash option for summaries, routine code questions, and lightweight repository tasks.
Click the model name in the ZCode chat box, select Manage Models, and open Settings → Model Settings. Click Add Provider, choose the OpenAI protocol, enter the Flaq settings below, and turn on the provider. If the model list does not load automatically, click Add Model and enter the selected model ID manually.
- Use the exact Flaq API base URL and replace the placeholder with your Flaq API key.
- Keep the selected model ID exactly as shown.
Flaq AI provider settings
- Use the exact Flaq API base URL and replace the placeholder with your Flaq API key.
- Keep the selected model ID exactly as shown.
Flaq AI provider settings
- Use the exact Flaq API base URL and replace the placeholder with your Flaq API key.
- Keep the selected model ID exactly as shown.
Flaq AI provider settings
- Use the exact Flaq API base URL and replace the placeholder with your Flaq API key.
- Keep the selected model ID exactly as shown.
Flaq AI provider settings
Verify
Verify Flaq in ZCode
Choose the configured Flaq model from the model selector, open a project directory as the current workspace, start a new ZCode Agent session, and send a read-only repository task first.
Use this prompt to check that the selected model responds with information from the current workspace without requesting file changes.
Test project access
Use this prompt to check that the selected model responds with information from the current workspace without requesting file changes.
Test project access
Use this prompt to check that the selected model responds with information from the current workspace without requesting file changes.
Test project access
Use this prompt to check that the selected model responds with information from the current workspace without requesting file changes.
Test project access
Official Website
Visit the Official ZCode Website
Visit the official ZCode website for current desktop downloads, installation instructions, model configuration documentation, release notes, and product updates.
Open the official ZCode website to download the app and review the latest setup flow for macOS, Windows, and Linux.
Troubleshooting