Gemini 4 Argon no OpenCode: configuração e limites atuais

Você pode configurar o Gemini 4 Argon no OpenCode pelo provedor nativo do Google. A pergunta útil é o que acontece depois da primeira resposta: o cliente preserva as partes assinadas, devolve os resultados das ferramentas corretamente e reconhece uma resposta de continuação? Nossa verificação offline do OpenCode v1.19.0 mostrou que o texto e as mensagens de ferramentas são tratados corretamente, mas também identificou falhas na continuação de saídas longas e nos fluxos interrompidos.

Este guia apresenta uma configuração inicial e os limites exatos do que foi demonstrado. Ele não comprova uma integração completa entre o SeedRouter e um agente de programação, testada com chamadas reais. Para um cliente mais simples, com uma requisição iniciada de forma consciente a cada turno, use o tutorial de conversa em Python.

Configurar o Gemini 4 Argon no OpenCode

Confira a versão instalada com opencode --version. Os resultados abaixo se aplicam à versão publicada v1.19.0, testada em 14 de outubro de 2026. Uma versão mais recente precisa de sua própria verificação; a presença de um recurso em um ramo de desenvolvimento não prova que uma versão instalada oferece suporte a ele.^[1]

Crie uma pasta de projeto vazia para a primeira verificação. Baixe a configuração do OpenCode nessa pasta. A seção de conexão é:

{
  "provider": {
    "google": {
      "npm": "@ai-sdk/google",
      "options": {
        "apiKey": "{env:SEEDROUTER_API_KEY}",
        "baseURL": "https://api.seedrouter.ai/v1beta"
      },
      "models": {
        "gemini-4-argon": {
          "name": "Gemini 4 Argon",
          "reasoning": true,
          "tool_call": true,
          "limit": { "context": 1048576, "output": 4096 },
          "options": {
            "thinkingConfig": { "thinkingLevel": "low", "includeThoughts": true }
          }
        }
      }
    }
  }
}

O OpenCode permite substituir variáveis de ambiente nos arquivos de configuração.^[2] Defina SEEDROUTER_API_KEY no seu shell sem incluir a chave nos commits do projeto. O arquivo baixado também seleciona google/gemini-4-argon, desativa o compartilhamento e as atualizações automáticas e permite apenas a ferramenta read. Revise essas permissões antes de usar um repositório existente. As opções reasoning e tool_call descrevem o comportamento do cliente; elas não provam que determinada conta ou serviço oferece suporte a todas as operações.

O valor de saída 4096 é um orçamento inicial escolhido deliberadamente para essa configuração, não o máximo oficial do Argon. O raciocínio também consome esse orçamento. Consulte a referência da API para ver as regras de contexto, saída e continuação.

Começar com uma requisição curta

Depois de revisar a configuração e as tarifas atuais, execute:

OPENCODE_CONFIG="$PWD/gemini-4-argon-opencode.json" \
OPENCODE_DISABLE_MODELS_FETCH=1 \
OPENCODE_DISABLE_AUTOCOMPACT=1 \
opencode run --model google/gemini-4-argon \
  "Explain a mutex in one sentence. Do not use tools."

Com a sua chave, esse comando envia uma requisição real ao modelo. O OpenCode pode repetir requisições que falharam ou enviar outras durante a execução de um agente: o comando não garante que o gasto fique limitado a uma única chamada. Interrompa o processo se a resposta estiver incompleta ou as requisições se repetirem. Para manter um controle estritamente manual, use o exemplo em Python.

O caminho da requisição nativa deve terminar em gemini-4-argon:streamGenerateContent?alt=sse. Na versão testada, o provedor do Google enviou a credencial em x-goog-api-key. Isso difere dos exemplos cURL com cabeçalho Bearer do tutorial geral da API; selecionar um provedor genérico da OpenAI não produz a mesma requisição nativa.

O que as verificações offline demonstraram

O teste usou a CLI publicada, uma API simulada localmente e credenciais fictícias. Foram feitas 17 requisições à interface de loopback em oito cenários. Nenhum modelo gerou as respostas, e os valores de tokens informados eram artificiais. Essas observações descrevem o cliente, não a qualidade do modelo nem a cobrança real.

Cenário	Comportamento observado na versão v1.19.0
Fluxo de texto nativo	Combinou eventos de texto separados para formar a resposta esperada
Segundo turno de conversa	Preservou as assinaturas de raciocínio e texto usadas no teste nas partes do modelo
Chamada da ferramenta de leitura e retorno do resultado	Leu um arquivo temporário de teste e devolveu seu conteúdo em `functionResponse`
`MAX_TOKENS`	Indicou uma interrupção pelo limite de tamanho sem outra requisição naquele caso de teste
HTTP 400	Encerrou com um erro sem repetir a requisição naquele caso de teste
HTTP 429	Repetiu a requisição uma vez e recebeu uma resposta simulada de sucesso

O teste confirma que thinkingConfig foi enviado. Ele não prova que um serviço real respeitou essa configuração. Da mesma forma, transmitir uma assinatura sintética pelo histórico não permite concluir que uma assinatura real será aceita em uma requisição posterior.

Por que saídas longas exigem verificações adicionais

A resposta CONTINUATION do Argon exige a requisição original e o valor mais recente do campo de nível superior continuationToken. Ao retomar essa geração, a saída parcial não deve ser acrescentada ao histórico normal da conversa.^[3]

No nosso caso de teste, o OpenCode v1.19.0 classificou CONTINUATION como desconhecido. A requisição seguinte omitiu o token e acrescentou a resposta parcial ao histórico. Quando um fluxo terminou após uma saída parcial sem um evento de término, o cliente também enviou requisições comuns adicionais. O serviço simulado interrompeu esse cenário após seis chamadas; isso não demonstra que o limite de novas tentativas do cliente seja seis.

Portanto, essa configuração não é uma solução verificada para a decodificação longa do Argon. Uma resposta curta bem-sucedida não resolve esses casos. Antes de depender de sessões longas de programação, repita as verificações relevantes com a versão exata do cliente que você pretende usar.

Perguntas sobre a configuração do OpenCode

Isso inclui verificações reais de ferramentas e cobrança?

Não. O streaming básico de texto do SeedRouter passou por uma verificação local de ponta a ponta separada, mas esse teste do OpenCode usou respostas simuladas. A seleção real de ferramentas, as assinaturas, a mídia, as permissões da conta e a cobrança ainda precisam de verificações próprias.

Posso usar uma configuração compatível com OpenAI no lugar desta?

Esse é outro protocolo, com um escopo de compatibilidade diferente. Este guia verifica conteúdo nativo e assinaturas do Gemini. A documentação de decodificação longa do Google exclui seu endpoint compatível com OpenAI desse recurso.^[3]

Desativar a compactação automática também desativa novas tentativas?

Não. A compactação e a repetição de requisições são comportamentos distintos. A opção de ambiente no exemplo não garante um limite rígido para o número de requisições nem para o custo.

Decidir o que verificar em seguida

Para usar o Gemini 4 Argon no OpenCode, comece com uma troca curta de texto e depois verifique o comportamento específico das ferramentas e do histórico de que seu trabalho precisa. Trate a continuação e os fluxos interrompidos como casos de aceitação separados. Mantenha a página do modelo e a referência da API nativa junto da configuração do cliente para facilitar a consulta aos detalhes do protocolo e aos preços atuais.