Instalar e usar OpenCode

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

AI-Public recomenda o OpenCode para desenvolvedores, administradores e outros usuários avançados. O OpenCode pode editar arquivos de forma autônoma e desenvolver tarefas. 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 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 ao Codar

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.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-public-coderen/gpt-5.4-mini",
  "small_model": "ai-public-coderen/gpt-5.4-mini"
}

Em seguida, defina a chave 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/seu/projeto

Inicie o OpenCode:

opencode

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

Trabalhar com segurança com o OpenCode

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

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 as alterações.
5. Commite apenas alterações que você entende.

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_PUBLIC_CODEREN_API_KEY=aip.sua-chave-de-api

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

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

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