beginner⏱30 minLição 2 de 5

Instalação e Primeira Configuração

Instale o OpenCode em seu sistema e configure-o com seu primeiro provedor LLM. Configure chaves de API, verifique a instalação e execute seu primeiro comando.

Instalação e Primeira Configuração

Pré-requisitos

Antes de instalar o OpenCode, certifique-se de ter:

Requisito	Versão Mínima	Como Verificar
Node.js	18.0+	`node --version`
npm	8.0+	`npm --version`
Git	2.0+	`git --version`

ℹ️Note

OpenCode é uma aplicação Node.js distribuída via npm. Ele executa em macOS, Linux e Windows.

Instalação

Usando npm (Recomendado)

bash

npm install -g opencode

Usando yarn

bash

yarn global add opencode

Usando pnpm

bash

pnpm add -g opencode

Verificar Instalação

bash

opencode --version

Saída esperada:

opencode v1.x.x

💡Tip

Se você vir "command not found", certifique-se de que o diretório global do npm está em seu PATH.

Configuração Inicial

Passo 1: Criar Diretório de Configuração

bash

mkdir -p .opencode

Passo 2: Criar opencode.json

Crie opencode.json na raiz do seu projeto:

json

{
  "$schema": "https://opencode.ai/config.json",
  "agents": {
    "default": {
      "model": "gpt-4o",
      "description": "Assistente de codificação de propósito geral"
    }
  }
}

Passo 3: Configurar Chaves de API

Crie um arquivo .env na raiz do seu projeto:

bash

# OpenAI
OPENAI_API_KEY=sk-sua-chave-api-aqui

# Anthropic (opcional)
ANTHROPIC_API_KEY=sk-ant-sua-chave-api-aqui

# Google (opcional)
GOOGLE_API_KEY=sua-chave-api-google-aqui

⚠️Warning

Nunca comprometa chaves de API no controle de versão. Adicione .env ao seu arquivo .gitignore.

Configuração de Provedores

OpenAI

json

{
  "providers": {
    "openai": {
      "apiKey": "${OPENAI_API_KEY}",
      "model": "gpt-4o"
    }
  }
}

Anthropic

json

{
  "providers": {
    "anthropic": {
      "apiKey": "${ANTHROPIC_API_KEY}",
      "model": "claude-sonnet-4-20250514"
    }
  }
}

Google

json

{
  "providers": {
    "google": {
      "apiKey": "${GOOGLE_API_KEY}",
      "model": "gemini-pro"
    }
  }
}

Primeira Execução

Iniciar OpenCode

bash

opencode

Você deve ver:

OpenCode v1.x.x
Type your message or /help for commands
>

Testar a Conexão

Digite uma mensagem simples:

> Olá, você pode me ajudar com meu código?

Se bem-sucedido, a IA responderá com uma saudação e perguntará como pode ajudar.

Localizações de Arquivos de Configuração

O OpenCode procura configuração nesta ordem:

Prioridade	Localização	Finalidade
1	`.opencode/config.json`	Específico do projeto (preferido)
2	`opencode.json`	Específico do projeto (legado)
3	`~/.config/opencode/config.json`	Padrões do usuário

💡Tip

Use .opencode/config.json para projetos em equipe. Você pode versionar seletivamente enquanto mantém dados sensíveis em .env.

Comandos Básicos

Comando	Descrição
`opencode`	Iniciar sessão interativa
`opencode --version`	Mostrar versão
`opencode --help`	Mostrar ajuda
`opencode config`	Abrir configuração
`opencode providers`	Listar provedores disponíveis

Solução de Problemas

Problemas Comuns

Problema	Causa	Solução
"Command not found"	npm PATH não configurado	Execute `npm config get prefix` e adicione ao PATH
"Invalid API key"	Formato de chave incorreto	Verifique se a chave começa com `sk-` (OpenAI) ou `sk-ant-` (Anthropic)
"Rate limit exceeded"	Muitas solicitações	Aguarde ou atualize seu plano de API
"Model not found"	Nome do modelo incorreto	Verifique a documentação do provedor para nomes de modelos válidos

Practice Questions

Practice Question

Qual é a versão mínima do Node.js necessária para o OpenCode?

Practice Question

Onde você deve armazenar as chaves de API para o OpenCode?

Practice Question

Qual localização de arquivo de configuração é recomendada para projetos em equipe?

Practice Question

Qual comando inicia uma sessão interativa do OpenCode?

Practice Question

Quais gerenciadores de pacotes podem ser usados para instalar o OpenCode?

✅Success

Key Takeaways

OpenCode requer Node.js 18+ e pode ser instalado via npm, yarn ou pnpm
A configuração é armazenada em opencode.json ou .opencode/config.json
Chaves de API devem ser armazenadas em variáveis de ambiente ou arquivos .env
A localização .opencode/config.json é preferida para projetos em equipe
Execute opencode para iniciar uma sessão interativa
Múltiplos provedores LLM (OpenAI, Anthropic, Google) são suportados

Progresso40%

O que é o OpenCode e por que usá-lo

Sua Primeira Sessão de Codificação com IA

Contéudo do Curso

1. O que é o OpenCode e por que usá-lo 2. Instalação e Primeira Configuração 3. Sua Primeira Sessão de Codificação com IA 4. Entendendo a Interface CLI 5. Configuração Básica com opencode.json