OpenCode: OpenCode First Use

Última atualização: 2026-08-31

--- title: Primeiro Uso do OpenCode description: Do zero, experimente o OpenCode completando a primeira conversa, análise de código e modificação de arquivos order: 5 lang: pt-br

Após instalar e configurar, vamos usar o OpenCode pela primeira vez.

1. O Que Você Vai Aprender

• Iniciar o OpenCode e entrar no TUI
• Primeira experiência de conversa
• Pedir à IA para analisar código
• Pedir à IA para modificar código
• Desfazer operações

2. Iniciar o OpenCode

Entre no diretório do projeto e execute:

cd my-project
opencode

Você verá a interface TUI com a caixa de entrada na parte inferior e a área de conversa acima.

3. Primeira Conversa

Na caixa de entrada, digite:

Resuma rapidamente a estrutura deste projeto

O OpenCode lerá os arquivos do projeto e fornecerá uma visão geral da estrutura.

4. Referência de Arquivos para Análise

Use @ para referenciar arquivos do projeto:

Como a lógica de autenticação deste projeto está implementada? Verifique @src/auth/index.ts

Recursos: busca fuzzy de caminhos, leitura automática de conteúdo, sem necessidade de copiar código.

5. Pedir à IA para Modificar Código

Dê uma instrução de modificação:

Substitua todas as declarações var em src/utils/format.ts por const ou let

O OpenCode irá: ler o arquivo → identificar declarações var → julgar const ou let → modificar o arquivo.

6. Executar Comandos

Use o prefixo ! para executar comandos Shell:

!npm test

Os resultados são adicionados automaticamente ao contexto da conversa.

7. Desfazer Operações

/undo

Isso desfaz a última mensagem e reverte as modificações de código.

Refazer:

/redo

Importante: A funcionalidade de desfazer depende do Git. Recomendamos ativar o controle de versão Git no projeto.

8. Trocar Modelo

/model

Selecione outro modelo da lista e pressione Enter.

9. Gerenciamento de Sessões

10. Sair do OpenCode

/exit

Ou Ctrl + X → Q.

❓ FAQ

P: Qual modelo escolher para o primeiro uso?

R: Recomendamos os modelos gratuitos do OpenCode Zen para experimentar. Após confirmar que o fluxo funciona, mude para modelos pagos mais robustos conforme necessário.

P: E se a IA modificar o código incorretamente?

R: Use /undo imediatamente. Recomendamos fazer git commit antes de operações importantes.

P: Como usar o modo não-interativo?

R: Use opencode run "sua pergunta" para obter resultados diretamente sem entrar no TUI. Ideal para perguntas rápidas e integração com scripts.

📖 Resumo

• Execute opencode no diretório do projeto para iniciar
• @ para referenciar arquivos, ! para executar comandos
• /undo para desfazer, /redo para refazer
• /model para trocar modelo, /new para nova sessão
• Sempre faça git commit antes de operações importantes

📝 Exercícios

1. Básico: Inicie o OpenCode e peça para analisar a estrutura do seu projeto.

2. Intermediário: Peça ao OpenCode para modificar um arquivo e use /undo para reverter.

3. Avançado: Use opencode run no modo não-interativo e redirecione o resultado para um arquivo.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós