Ir para o conteúdo principal

Instalar e usar o OpenCode

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

A AI-School recomenda o OpenCode principalmente para docentes, administradores e alunos com muita experiência em programação. O OpenCode pode funcionar de forma mais independente que o Aider e, portanto, 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
  • desejar desenvolver tarefas de programação mais complexas

Para aprendizado clássico de programação com iniciantes, o Aider geralmente é 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 Homebrew no macOS e Linux:

brew install anomalyco/tap/opencode

Conectar ao Coderen​

OpenCode suporta provedores personalizados compatíveis com OpenAI. Crie um arquivo opencode.json na pasta do projeto.

Utilize 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.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.6-luna",
  "small_model": "ai-school-coderen/gpt-5.6-luna"
}

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

Você também pode usar um arquivo .env na pasta 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 uma chave, a AI-School informa o erro de que o 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á até a pasta do projeto:

cd caminho/para/seu/projeto

Inicie o OpenCode:

opencode

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

Solução de problemas​

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

Essa mensagem geralmente significa que o OpenCode não envia a chave de API. Verifique:

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

Parâmetro desconhecido​

Algumas ferramentas enviam parâmetros adicionais específicos do provedor. 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 OpenCode com segurança​

Como o OpenCode opera de forma agentizada, é importante revisar as alterações.

Procedimento recomendado:

  1. Trabalhe em um repositório git.
  2. Comece com tarefas pequenas.
  3. Revise as diffs antes de usar o código.
  4. Teste a aplicação após alterações.
  5. Faça commit apenas das alterações que você entende.

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

WhatsApp