Instalar e usar OpenCode

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

A AI-Corporate recomenda o OpenCode para desenvolvedores, administradores e outros usuários avançados. O OpenCode pode modificar arquivos e realizar tarefas de forma autônoma. Portanto, sempre verifique as alterações propostas.

Mais informações podem ser encontradas no site do OpenCode e na documentação oficial do OpenCode.

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

OpenCode suporta provedores personalizados compatíveis com OpenAI. 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-corporate-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Corporate Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_CORPORATE_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-corporate-coderen/gpt-5.4-mini",
  "small_model": "ai-corporate-coderen/gpt-5.4-mini"
}

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

macOS e Linux

export AI_CORPORATE_CODEREN_API_KEY="aic.joa-api-key"

Windows

setx AI_CORPORATE_CODEREN_API_KEY "aic.joa-api-key"

Abra o terminal novamente.

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 AI-Corporate Coderen, se ainda não ocorrer automaticamente.

Trabalhar com segurança com o OpenCode

Como o OpenCode é agente, é importante verificar as mudanças.

Prática recomendada:

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

Variáveis de ambiente e OpenCode

Para o OpenCode, você pode armazenar a chave da Coderen API em um arquivo .env local no diretório do projeto:

AI_SCHOOL_CODEREN_API_KEY=ais.joa-api-key

Certifique-se de que o OpenCode carregue essa variável de ambiente. No PowerShell, você também pode definir a variável temporariamente para o terminal atual:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.joa-api-key"

Se aparecer Authorization header with Bearer token is required, a ferramenta não enviará a chave como Authorization: Bearer .... Se aparecer Unknown parameter, remova as configurações específicas do provedor que o endpoint Coderen da AI-Corporate não suporta.