VT Code versus OpenCode: workflow, modelos e custo total

VT Code e OpenCode são agentes de programação para terminal gratuitos que não cobram nada pelo cliente e ambos aceitam seu próprio endpoint compatível com OpenAI, portanto esta não é uma comparação de preços. As diferenças reais estão em onde cada um permite declarar esse endpoint, para que lado apontam os padrões de permissão e se você quer uma assinatura de US$ 10 por mês na mesma caixa. O VT Code é um único binário Rust de um projeto independente liderado por um mantenedor. O OpenCode é um agente TypeScript da empresa Anomaly, com aplicativo para desktop, extensões de editor e duas carteiras próprias de primeira parte.

Duas armadilhas de nomes precisam ser esclarecidas primeiro, porque errar qualquer uma delas invalida tudo o que vem depois. "VT Code" não é o Visual Studio Code, e o VT Code, de forma confusa, oferece sua própria extensão complementar para VS Code em uma série de versões separada. E três coisas diferentes são chamadas de OpenCode — apenas uma delas está nesta comparação.

O que você está realmente comparando

Metadados do repositório, versões e dist-tags lidos da API do GitHub, de npm e do crates.io em 21 de setembro de 2026. Uma quarta colisão: "OpenCode Go" também é o nome do plano de assinatura de US$ 10 por mês da Anomaly, que não tem relação alguma com a linguagem Go ou com a CLI Go arquivada — e o VT Code piora isso ao nomear uma de suas chaves de provedor integradas como opencode-go. Observe também a rapidez com que a versão do VT Code muda: 0.164.0, 0.164.2 e 0.165.0 foram lançadas em cerca de 27 horas entre 20 e 21 de setembro; portanto, leia a tag em vez de confiar em uma versão impressa em qualquer página, inclusive nesta.

Quem deve escolher qual

Sobre o custo da migração. A metade barata é AGENTS.md: ambas as ferramentas o leem na raiz do projeto, portanto o arquivo que descreve suas convenções sobrevive intacto a uma mudança em qualquer direção. A metade cara é todo o resto. Os dois formatos de configuração são distintos — TOML com tabelas de tabelas contra JSON nomeando um pacote npm por provedor — e não há conversor, portanto uma configuração local do projeto é reescrita manualmente. Se definições MCP, skills, plugins, agentes personalizados ou histórico de sessões são transferidos é algo que esta página não estabeleceu; por isso, ela não estima o tempo de migração além dessa reescrita.

A única assimetria que vale a decisão: onde o endpoint pode ficar

Esta é a diferença que nenhum modelo genérico menciona, e ela inverte o instinto habitual de monorepo. O OpenCode trata um provedor personalizado como dado comum do projeto: um opencode.json confirmado funciona, que é como uma equipe padroniza todos em um gateway por meio de um único arquivo revisado. O VT Code recusa isso deliberadamente.

A referência dos campos de configuração do VT Code declara isso no próprio campo: "Valores não vazios provenientes das camadas de workspace/projeto controladas pelo repositório são rejeitados; defina endpoints de provedores no sistema/usuário confiável ou em uma configuração selecionada explicitamente." A mesma rejeição é repetida em custom_providers[].base_url, em custom_providers[].auth.command e em provider_overrides.*.base_url e .api_key_env. Seu modelo de segurança identifica o motivo como uma camada própria — o carregador registra a origem vencedora de cada campo mesclado, trata arquivos na raiz do workspace, arquivos .vtcode/ do workspace e perfis de projeto como controlados pelo repositório, e falha de forma fechada antes da validação do provedor, o que, segundo ele, impede um repositório de introduzir o auth.command executável de um provedor personalizado ou redirecionar solicitações por meio de uma base URL substituída.

Assim, a consequência prática é: com o OpenCode, uma única pull request mesclada aponta toda a equipe para um gateway. Com o VT Code, a mesma mudança é uma instalação por máquina na configuração do usuário ou do sistema, ou um caminho --config passado na inicialização. Essa é uma troca genuína — uma opção é conveniência de implantação, a outra é controle da cadeia de suprimentos — e qualquer uma que você prefira é um motivo mais forte para escolher um cliente aqui do que qualquer lista de recursos. Ambos os fatos foram lidos de main em 21 de setembro de 2026.

