Nota do autor: OpenCode é um assistente de programação de IA de código aberto baseado em terminal, compatível com Claude, OpenAI, Gemini e diversos outros modelos de linguagem grandes. Este artigo oferece um tutorial completo de instalação, configuração e uso para ajudar novos usuários a dominarem rapidamente essa ferramenta, na qual mais de 650 mil desenvolvedores já confiam.
Quer usar IA para auxiliar na sua programação direto no terminal, mas não quer ficar preso a um único fornecedor? O OpenCode é atualmente a solução de código aberto mais popular, com mais de 70 mil estrelas no GitHub e utilizada mensalmente por mais de 650 mil desenvolvedores.
Valor central: Ao ler este artigo, você aprenderá a instalar e configurar o OpenCode, conectar-se a vários modelos de IA e dominar as funções mais úteis para o desenvolvimento diário.
Pontos Principais do Assistente de Programação OpenCode AI
| Ponto | Descrição | Valor |
|---|---|---|
| Totalmente Open Source | Licença MIT, código hospedado no GitHub | Gratuito para usar e fácil de personalizar |
| Suporte Multimodelo | Claude, OpenAI, Gemini, modelos locais | Flexibilidade para escolher a melhor IA |
| Privacidade em 1º Lugar | Não armazena código, suporte para execução local | Ideal para empresas e projetos sensíveis |
| Nativo do Terminal | Interface TUI refinada, comandos estilo Vim | Mais eficiência sem precisar sair do terminal |
| Colaboração Multiplataforma | Arquitetura cliente/servidor | Suporte para execução remota e controle via mobile |
O que é o OpenCode
O OpenCode é um assistente de programação de IA por linha de comando desenvolvido em linguagem Go. Diferente de ferramentas comerciais como Claude Code ou Cursor, o OpenCode é totalmente open source, permitindo que os desenvolvedores escolham livremente seus provedores de IA — seja Claude, OpenAI, Google Gemini ou até modelos de código aberto rodando localmente.
Ele utiliza o framework Bubble Tea para criar uma interface de usuário de terminal (TUI) elegante, proporcionando uma experiência de interação fluida. Você pode usá-lo dentro do VS Code, Cursor ou qualquer IDE que suporte terminal.
Vantagens do OpenCode
Privacidade e Segurança: Por padrão, o OpenCode não envia seu código para servidores remotos. Você tem controle total sobre a escolha do provedor do modelo e o escopo do compartilhamento de dados. Se optar por modelos locais, todo o fluxo de trabalho permanece privado.
Escolha Flexível de Modelos: Embora o serviço oficial recomende o OpenCode Zen, você é livre para conectar qualquer serviço de IA compatível. Através de plataformas agregadoras como a APIYI, você pode usar uma interface única para chamar diversos modelos como Claude, GPT e Gemini.
Guia de Instalação e Configuração do OpenCode
Métodos de Instalação
O OpenCode suporta vários métodos de instalação. Escolha o mais adequado para o seu sistema:
| Plataforma | Comando de Instalação | Descrição |
|---|---|---|
| Instalação Automática | curl -fsSL https://opencode.ai/install | bash |
Recomendado, detecta automaticamente o sistema |
| npm | npm i -g opencode-ai@latest |
Preferência para usuários de Node.js |
| Homebrew | brew install opencode-ai/tap/opencode |
Usuários de macOS/Linux |
| Scoop | scoop install opencode |
Usuários de Windows |
| Chocolatey | choco install opencode |
Alternativa para Windows |
Fluxo de Configuração Rápida
Após a instalação, siga estes passos para configurar:
Passo 1: Iniciar o OpenCode
# Entre no diretório do seu projeto
cd seu-projeto
# Inicie o OpenCode
opencode
Passo 2: Conectar ao provedor de IA
No terminal do OpenCode, execute o comando /connect, selecione o seu provedor de serviços de IA e conclua a autenticação.
Passo 3: Inicializar o projeto
Execute o comando /init. O OpenCode analisará a estrutura da sua base de código e gerará o arquivo de configuração AGENTS.md, ajudando a IA a entender melhor o contexto do projeto.
Exemplo Minimalista
Aqui está um exemplo de configuração usando o APIYI para acessar o OpenCode:
# Configurar variáveis de ambiente
export OPENAI_API_KEY="sua-chave-apiyi"
export OPENAI_API_BASE="https://vip.apiyi.com/v1"
# Inicie o OpenCode
opencode
Ver exemplo completo de arquivo de configuração
{
"providers": {
"apiyi": {
"apiKey": "sua-chave-apiyi",
"baseURL": "https://vip.apiyi.com/v1",
"models": [
"claude-sonnet-4-20250514",
"gpt-4o",
"gemini-2.0-flash"
]
}
},
"defaultProvider": "apiyi",
"defaultModel": "claude-sonnet-4-20250514"
}
Localização do arquivo de configuração:
- macOS/Linux:
~/.config/opencode/config.json - Windows:
%APPDATA%\opencode\config.json
Sugestão de configuração: Obtenha sua API Key através da plataforma APIYI (apiyi.com). Você pode usar uma interface única para chamar os principais modelos como Claude, GPT e Gemini, sem a necessidade de registrar múltiplas contas em diferentes provedores.
Explicação Detalhada das Funcionalidades Principais do OpenCode
Troca de Modos Duplos
O OpenCode oferece dois modos de trabalho integrados, você pode alternar entre eles pressionando a tecla Tab:
| Modo | Função | Cenários de Uso |
|---|---|---|
| Modo Build | Permissões totais de leitura e escrita, pode modificar arquivos | Desenvolvimento real, modificação de código |
| Modo Plan | Modo somente leitura, apenas analisa sem modificar | Revisão de código, exploração de bases de código desconhecidas |
Características do Modo Plan:
- Recusa operações de edição de arquivos por padrão
- Requer confirmação antes de executar comandos bash
- Ideal para entender a lógica do código antes de começar a modificar
Sintaxe de Referência de Arquivo
Use o símbolo @ para referenciar arquivos específicos, permitindo que a IA obtenha um contexto mais preciso:
@src/components/Button.tsx a definição de tipos das props deste componente está com problema, me ajude a corrigir
Comandos Comuns
| Comando | Função |
|---|---|
/init |
Inicializar projeto, gerar AGENTS.md |
/connect |
Conectar ou trocar provedor de IA |
/undo |
Desfazer última modificação |
/redo |
Refazer modificação desfeita |
/share |
Gerar link de compartilhamento da conversa |
/clear |
Limpar sessão atual |
Comandos Personalizados
O OpenCode suporta a criação de comandos personalizados, salvando seus comandos frequentes como arquivos Markdown:
<!-- ~/.config/opencode/commands/review.md -->
Por favor, faça uma revisão de código do arquivo atual, focando nos seguintes aspectos:
1. Problemas potenciais de desempenho
2. Vulnerabilidades de segurança
3. Legibilidade do código
4. Conformidade com as melhores práticas
Após salvar, execute /review no OpenCode para chamá-lo.
Recursos Avançados do OpenCode
Integração com GitHub
O OpenCode pode ser integrado diretamente ao fluxo de trabalho do GitHub. Você pode acioná-lo usando /opencode ou /oc em comentários de PRs (Pull Requests) ou Issues:
- Análise de problemas: Deixe o OpenCode interpretar e analisar as Issues para você.
- Correção automática: O OpenCode trabalha em uma nova branch e, ao finalizar, abre um PR automaticamente.
- Execução segura: Todas as operações são executadas de forma isolada dentro de um GitHub Actions Runner.
Integração com LSP
O OpenCode suporta o protocolo LSP (Language Server Protocol), oferecendo:
- Sugestões inteligentes de código para múltiplas linguagens.
- Diagnóstico de erros em tempo real.
- Monitoramento automático de alterações nos arquivos.
Suporte ao protocolo MCP
O OpenCode suporta o Model Context Protocol (MCP), permitindo que você adicione servidores MCP personalizados para expandir os limites das suas funcionalidades.
Dicas de Uso do OpenCode
Sugestões para um Fluxo de Trabalho Eficiente
| Cenário | Prática Recomendada |
|---|---|
| Explorar novos projetos | Use o modo Plan primeiro para entender a arquitetura |
| Corrigir Bugs | Use @ para referenciar os arquivos relevantes |
| Refatorar código | Faça o processo passo a passo, usando /undo para confirmar cada etapa |
| Revisão de código | Alterne para o modo Plan para uma análise apenas de leitura |
Melhores Práticas
- Aproveite o modo Plan: Quando estiver em dúvida, use o modo apenas de leitura para explorar o código e evitar modificações acidentais.
- Referencie arquivos com precisão: Use
@nome_do_arquivopara fornecer o contexto exato à IA, garantindo resultados mais assertivos. - Divida tarefas complexas: Decomponha grandes tarefas em etapas menores e confirme o progresso de cada uma antes de continuar.
- Use o
/initregularmente: Sempre que a estrutura do projeto sofrer alterações significativas, reinicialize para manter o contexto sincronizado.
Perguntas Frequentes
Q1: Quais modelos de IA o OpenCode suporta?
O OpenCode suporta os principais provedores de IA, incluindo OpenAI (série GPT), Anthropic (série Claude), Google (série Gemini), AWS Bedrock, Groq, Azure OpenAI, entre outros, além de modelos de código aberto executados localmente.
Q2: Como posso testar e comparar vários modelos ao mesmo tempo?
Recomendamos usar plataformas agregadoras como o APIYI (apiyi.com). Através de uma interface única compatível com OpenAI, você pode alternar entre diferentes modelos apenas mudando o parâmetro model, permitindo comparar rapidamente o desempenho do Claude, GPT e Gemini.
Q3: O meu código será enviado para a nuvem pelo OpenCode?
Isso depende do provedor de IA que você escolher. Se estiver usando um modelo local, o código não sairá do seu computador. Ao utilizar serviços na nuvem, o código é enviado ao respectivo provedor para processamento, mas o OpenCode em si não armazena nenhum dado do seu código.
Q4: Como começar a testar rapidamente?
A melhor forma é usar uma plataforma agregadora de APIs que suporte múltiplos modelos:
- Acesse o APIYI (apiyi.com) e crie uma conta.
- Obtenha sua API Key e aproveite os créditos gratuitos.
- Configure as variáveis de ambiente conforme os exemplos deste artigo.
- Execute
opencodepara começar.
Resumo
Pontos principais do assistente de programação OpenCode AI:
- Código Aberto e Gratuito: Licença MIT, mais de 70 mil estrelas no GitHub e a confiança de mais de 650 mil desenvolvedores.
- Flexibilidade de Modelos: Suporte aos principais modelos do mercado (Claude, OpenAI, Gemini, etc.) com troca simplificada.
- Privacidade sob Controle: O código não passa pelos servidores do OpenCode; suporte a modelos locais para operação totalmente offline.
- Eficiente e Intuitivo: Experiência nativa no terminal, troca entre modos de operação e alta capacidade de customização.
Para desenvolvedores que buscam o auxílio de um Modelo de Linguagem Grande diretamente no terminal, o OpenCode é atualmente uma das soluções de código aberto mais robustas e recomendadas.
Experimente a facilidade de alternar entre modelos através do APIYI (apiyi.com), que oferece créditos gratuitos e uma interface unificada para os formatos nativos da OpenAI, Claude e Gemini.
📚 Referências
⚠️ Nota sobre o formato dos links: Todos os links externos utilizam o formato
Nome: domain.com. Isso facilita a cópia, mas os links não são clicáveis para evitar a perda de autoridade de SEO.
-
Site Oficial do OpenCode: Site oficial do projeto, oferece downloads do instalador e documentação.
- Link:
opencode.ai - Descrição: Obtenha a versão mais recente e tutoriais oficiais.
- Link:
-
Repositório GitHub do OpenCode: Código-fonte aberto e discussões via Issues.
- Link:
github.com/opencode-ai/opencode - Descrição: Visualize o código-fonte e envie relatórios de bugs (feedbacks).
- Link:
-
Documentação Oficial do OpenCode: Guia detalhado de configuração e uso.
- Link:
opencode.ai/docs - Descrição: Explore a fundo as funcionalidades avançadas e opções de configuração.
- Link:
-
Plataforma de Desenvolvedores APIYI: Serviço de agregação de APIs multimodelo.
- Link:
apiyi.com - Descrição: Obtenha uma interface unificada para chamar modelos como Claude, GPT, Gemini, entre outros.
- Link:
Autor: Equipe Técnica
Troca de Conhecimento: Sinta-se à vontade para discutir na seção de comentários. Para mais materiais, visite a comunidade técnica da APIYI em apiyi.com.
