Guia de agentes da Flaq AI

Guia prático para usar a OpenAI Codex CLI com os serviços de API da Flaq AI e skills de agentes de IA de código aberto

Use o endpoint compatível com OpenAI da Flaq AI para configurar rapidamente a OpenAI Codex CLI com a Flaq e acessar nossos serviços de modelos pelo terminal. Depois de configurar sua chave de API, siga os exemplos deste guia para escolher um modelo GPT atualmente compatível e verificar a configuração. Você também pode explorar skills de código aberto para Codex reutilizáveis para ampliar os recursos dos agentes de IA e oferecer suporte a outros fluxos de trabalho.

Guias de agentes

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

Instalar

Instalar a Codex CLI

Instale o pacote ou app oficial da Codex CLI e confirme que o comando codex está disponível antes de configurar a Flaq AI. Node.js 22+ é necessário ao usar npm.

1

Instalar a Codex CLI

Escolha um método de instalação para o seu sistema e execute o comando abaixo.

Script oficial de instalação

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

Verificar a Codex CLI

Confirme que o comando codex está disponível antes de configurar o provedor Flaq.

Verificar instalação

codex --version

Configurar

Conectar a Codex CLI à Flaq AI

Escolha um modelo atualmente compatível com o endpoint Codex da Flaq, defina a Flaq como provedor de modelos Codex e forneça sua chave de API da Flaq como OPENAI_API_KEY. Os skills de código aberto para Codex oferecem fluxos de trabalho reutilizáveis para programação, implantação, testes, documentos, trabalho criativo e outras tarefas.

Modelo GPT 5.6 padrão para fluxos de codificação do Codex pela Flaq AI.

Use um OPENAI_API_KEY temporário na sessão atual do terminal. Isso mantém sua chave de API fora de ~/.codex/auth.json, mas a Codex ainda precisa da entrada do provedor Flaq em ~/.codex/config.toml.

1

Configurações do provedor Codex

Crie ou atualize a configuração do provedor e mantenha wire_api definido como responses. No Windows, use %USERPROFILE%\.codex\config.toml.

Configurações do provedor 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

Definir a chave de API da Flaq para este terminal

Este export se aplica apenas à sessão atual do terminal. Ele não modifica ~/.codex/auth.json nem seu perfil de shell.

Definir a chave de API da Flaq para este terminal

export OPENAI_API_KEY="Your_Flaq_Api_Key"

Verificar

Verificar a Flaq na Codex CLI

Envie um prompt curto com a Codex CLI. Se ela responder normalmente, a Codex consegue chamar modelos pela Flaq AI.

Iniciar modo interativo

codex

Comando de teste rápido

codex "What is 2+2?"

Executar temporariamente o modelo selecionado

codex --model gpt-5.6-sol

Ativar logs de depuração

DEBUG=true codex "test"

Habilidades

Ampliar a Codex CLI com skills de agentes de IA de código aberto

Os skills da Codex são pacotes reutilizáveis de instruções, fluxos de trabalho, scripts e arquivos de referência que ampliam os recursos dos agentes de IA em tarefas recorrentes. Explore skills para programação, implantação, testes, documentos, trabalho criativo e outros fluxos sem repetir as mesmas instruções em cada sessão. Revise o código-fonte, as ferramentas necessárias e as permissões de cada skill antes de usá-lo.

Awesome Codex Skills

Explore este repositório multilíngue para encontrar links categorizados de skills da Codex, notas de uso, referências ao código-fonte e detalhes de instalação.

Solução de problemas

FAQ da OpenAI Codex

Usar esta configuração do guia pode aumentar significativamente o uso de tokens.