Guia de integração de agente
Use OpenCode com a API LLM da WaveSpeed
Este guia mostra como conectar OpenCode à WaveSpeed AI com ~/.config/opencode/opencode.json, Chat completions compatíveis com OpenAI, /v1/chat/completions, 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
~/.config/opencode/opencode.jsonExecute opencode e confira Logs
O que este setup de OpenCode configura
Protocolo
Chat completions compatíveis com OpenAI
Endpoint
/v1/chat/completions
Modelo
anthropic/claude-opus-4.8
A configuração pronta para copiar acima é o único arquivo OpenCode que você precisa editar no setup recomendado: ~/.config/opencode/opencode.json. 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 OpenCode. Se usar um perfil de shell, recarregue o terminal antes de iniciar o agente.
Requests falham com erro de protocolo ou endpoint
Confira se OpenCode está usando Chat completions compatíveis com OpenAI e endpoint /v1/chat/completions. 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 ~/.config/opencode/opencode.json. Você pode começar com o modelo padrão mostrado nesta página.
Nenhum request aparece em Logs
Garanta que OpenCode 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 OpenCode pode aparecer em buscas?
Sim. Esta página foi criada como um guia de setup indexável para usuários que pesquisam OpenCode custom provider, endpoint compatível com OpenAI, base URL e fluxos de configuração local de agentes.