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 官方桌面应用，按照系统的标准流程完成安装，并在首次启动时选择项目目录。目前，除 macOS 和 Windows 下载版本外，ZCode 还提供 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 用量。