Ir para o conteúdo principal

Instalar e usar OpenCode

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

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

Mais informações estão disponíveis 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 Homebrew no macOS e Linux:

brew install anomalyco/tap/opencode

Conectar com Codificar​

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-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.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-corporate-coderen/gpt-5.6-luna",
  "small_model": "ai-corporate-coderen/gpt-5.6-luna"
}

Defina a chave de API como variável de ambiente posteriormente.

macOS e Linux​

export AI_CORPORATE_CODEREN_API_KEY="aic.sua-chave-api"

Windows​

setx AI_CORPORATE_CODEREN_API_KEY "aic.sua-chave-api"

Abra uma nova janela de terminal.

Iniciar o OpenCode​

Vá até o diretório do projeto:

cd caminho/para/seu/projeto

Inicie o OpenCode:

opencode

Use a seleção de modelo no OpenCode para escolher o modelo AI-Corporate Coderen caso ainda não tenha ocorrido automaticamente.

Trabalhar com segurança usando o OpenCode​

Como o OpenCode funciona de forma orientada por agentes, é importante verificar as mudanças.

Prática recomendada:

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

Variáveis de ambiente e OpenCode​

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

AI_SCHOOL_CODEREN_API_KEY=ai.sua-chave-api

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

$env:AI_SCHOOL_CODEREN_API_KEY="ai.sua-chave-api"

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

WhatsApp