A codificação agêntica está indo além do preenchimento automático: ferramentas modernas podem planejar tarefas, editar vários arquivos, executar comandos e repetir tentativas em caso de falhas até que o resultado realmente funcione. O OpenCode é um agente de codificação open source e agnóstico a modelos que você pode executar no terminal (e também como aplicativo desktop ou extensão de IDE), o que torna uma forma prática de testar esse fluxo de trabalho no seu próprio ambiente.
💡Neste guia, você irá:
- Conectar o Kimi K2.5 ao OpenCode por meio da API da Novita AI
- Ter o OpenCode instalado e pronto para usar na sua interface preferida (terminal/desktop/IDE)
- Construir um pequeno projeto de demonstração.
O que é o OpenCode?
O OpenCode é um agente de codificação de IA open source que você pode executar em vários ambientes de desenvolvimento — mais comumente como interface baseada em terminal (CLI + TUI), mas também como aplicativo desktop ou extensão de IDE.
OpenCode vs Claude Code
O OpenCode e o Claude Code são ambos agentes de codificação de IA baseados em terminal, mas seguem caminhos diferentes.
- OpenCode é um agente open source e agnóstico a provedores: destaca o suporte a “mais de 75 provedores de LLM por meio do Models.dev (incluindo modelos locais)” e se posiciona como uma ferramenta flexível que você pode conectar a diferentes backends de modelos.
- Claude Code, por outro lado, é a CLI oficial da Anthropic focada no Claude — uma ferramenta de linha de comando para acessar modelos Claude no terminal — além de um ecossistema oficial de extensões (plugins) e conexões de ferramentas/dados via MCP.
Tabela de comparação rápida
| Aspecto | OpenCode | Claude Code |
| Posicionamento | Open source, agente de codificação terminal multi-modelo | Agente de codificação terminal oficial da Anthropic focado no Claude |
| Escolha de modelo/provedor | Mais de 75 provedores de LLM por meio do Models.dev, incluindo modelos locais | Construído em torno do Claude; estende-se via MCP + plugins |
| Automação do GitHub | Gatilhos de comentário /opencode ou /oc; executa no runner do GitHub Actions |
Extensões focadas em plugins/MCP (ecossistema oficial) |
| Ponto de entrada de preço | A ferramenta é open source; o custo depende do seu backend de modelo escolhido | Planos do Claude (Pro/Max/Team/Enterprise) |
Por que o Kimi K2.5?
O Kimi K2.5 reúne multimodalidade nativa, execução real de ferramentas e orquestração de agentes em larga escala em um único modelo aberto. Treinado em ~15T tokens mistos de visão e texto, abrange compreensão de imagem/vídeo, geração de código e depuração visual.
Experimente o Kimi M2.5 agora!
Do Kimi
Principais pontos práticos
- Agentes com desempenho superior vs GPT-5.2, Claude 4.5 Opus e Gemini 3 Pro: No gráfico, o Kimi K2.5 lidera nos conjuntos de avaliação agêntica: HLE-Full 50,2, BrowseComp 74,9, DeepSearchQA 77,1. No BrowseComp, o K2.5 está à frente do GPT-5.2 (65,8), Claude 4.5 Opus (57,8) e Gemini 3 Pro (59,2) — útil para tarefas de longo horizonte que exigem navegação, coleta de evidências e refinamento iterativo.
- Codificação em nível de repositório competitiva com vantagem multilíngue: O K2.5 atinge 76,8 no SWE-Bench Verificado e 73,0 no SWE-Bench Multilíngue. Enquanto o Claude 4.5 Opus é ligeiramente superior no Verificado (80,0) e o Gemini 3 Pro também lidera lá (80,9), o K2.5 permanece fortemente competitivo e se destaca em configurações multilíngues — à frente do GPT-5.2 (72,0) e muito à frente do Gemini 3 Pro (65,0) — o que importa para patches de vários arquivos em repositórios de linguagens mistas.
- Compreensão de imagem superior para fluxos de trabalho de desenvolvedores (documentos, diagramas, interfaces): Nos benchmarks de imagem, o K2.5 é consistentemente de primeira linha: MMMU Pro 78,5, MathVision 84,2, OmniDocBench 1.5 88,8 — suportando tarefas práticas como leitura de PDFs técnicos, interpretação de diagramas e conversão de requisitos visuais em código.
- Raciocínio de vídeo que ajuda na iteração real de produtos: Para tarefas de vídeo, o K2.5 registra VideoMMMU 86,6 e LongVideoBench 79,8, indicando compreensão de vídeo de longo contexto mais forte — útil para analisar demonstrações de produtos, depurar gravações de interface ou extrair requisitos de walkthroughs.
Como instalar o OpenCode
O OpenCode oferece algumas opções de instalação. A mais rápida é o script de instalação de uma linha, e a mais portátil é instalar o pacote npm.
macOS / Linux
Recomendado:
curl -fsSL https://opencode.ai/install | bash
Ou (multiplataforma):
npm install -g opencode-ai
# ou
bun add -g opencode-ai
Iniciar:
opencode
Windows
Recomendado:
npm install -g opencode-ai
# ou
bun add -g opencode-ai
curl | bashrequer um ambiente bash (WSL ou Git Bash). No PowerShell/CMD, use npm/bun.
Iniciar:
opencode
Como usar o MiniMax M2.1 no OpenCode
Como obter sua chave de API na Novita AI
- Passo 1: Crie ou faça login na sua conta Acesse
[https://novita.ai](https://novita.ai)e cadastre-se ou faça login. - Passo 2: Acesse o gerenciamento de chaves Após fazer login, encontre “Chaves de API”.
- Passo 3: Crie uma nova chave Clique no botão “Adicionar nova chave”.
- Passo 4: Salve sua chave imediatamente Copie e armazene a chave assim que ela for gerada; geralmente ela é exibida apenas uma vez.
Adicione sua chave de API da Novita ao OpenCode
- Inicie o OpenCode:
opencode
- No prompt do OpenCode, execute:
/connect
- Pesquise e selecione Novita AI, depois cole sua chave de API da Novita.
- Selecione Kimi K2.5 (ID do modelo:
moonshotai/kimi-k2.5).
Pronto — o OpenCode irá rotear as solicitações de agente por meio da API da Novita AI usando o modelo que você selecionou.
Construa seu primeiro projeto: Woolf Stream
Para que a demonstração seja visualmente instantânea (e fácil de compartilhar em capturas de tela), vamos construir um aplicativo web de página única: Woolf Stream. Os usuários enviam uma imagem, escolhem alguns controles criativos, e o aplicativo chama o endpoint de chat compatível com OpenAI da Novita AI com o Kimi K2.5 (suporte a imagem no chat) para gerar prosa de fluxo de consciência apenas textual inspirada em técnicas modernistas do início do século 20 — sem citar ou imitar Virginia Woolf literalmente.
O que vamos construir
- Uma demonstração de página única com Next.js 14 (App Router) com TypeScript + TailwindCSS
- Painel de chave de API (campo de senha + mostrar/ocultar, salvar/limpar para o localStorage; nunca codifique diretamente)
- Envio de imagem por arrastar e soltar (png/jpg) com pré-visualização e conversão de URL de dados base64 no lado do cliente
- Controles:
- Predefinições de comprimento: 150 / 300 / 600 / 1000 palavras
- Controle deslizante de tom: onírico ↔ nítido
- Menu suspenso de foco: sensorial / memória / tempo / olhar social
- Fluxo de geração:
- O botão “Gerar Prosa” fica desativado até que existam chave de API + imagem
- Indicador de carregamento + painel de erro com status HTTP + dicas de solução de problemas
- Saída:
- Um cartão de leitura com a prosa gerada
- Botão de copiar + Baixar .txt
- Sanfona “Mostrar prompt usado” (para transparência e reprodutibilidade)
Alterne para o modo Build e execute
No OpenCode, alterne para o modo Build, depois cole o prompt abaixo.
Prompt
Construa uma demonstração de página única com Next.js 14 (App Router) + TypeScript + TailwindCSS.
Objetivo: O usuário envia uma imagem (png/jpg). O aplicativo envia a imagem para um endpoint de chat compatível com OpenAI (com suporte a imagem no chat) e gera uma bela passagem de prosa de fluxo de consciência inspirada nas técnicas modernistas de Virginia Woolf. A saída é APENAS TEXTO.
Requisitos de API (estritos):
- URL base personalizada compatível com OpenAI: https://api.novita.ai/openai
- Modelo: moonshotai/kimi-k2.5
- O usuário insere sua própria chave de API (campo de senha + mostrar/ocultar). Armazene apenas no localStorage. Nunca codifique diretamente.
- As solicitações incluem Authorization: Bearer {userKey}.
Requisitos de interface:
- Interface com vibe Monet / Nenúfares: paleta de cores pastéis suaves, textura de papel, gradiente de fundo com pinceladas sutis, sombras de brilho suaves, cartões arredondados, pequena animação de ondulação ao passar o mouse. Responsivo para dispositivos móveis.
- Componentes: salvar/limpar chave de API, envio por arrastar e soltar + pré-visualização, controles: comprimento (150/300/600/1000 palavras), controle deslizante de tom (onírico↔nítido), menu suspenso de foco (sensorial/memória/tempo/olhar social), botão Gerar (desativado se faltar chave ou imagem), indicador de carregamento, painel de erro.
- Saída: prosa renderizada em um cartão de leitura + Copiar + Baixar .txt + sanfona “Mostrar prompt usado”.
Chamada multimodal (obrigatória):
- Use POST /v1/chat/completions.
- Envie mensagens onde o conteúdo é um array com AMBOS:
{type:“text”, text:“…instructions…”}
{type:“image_url”, image_url:{url:“data:image/png;base64,…”}}
- Exiba a resposta textual do modelo.
Restrições de escrita (importante):
- Produza prosa ORIGINAL inspirada no fluxo de consciência modernista do início do século 20 (ritmo lírico, interioridade, detalhes sensoriais, saltos associativos, tempo fluido).
- NÃO cite ou reproduza nenhum texto de Woolf. NÃO afirme ser Woolf. Nenhuma linha de pastiche direto.
- Ancoreda à imagem: reflita a composição, a luz, as cores, o clima, o movimento implícito; preserve o posicionamento do sujeito.
- Saída: uma passagem contínua (máximo de 1 a 3 parágrafos). Sem marcadores, sem análise.
Entregar:
- Código completo executável + árvore de arquivos.
- Um wrapper de API que injeta base_url e a chave do usuário.
- Imagem do lado do cliente -> URL de dados base64.
- Erros claros com código de status HTTP e dicas de solução de problemas.
Execute localmente
Após o OpenCode gerar o projeto:
npm install
npm run dev
Abra o URL local impresso pelo Next.js (geralmente http://localhost:3000) e confira:
- A página renderiza com a aparência Monet / Nenúfares
- O salvamento/limpeza da chave de API funciona (armazenada apenas no localStorage), e a alternância mostrar/ocultar funciona corretamente
- O envio por arrastar e soltar funciona, a pré-visualização mostra a imagem selecionada
- O “Gerar Prosa” fica desativado até que existam chave de API + imagem
- A prosa é apenas textual, 1 a 3 parágrafos e claramente ancorada à imagem
- Copiar + Baixar
.txtfuncionam - “Mostrar prompt usado” revela o prompt exato enviado
- Erros (chave inválida / rede) mostram o status HTTP e dicas claras
Demonstração: Woolf Stream
OpenCode além do terminal: Aplicativo desktop + integrações com IDE
O OpenCode é frequentemente usado no terminal, mas você também pode executá-lo como aplicativo Desktop (Beta) ou dentro da sua IDE — e em ambos os casos, você pode continuar usando a API compatível com OpenAI da Novita AI. A interface muda, mas a configuração de modelo/provedor permanece a mesma: selecione minimax/minimax-m2.1.
Aplicativo desktop
A compilação Desktop do OpenCode está disponível para macOS, Windows e Linux. Se você prefere uma interface independente para sessões de agente mais longas, o aplicativo Desktop é uma ótima opção — e ele pode usar a mesma configuração de provedor que você já criou para a Novita AI.
Integrações com IDE
O OpenCode oferece fluxos de integração oficiais para:
- VS Code
- Cursor
- Zed
- Windsurf
- VSCodium
Conclusão
O OpenCode facilita a adoção de fluxos de trabalho agênticos sem se prender a um único fornecedor. Com o Kimi K2.5 na Novita AI, você obtém uma configuração prática para iteração em nível de repositório e tarefas de desenvolvimento multimodais — utilizável a partir do terminal (ou desktop/IDE) com a mesma configuração de API.
Novita AI é uma plataforma de nuvem de IA que oferece aos desenvolvedores uma forma fácil de implantar modelos de IA usando nossa API simples, além de fornecer GPU cloud acessível e confiável para construir e escalar.
Perguntas frequentes
O que é o OpenCode?
O OpenCode é uma estrutura de agente de codificação de IA open source que permite que LLMs escrevam, executem e depurem código dentro de um ambiente de desenvolvimento real, acelerando construções de ponta a ponta.
Quem é o proprietário do OpenCode?
O OpenCode não pertence a um grande laboratório de IA como Claude ou Gemini. É um projeto open source mantido pela equipe/comunidade do OpenCode, com desenvolvimento liderado pelos criadores por trás do opencode.ai. Não há um “proprietário de modelo” proprietário — o projeto foi projetado para ser agnóstico a provedores e independente de qualquer fornecedor de LLM único.
O OpenCode é melhor que o Claude?
O OpenCode não é estritamente “melhor” que o Claude Code — é diferente. O OpenCode é open source e agnóstico a modelos, tornando-o uma escolha melhor se você quer flexibilidade e a liberdade de executar vários modelos (como o Kimi K2.5 por meio da Novita AI) em um único fluxo de trabalho de agente, enquanto o Claude Code é a CLI oficial da Anthropic focada no Claude que oferece a experiência mais fluida se você estiver totalmente comprometido com o ecossistema Claude.
O OpenCode é seguro?
Sim, o OpenCode não armazena nenhum de seu código ou dados de contexto, para que possa operar em ambientes sensíveis à privacidade.
O OpenCode é gratuito？
O OpenCode é uma daquelas ferramentas open source raras que fazem você parar para pensar. Atualmente está no topo do GitHub com mais de 80k estrelas — e depois de experimentar, o momentum faz sentido. Pense nele como um agente de codificação de IA na mesma linha do Claude Code, mas totalmente gratuito e open source.
