Qual arquivo de configuração Codex usa?

Use ~/.codex/config.toml para o setup recomendado da WaveSpeed AI. A configuração aponta Codex para endpoint /v1/responses.

Qual protocolo Codex deve usar?

Codex deve usar OpenAI Responses API. Esta página usa endpoint /v1/responses para corresponder a esse protocolo.

Como verifico que Codex está conectado?

Execute Codex localmente e abra WaveSpeed Logs. Requests bem-sucedidos devem aparecer com o modelo selecionado e detalhes de uso.

Setup do agente

Conecte Codex à API LLM da WaveSpeed

Copie o setup ~/.codex/config.toml recomendado para Codex, roteie requests para /v1/responses e verifique chamadas locais do agente em WaveSpeed Logs.

API key Testar modelo

Arquivo de configuração

~/.codex/config.toml

Protocolo

OpenAI Responses API

Endpoint

/v1/responses

Início rápido

Crie uma chave de acesso WaveSpeed

Exporte localmente a chave necessária

Cole a configuração em~/.codex/config.toml

Execute codex --profile wavespeed e confira Logs

Modelo

Chat completions compatíveis com OpenAI

O uso aparece em Dashboard e Logs

Troque modelos sem reescrever o código do agente

Editar ~/.codex/config.toml

# File: ~/.codex/config.toml

model = "anthropic/claude-opus-4.8"
model_provider = "wavespeed"

[model_providers.wavespeed]
name = "WaveSpeed AI"
base_url = "https://llm.wavespeed.ai/v1"
env_key = "WAVESPEED_API_KEY"
wire_api = "responses"

Início rápido

Crie uma chave de acesso WaveSpeed

Exporte localmente a chave necessária

Cole a configuração em~/.codex/config.toml

Execute codex --profile wavespeed e confira Logs

Ambiente

export WAVESPEED_API_KEY="sk-..."

Depois da configuração

Ver dashboard de uso Ver logs de requests Explorar modelos

Guia de integração de agente

Use Codex com a API LLM da WaveSpeed

Este guia mostra como conectar Codex à WaveSpeed AI com ~/.codex/config.toml, OpenAI Responses API, /v1/responses, base URL https://llm.wavespeed.ai/v1 e modelo padrão anthropic/claude-opus-4.8. Copie a configuração acima, exporte sua API key, execute o agente e verifique os requests em Logs.

Crie uma chave de acesso WaveSpeed

Exporte localmente a chave necessária

Cole a configuração em

~/.codex/config.toml

Execute codex --profile wavespeed e confira Logs

O que este setup de Codex configura

Protocolo

OpenAI Responses API

Endpoint

/v1/responses

Modelo

anthropic/claude-opus-4.8

A configuração pronta para copiar acima é o único arquivo Codex que você precisa editar no setup recomendado: ~/.codex/config.toml. Mantenha a API key no ambiente shell para não enviá-la a um repositório.

Solução de problemas

A API key não está sendo lida

Exporte WAVESPEED_API_KEY na mesma shell em que você executa Codex. Se usar um perfil de shell, recarregue o terminal antes de iniciar o agente.

Requests falham com erro de protocolo ou endpoint

Confira se Codex está usando OpenAI Responses API e endpoint /v1/responses. Incompatibilidades de protocolo são a causa mais comum de erros 404 ou payload.

O modelo selecionado não funciona

Confirme que o ID do modelo existe em WaveSpeed Models e cole o ID exato em ~/.codex/config.toml. Você pode começar com o modelo padrão mostrado nesta página.

Nenhum request aparece em Logs

Garanta que Codex use a base URL da WaveSpeed e sua API key atual. Depois envie um novo prompt pelo agente local e atualize Logs.

Este guia de Codex pode aparecer em buscas?

Sim. Esta página foi criada como um guia de setup indexável para usuários que pesquisam Codex custom provider, endpoint compatível com OpenAI, base URL e fluxos de configuração local de agentes.

Ver todos os guias de setup de agentes Explorar modelos