Ir para o conteúdo principal

Instalar e usar o OpenCode

OpenCode é uma ferramenta de codificação com capacidade de agente. A ferramenta está disponível como aplicativo de terminal, aplicativo de desktop e extensão IDE.

O AI-School recomenda o OpenCode principalmente para docentes, administradores e alunos com muita experiência em programação. O OpenCode pode operar com mais autonomia do que o Aider e, por isso, pode executar rapidamente muitas alterações.

Mais informações estão disponíveis no site do OpenCode e na documentação oficial do OpenCode.

Quando escolher o OpenCode?​

Escolha o OpenCode se o usuário:

  • tiver experiência com terminal, editores de código e git
  • entender como os arquivos locais são modificados
  • puder revisar alterações antes de serem usadas
  • quiser trabalhar tarefas de programação mais complexas

Para aprender programação em sala de aula com iniciantes, o Aider costuma ser mais adequado.

Instalar​

A instalação mais simples de acordo com a documentação do OpenCode é:

curl -fsSL https://opencode.ai/install | bash

Você também pode instalar o OpenCode com Node.js:

npm install -g opencode-ai

Ou com o Homebrew no macOS e Linux:

brew install anomalyco/tap/opencode

Conectar com Coderen​

O OpenCode suporta provedores compatíveis com OpenAI personalizados. Crie um arquivo opencode.json no diretório do projeto.

Use nele o endpoint Coderen e os modelos permitidos:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-school-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-School Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_SCHOOL_CODEREN_API_KEY}"
      },
      "models": {
        "gpt-5.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.4-mini",
  "small_model": "ai-school-coderen/gpt-5.4-mini"
}

Em seguida, defina a chave API como variável de ambiente.

Você também pode usar um arquivo .env no diretório do projeto:

AI_SCHOOL_CODEREN_API_KEY=ais.sua-chave-de-api

Verifique após abrir um novo terminal se o OpenCode consegue ler essa variável. Se o OpenCode não enviar a chave, o AI-School emitirá a mensagem de erro de que um cabeçalho Authorization com token Bearer é obrigatório.

macOS e Linux​

export AI_SCHOOL_CODEREN_API_KEY="ais.sua-chave-de-api"

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.sua-chave-de-api"

Abra um novo terminal depois.

Iniciar o OpenCode​

Vá para o diretório do projeto:

cd caminho/para/o/seu/projeto

Inicie o OpenCode:

opencode

Use a seleção de modelo no OpenCode para selecionar o modelo Coderen da AI-School, caso isso ainda não ocorra automaticamente.

Solução de problemas​

O cabeçalho Authorization com token Bearer é obrigatório​

Essa mensagem normalmente significa que o OpenCode não está enviando a chave de API. Verifique:

  • se AI_SCHOOL_CODEREN_API_KEY está exatamente assim
  • se o valor começa com ais.
  • se você abriu uma nova sessão após setx
  • se o arquivo .env está no diretório do projeto onde você inicia o OpenCode

Parâmetro desconhecido​

Algumas ferramentas ajudam parâmetros específicos do provedor adicionais. Se você receber uma mensagem como Unknown parameter, remova essa configuração da configuração do OpenCode ou use uma configuração de provedor mais simples. O endpoint Coderen espera solicitações de chat compatíveis com OpenAI com modelo, mensagens e as configurações básicas usuais.

Trabalhar com segurança com o OpenCode​

Como o OpenCode funciona de forma agentic, é importante revisar as alterações.

Prática recomendada:

  1. Trabalhar em um repositório git.
  2. Começar com tarefas pequenas.
  3. Verificar diffs antes de usar o código.
  4. Testar o aplicativo após as alterações.
  5. Confirmar apenas alterações que você entende.

Para alunos com pouca experiência, é aconselhável usar o OpenCode primeiro de forma demonstrativa, sob a orientação de um docente.