Seedance 2.0 SCONTO 15% | Crea nel Video Generator →
Setup agent

Connetti OpenCode alla WaveSpeed LLM API

Copia il setup ~/.config/opencode/opencode.json consigliato per OpenCode, instrada le richieste a /v1/chat/completions e verifica le chiamate agent locali in WaveSpeed Logs.

File di configurazione

~/.config/opencode/opencode.json

Protocollo

Chat completions compatibili con OpenAI

Endpoint

/v1/chat/completions

Avvio rapido

1

Crea una chiave di accesso WaveSpeed

2

Esporta localmente la chiave richiesta

3

Incolla la configurazione in~/.config/opencode/opencode.json

4

Esegui opencode e controlla Logs

Chat completions compatibili con OpenAI

L’utilizzo appare in Dashboard e Logs

Cambia modello senza riscrivere il codice dell’agent

Modifica ~/.config/opencode/opencode.json
// File: ~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "wavespeed": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "WaveSpeed AI",
      "options": {
        "baseURL": "https://llm.wavespeed.ai/v1",
        "apiKey": "{env:WAVESPEED_API_KEY}"
      },
      "models": {
        "anthropic/claude-opus-4.8": {
          "name": "anthropic/claude-opus-4.8",
          "tool_call": true
        }
      }
    }
  },
  "model": "wavespeed/anthropic/claude-opus-4.8"
}

Guida integrazione agent

Usa OpenCode con la WaveSpeed LLM API

Questa guida mostra come collegare OpenCode a WaveSpeed AI con ~/.config/opencode/opencode.json, Chat completions compatibili con OpenAI, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1 e modello predefinito anthropic/claude-opus-4.8. Copia la configurazione sopra, esporta la tua API key, avvia l’agent e verifica le richieste in Logs.

1

Crea una chiave di accesso WaveSpeed

2

Esporta localmente la chiave richiesta

3

Incolla la configurazione in

~/.config/opencode/opencode.json
4

Esegui opencode e controlla Logs

Cosa configura questo setup di OpenCode

Protocollo

Chat completions compatibili con OpenAI

Endpoint

/v1/chat/completions

Modello

anthropic/claude-opus-4.8

La configurazione pronta da copiare sopra è l’unico file OpenCode da modificare per il setup consigliato: ~/.config/opencode/opencode.json. Mantieni la API key nell’ambiente shell per non committarla in un repository.

Risoluzione problemi

La API key non viene letta

Esporta WAVESPEED_API_KEY nella stessa shell in cui esegui OpenCode. Se usi un profilo shell, ricarica il terminale prima di avviare l’agent.

Le richieste falliscono con errore di protocollo o endpoint

Controlla che OpenCode usi Chat completions compatibili con OpenAI ed endpoint /v1/chat/completions. Le discrepanze di protocollo sono la causa più comune di errori 404 o payload.

Il modello selezionato non funziona

Conferma che l’ID modello esista in WaveSpeed Models, poi incolla l’ID esatto in ~/.config/opencode/opencode.json. Puoi iniziare dal modello predefinito mostrato in questa pagina.

In Logs non appare alcuna richiesta

Assicurati che OpenCode usi la base URL WaveSpeed e la tua API key attuale. Poi invia un nuovo prompt dall’agent locale e aggiorna Logs.

Questa guida OpenCode può apparire nei motori di ricerca?

Sì. Questa pagina è costruita come guida di setup indicizzabile per utenti che cercano OpenCode custom provider, endpoint compatibile OpenAI, base URL e workflow di configurazione agent locale.