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 使用量が大幅に増える可能性があります。