Guida agli agenti Flaq AI

Guida pratica all'uso di ZCode con i servizi API di Flaq AI

Collega l'ambiente desktop di programmazione assistita dall'IA ZCode all'API di Flaq AI compatibile con OpenAI, quindi utilizza i modelli GLM 5.2, Kimi K3 o DeepSeek v4 per domande sui repository e flussi di lavoro di programmazione. Questa guida illustra il download ufficiale di ZCode, la configurazione di un provider personalizzato, la selezione del modello e un semplice test dell'area di lavoro.

Guide per agenti

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

Installa

Installare ZCode

Scarica l'app desktop ufficiale di ZCode per macOS, Windows o Linux, installala seguendo la procedura standard del tuo sistema e scegli una directory di progetto al primo avvio. Attualmente ZCode offre un'AppImage per Linux x64 oltre ai download per macOS e Windows.

1

Scaricare ZCode

Apri la pagina di installazione ufficiale e scegli il pacchetto corrispondente al tuo sistema operativo e alla tua architettura.

Scegli il file .dmg per Apple Silicon o Intel, trascina ZCode nella cartella Applicazioni e apri l'app dal Launchpad.

Scaricare ZCode per macOS

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

Configura

Collegare ZCode a Flaq AI

Apri le impostazioni dei modelli di ZCode, aggiungi Flaq AI come provider di terze parti utilizzando il protocollo OpenAI, inserisci la tua chiave API Flaq e aggiungi manualmente l'ID del modello selezionato. Tramite provider personalizzati, ZCode può utilizzare servizi di modelli compatibili anche quando non sono inclusi nel suo elenco di provider integrati.

Opzione predefinita consigliata per i flussi di lavoro di programmazione in ZCode, le attività sui repository in più passaggi, la pianificazione e l'analisi del codice.

Fai clic sul nome del modello nella casella di chat di ZCode, seleziona Manage Models e apri Settings → Model Settings. Fai clic su Add Provider, scegli il protocollo OpenAI, inserisci le impostazioni Flaq riportate di seguito e attiva il provider. Se l'elenco dei modelli non viene caricato automaticamente, fai clic su Add Model e inserisci manualmente l'ID del modello selezionato.

  • Utilizza l'URL di base esatto dell'API Flaq e sostituisci il segnaposto con la tua chiave API Flaq.
  • Mantieni l'ID del modello selezionato esattamente come mostrato.

Impostazioni del provider 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

Verifica

Verificare Flaq in ZCode

Scegli il modello Flaq configurato dal selettore dei modelli, apri una directory di progetto come area di lavoro corrente, avvia una nuova sessione di ZCode Agent e invia prima un'attività di sola lettura sul repository.

Utilizza questo prompt per verificare che il modello selezionato risponda con informazioni provenienti dall'area di lavoro corrente senza richiedere modifiche ai file.

Testare l'accesso al progetto

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

Sito ufficiale

Visitare il sito web ufficiale di ZCode

Visita il sito web ufficiale di ZCode per trovare i download correnti dell'app desktop, le istruzioni di installazione, la documentazione sulla configurazione dei modelli, le note di rilascio e gli aggiornamenti del prodotto.

Sito web ufficiale di ZCode

Apri il sito web ufficiale di ZCode per scaricare l'app e consultare la procedura di configurazione più recente per macOS, Windows e Linux.

Risoluzione dei problemi

Domande frequenti su ZCode

L'uso di questa configurazione della guida può aumentare significativamente l'utilizzo dei token.