OpenCode

OpenCode é um agente de programação open source para o terminal. Um único comando faz o login dele na Synthorai: o OpenCode ganha uma chave de API própria e um provider Synthorai com os modelos que essa chave pode chamar. Não é preciso copiar chave nem editar arquivo de configuração.

Passo 1 - Fazer login

opencode auth login https://synthorai.io

O OpenCode lê https://synthorai.io/.well-known/opencode e executa o comando de login indicado ali. Esse comando mostra um link e um código de 8 letras, como BCDF-GHJK, e abre o navegador.

Entre no console, confira se o código da página é o mesmo do terminal, escolha a validade da chave (7, 30 ou 90 dias; o padrão é 90) e clique em Permitir. O terminal mostra Signed in e o OpenCode guarda a nova chave.

Via SSH, o comando não abre navegador: abra o link em outro dispositivo e faça login por lá. Para ter o mesmo comportamento na sua máquina, defina SYNTHORAI_NO_BROWSER=1.

Passo 2 - Escolher um modelo

opencode
# then, inside OpenCode:
/models

Abra o OpenCode e digite /models. O provider Synthorai lista os modelos que sua chave pode chamar, com limite de contexto e preço. O OpenCode atualiza a lista toda vez que inicia.

Cada modelo é chamado pelo protocolo adequado, sem nada para configurar: modelos Claude usam a Anthropic Messages API (o prompt caching continua funcionando), modelos OpenAI usam a Responses API e os demais usam Chat Completions.

A chave usada pelo OpenCode

A chave aparece na página Chaves de API do console como OpenCode · …, seguida do local de onde você fez login, com o rótulo Login de agente. Você pode excluí-la por lá a qualquer momento.

Quando a chave expira, as chamadas falham com uma mensagem pedindo que você execute opencode auth login https://synthorai.io de novo.

Segurança

• Aprove apenas um código que você mesmo iniciou. Se o pedido de login vier de uma rede diferente da do seu navegador, a página de confirmação avisa.
• Se o workspace estiver com Aprovação de novos IPs ativado (Configurações › Segurança), o endereço de onde você entrou passa a ser automaticamente um endereço confiável da nova chave quando você permite o login a partir da mesma rede, e chamadas de qualquer outro endereço aguardam aprovação. Se você permitir a partir de outra rede, o endereço não fica confiável: aprove-o quando a primeira chamada dele for retida. Se a opção estiver desativada, considere ativá-la.

A configuração local prevalece

Se o seu opencode.json local definir um provider chamado synthorai, o OpenCode usa esse no lugar do que vem do gateway, porque a configuração local prevalece sobre a remota.

Configuração manual (Windows sem sh)

Crie uma chave na página Chaves de API do console, coloque-a na variável de ambiente SYNTHORAI_API_KEY e adicione este provider ao opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "synthorai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Synthorai",
      "options": {
        "baseURL": "https://synthorai.io/v1",
        "apiKey": "{env:SYNTHORAI_API_KEY}"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" }
      }
    }
  }
}

Liste em models cada modelo que você quer poder escolher no OpenCode. Os IDs estão na página de modelos.

Solução de problemas

Failed to load auth provider metadata Confira o endereço: é https://synthorai.io, sem nenhum caminho depois.

Sign-in did not complete: the login was declined in the console O pedido foi recusado na página de confirmação. Execute o comando de novo para recomeçar.

O código expirou Os códigos valem por 10 minutos. Execute opencode auth login https://synthorai.io de novo para receber um novo.

Para limites, validade e exclusão de chaves, veja Chaves de API.