Guida agli agenti Flaq AI

Guida pratica all'uso di OpenAI Codex CLI con i servizi API di Flaq AI e skill open source per agenti AI

Usa l'endpoint compatibile con OpenAI di Flaq AI per configurare rapidamente OpenAI Codex CLI con Flaq e accedere ai nostri servizi di modelli dal terminale. Dopo aver configurato la tua chiave API, segui gli esempi in questa guida per scegliere un modello GPT attualmente supportato e verificare la configurazione. Puoi anche esplorare skill open source per Codex riutilizzabili per estendere le capacità degli agenti AI e supportare ulteriori workflow.

Installa

Installare Codex CLI

Installa il pacchetto o l'app ufficiale Codex CLI, quindi conferma che il comando codex sia disponibile prima di configurare Flaq AI. Node.js 22+ è richiesto quando usi npm.

1

Installare Codex CLI

Scegli un metodo di installazione per il tuo sistema, quindi esegui il comando qui sotto.

Script di installazione ufficiale

curl -fsSL https://chatgpt.com/codex/install.sh | sh
2

Verificare Codex CLI

Conferma che il comando codex sia disponibile prima di configurare il provider Flaq.

Verificare l'installazione

codex --version

Configura

Collegare Codex CLI a Flaq AI

Scegli un modello attualmente supportato dall'endpoint Codex di Flaq, definisci Flaq come provider di modelli Codex e fornisci la tua chiave API Flaq come OPENAI_API_KEY. Le skill open source per Codex offrono workflow riutilizzabili per sviluppo, deployment, test, documenti, lavoro creativo e altre attività.

Modello GPT 5.6 predefinito per i workflow di sviluppo Codex tramite Flaq AI.

Usa un OPENAI_API_KEY temporaneo nella sessione di terminale corrente. Questo mantiene la tua chiave API fuori da ~/.codex/auth.json, ma Codex ha comunque bisogno della voce del provider Flaq in ~/.codex/config.toml.

1

Impostazioni provider Codex

Crea o aggiorna la configurazione del provider e mantieni wire_api impostato su responses. Su Windows, usa %USERPROFILE%\.codex\config.toml.

Impostazioni provider Codex

~/.codex/config.toml
model = "gpt-5.6-sol" model_provider = "flaq" [model_providers.flaq]name = "flaq gpt"base_url = "https://api.flaq.ai/codex-api/v1"wire_api = "responses"requires_openai_auth = true
2

Impostare la chiave API Flaq per questo terminale

Questo export si applica solo alla sessione di terminale corrente. Non modifica ~/.codex/auth.json né il tuo profilo shell.

Impostare la chiave API Flaq per questo terminale

export OPENAI_API_KEY="Your_Flaq_Api_Key"

Verifica

Verificare Flaq in Codex CLI

Invia un breve prompt con Codex CLI. Se risponde normalmente, Codex può chiamare modelli tramite Flaq AI.

Avviare la modalità interattiva

codex

Comando di test rapido

codex "What is 2+2?"

Eseguire temporaneamente il modello selezionato

codex --model gpt-5.6-sol

Abilitare i log di debug

DEBUG=true codex "test"

Competenze

Estendere Codex CLI con skill open source per agenti AI

Le skill di Codex sono pacchetti riutilizzabili di istruzioni, workflow, script e file di riferimento che estendono le capacità degli agenti AI nelle attività ricorrenti. Esplora skill per sviluppo, deployment, test, documenti, lavoro creativo e altri workflow senza ripetere le stesse istruzioni in ogni sessione. Verifica il codice sorgente, gli strumenti richiesti e le autorizzazioni di ogni skill prima di usarla.

Awesome Codex Skills

Esplora questo repository multilingue per trovare link categorizzati a skill di Codex, note d'uso, riferimenti al codice sorgente e dettagli di installazione.

Risoluzione dei problemi

FAQ su OpenAI Codex

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