Permissões, autonomia e as superfícies oferecidas por cada um

Fontes: a referência dos campos de configuração, o modelo de segurança e o guia de provedores do VT Code; e a documentação de permissões, provedores, servidor e ACP do OpenCode. Tudo foi consultado em 21 de setembro de 2026, e tudo descreve padrões — qualquer cliente pode ser reconfigurado na direção oposta. Ambos falam ACP e ambos oferecem suporte a MCP, portanto o acesso por editores é quase equivalente, não um diferencial.

É na carteira, não no cliente, que o dinheiro é gasto

O OpenCode vende duas coisas próprias. O VT Code não vende nada, o que por si só é um fator de decisão: cada token enviado é cobrado por quem você configurou, e não há um plano de primeira parte ao qual recorrer.

Preços e cotas lidos da própria documentação do OpenCode em 21 de setembro de 2026. Duas coisas que vale saber antes de compará-los. O Go publica termos de dados por modelo que não são uniformes — a maioria das linhas diz que o treinamento do modelo não é usado e que a retenção é de zero dias, enquanto algumas informam retenção de 30 dias e dois modelos de colaboradores são marcados como usados para treinamento e sem retenção zero — portanto, verifique a linha do modelo que pretende usar. E o Zen publica descontinuações datadas, então uma comparação ancorada em um único ID de modelo pode ficar desatualizada mais rápido do que a página em que aparece. OpenCode Enterprise é um formulário de contato sem preço publicado, e esta página não cita nenhum.

Quanto custa uma sessão no seu próprio endpoint

Os números abaixo são cálculos ilustrativos de tokens, não custos medidos de tarefas nem um teto de cobrança. Suponha uma sessão de agente que envia 200,000 tokens de entrada não armazenados em cache e recebe 15,000 tokens de saída — uma suposição para comparação, não uma medição do seu repositório. As tarifas são preços atuais do catálogo da Kunavo por milhão de tokens; a última coluna simplesmente divide, portanto herda todas as suposições anteriores.

Compare essa última coluna com os US$ 10 por mês do OpenCode Go e depois resista à tentação de tratá-la como um veredito. As duas coisas não são a mesma unidade: os limites do Go são denominados em dólares de uso no conjunto de modelos dele, não em dólares que você gasta, e os dois conjuntos se sobrepõem apenas parcialmente — GPT 5.6 Luna está na lista publicada do Go, enquanto as linhas de Claude e Gemini na tabela acima não estão. Uma assinatura também compra previsibilidade, não uma tarifa. O que a tabela estabelece é o formato da pergunta — se seu trabalho consiste em algumas sessões longas por semana em um modelo barato, tokens medidos chegam primeiro; se é uso intenso durante todo o dia em modelos que o Go realmente oferece, um plano fixo deixa de ser obviamente pior. Meça suas próprias sessões antes de escolher, porque um modelo que precisa de uma segunda tentativa elimina imediatamente uma vantagem de tarifa.

O valor do catálogo da Kunavo é um piso de cobrança, não um teto: quando o upstream informa sua cobrança, a conta é o maior entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável. As cobranças de cache e as ferramentas externas ficam fora deste exemplo. O recarregamento mínimo é de $10 em crédito pré-pago — um mínimo de financiamento, não uma taxa de tarefa ou uma assinatura. Consulte detalhes de cobrança.

Apontando qualquer um dos dois para seu próprio endpoint

O lado do VT Code é um bloco [[custom_providers]], e a regra de posicionamento da seção acima é a parte que as pessoas entendem errado:

# This block is rejected if it arrives from a repository-controlled
# layer. Put it in your user config, in the Unix system layer
# (/etc/vtcode/vtcode.toml), or pass it with --config / VTCODE_CONFIG_PATH.
[[custom_providers]]
name = "kunavo"
display_name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
api_key_env = "KUNAVO_API_KEY"
api_format = "openai-chat"
model = "claude-sonnet-5"
models = ["claude-sonnet-5", "claude-haiku-4-5"]
context_window = 1000000   # omit this and VT Code assumes 128000

