Ir para o conteúdo principal

Instalar e usar o OpenCode

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

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

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

Instalar​

A forma mais simples de instalar, 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 Codificar​

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-public-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Public Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-public-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_PUBLIC_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-public-coderen/gpt-5.6-luna",
  "small_model": "ai-public-coderen/gpt-5.6-luna"
}

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

macOS e Linux​

export AI_PUBLIC_CODEREN_API_KEY="aip.sua-chave-de-api"

Windows​

setx AI_PUBLIC_CODEREN_API_KEY "aip.sua-chave-de-api"

Abra um novo terminal depois.

Iniciar o OpenCode​

Vá até 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-Public Coderen, se ainda não for feito automaticamente.

Trabalhar com segurança com o OpenCode​

Como o OpenCode funciona de forma agentic, é 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. Faça commit apenas das alterações 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_PUBLIC_CODEREN_API_KEY=aip.sua-chave-de-api

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

$env:AI_PUBLIC_CODEREN_API_KEY="aip.sua-chave-de-api"

Se você vir Authorization header com Bearer token é obrigatório, então a ferramenta não enviará a chave como Authorization: Bearer .... Se aparecer Unknown parameter, remova as configurações específicas do provedor que não são suportadas pelo endpoint Coderen do AI-Public.

WhatsApp