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 用量。