Quatro observações sobre esse bloco, todas provenientes do guia de provedores e da referência dos campos. A chave é lida da variável de ambiente nomeada em api_key_env, e a documentação de configuração traz um aviso explícito para nunca colocar chaves de API em vtcode.toml. api_format aceita auto, openai-chat, openai-responses ou anthropic-messages — um valor explícito é respeitado em vez de sofrer fallback silencioso — e a rota Anthropic merece uma análise separada porque as duas convenções de URL base diferem, como explica a referência da URL base. Definir context_window é importante: omita-o e o provedor assumirá 128.000 tokens, limitando silenciosamente a compactação e as verificações preliminares em um contexto muito maior. O VT Code também aplica restrições de amostragem da OpenAI baseadas no nome aos endpoints personalizados — um ID de modelo correspondente a gpt-6-astra, por exemplo, nunca recebe temperature ou top_p — e o próprio guia recomenda "preferir IDs de modelo neutros nos gateways se você precisar de valores fixos para esses nomes".

O equivalente do OpenCode é um arquivo de dados, e o campo npm é o que escolhe o formato de protocolo — @ai-sdk/openai-compatible para um endpoint que oferece /v1/chat/completions, @ai-sdk/openai para /v1/responses:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "kunavo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Kunavo",
      "options": {
        "baseURL": "https://api.kunavo.com/v1",
        "apiKey": "{env:KUNAVO_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5",
          "limit": { "context": 1000000, "output": 128000 }
        }
      }
    }
  }
}

O OpenCode também pode substituir o baseURL de um provedor integrado em vez de declarar um personalizado; a documentação descreve os metadados de modelos para provedores conhecidos como provenientes de Models.dev — portanto, um provedor declarado manualmente precisa fornecer seu próprio limit — e as chaves adicionadas pelo comando /connect são gravadas em ~/.local/share/opencode/auth.json. A Kunavo publica uma página de configuração para este cliente: o guia de integração do OpenCode. Não há uma página de integração do VT Code aqui, e o bloco TOML acima é uma referência de configuração montada a partir das definições documentadas dos campos do VT Code — nenhum dos clientes foi testado em runtime contra a Kunavo, e nenhuma compatibilidade é declarada para qualquer um deles. Mantenha uma rota funcional disponível, execute uma tarefa delimitada e leia a cobrança registrada na sua conta antes de trocar seu cliente principal diário. Crie uma conta Kunavo quando estiver pronto para financiar uma chave.

Um aviso de instalação que pode custar tempo de verdade. O pacote npm público chamado vtcode não é o VT Code atual: sua dist-tag latest era 0.52.8, publicada em 24 de dezembro de 2025, enquanto o crates.io estava na versão 0.165.0 em 21 de setembro de 2026. A documentação de instalação do VT Code indica um caminho npm diferente — npm install -g @vinhnx/vtcode --registry=https://npm.pkg.github.com — além de cargo install vtcode e de um tap do Homebrew que exige brew trust vinhnx/tap antes de brew install vinhnx/tap/vtcode. A mesma documentação alerta que os artefatos para Windows são fornecidos “best-effort” e podem não aparecer em todos os lançamentos, enquanto a própria página de instalação do OpenCode recomenda WSL no Windows — portanto, nenhum dos dois é uma ferramenta de primeira classe para Windows com base em sua própria documentação.

Comparando opções mais distantes? Crush vs OpenCode compara o mesmo OpenCode com o agente da Charm, preços do OpenCode aprofunda-se no Zen e no Go, e a referência da API compatível com OpenAI cobre a convenção de endpoint da qual ambos os clientes dependem.

Perguntas frequentes

Verificado em 21 de setembro de 2026: a API do GitHub para os três repositórios, além da lista de releases do VT Code; as dist-tags do npm para opencode-ai, @opencode/cli e vtcode; o registro do crates.io para vtcode; o README, o modelo de segurança, o guia de provedores, a referência dos campos de configuração, a documentação de instalação e o manifesto da extensão do VS Code do VT Code em main; e as páginas de permissões, provedores, servidor, Zen, Go e download do OpenCode. As tarifas de tokens da Kunavo vêm do catálogo ativo. Nenhum dos dois clientes foi instalado, executado ou apontado para um endpoint da Kunavo nesta página; nenhuma comparação de benchmark ou desempenho foi feita, e nenhuma é afirmada; cada valor em dólares aqui é uma aritmética ilustrativa de tokens, não um custo de tarefa medido.