Blog

Como Criar Alternativa Local e Gratuita ao Claude com gpt-oss-20b

Ashley Goolam

Ashley Goolam

15 agosto 2025

Como Criar Alternativa Local e Gratuita ao Claude com gpt-oss-20b

Olá, desenvolvedores! Quer turbinar seu fluxo de trabalho de desenvolvimento com uma configuração de codificação de IA local e gratuita? Você está no lugar certo! Hoje, vamos mergulhar em como criar um ambiente de codificação de IA poderoso e de código aberto usando GPT-OSS, Opencode e Vibe Kanban. Essas ferramentas permitem que você codifique de forma mais inteligente, automatize tarefas e gerencie projetos — tudo sem gastar muito. Neste guia, vamos te guiar na configuração do Opencode com o modelo GPT-OSS para construir um site de portfólio e, em seguida, usar o Vibe Kanban para gerenciá-lo e aprimorá-lo. Ao final, você terá uma potência de codificação local e impulsionada por IA. Vamos codificar com GPT-OSS, Opencode, Vibe Kanban!

💡
Quer uma ótima ferramenta de Teste de API que gera uma linda Documentação de API?

Quer uma plataforma integrada e completa para sua Equipe de Desenvolvedores trabalhar em conjunto com máxima produtividade?

Apidog entrega todas as suas demandas e substitui o Postman por um preço muito mais acessível!
button

O Que São GPT-OSS, Opencode e Vibe Kanban?

Antes de começarmos, vamos conhecer as estrelas do nosso trio de codificação de IA:

Juntas, essas ferramentas criam um ambiente local e gratuito onde o GPT-OSS alimenta a IA, o Opencode lida com as tarefas de codificação e o Vibe Kanban organiza seus projetos. Vamos configurá-lo!

modelo gpt-oss

Passo 1: Instalar o Opencode

Primeiro, precisamos instalar o Opencode, a espinha dorsal do nosso ambiente de codificação de IA. É super fácil no macOS/Linux, com uma opção manual para Windows.

Para macOS/Linux

Execute um destes comandos em seu terminal:

curl -fsSL https://opencode.ai/install | bash

npm i -g opencode-ai@latest  # ou bun/pnpm/yarn
brew install sst/tap/opencode  # macOS e Linux
paru -S opencode-bin  # Arch Linux

Para Windows

  1. Visite github.com/sst/opencode/releases (ex: v0.3.112 a partir de agosto de 2025).
  2. Baixe o binário opencode.exe mais recente.
  3. Salve-o em um diretório (ex: C:\opencode).

Testar a Instalação

Verifique se o Opencode está funcionando:

Dica Profissional: Para Windows, adicione a pasta do binário ao seu PATH para acesso mais fácil.

agente opencode

Passo 2: Configurar Seu Projeto Opencode

Vamos criar uma nova pasta de projeto para construir um site de portfólio usando Opencode e GPT-OSS. Vamos configurá-lo com configurações personalizadas.

Criar Pasta do Projeto:

mkdir opencode-vibekanban-project
cd opencode-vibekanban-project

Adicionar AGENTS.md:
Crie um arquivo chamado AGENTS.md com:

# Tooling rules for Opencode
- Use Opencode tools only: read, write, edit, list, glob, grep, webfetch, bash, task, todowrite, todoread.
- Do NOT call non-existent tools like Repo_browser.*.
- Prefer `edit` for modifying existing files; use `read` to inspect before editing.

Isso define regras para o agente de IA do Opencode, garantindo que ele use as ferramentas corretas.

Adicionar opencode.json:
Crie opencode.json para configurar o GPT-OSS (modelo 20B):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      }
    },
    "models": {
      "gpt-oss:20b": { "name": "gpt-oss 20B (local)" }
    }
  },
  "model": "ollama/gpt-oss:20b",
  "agent": {
    "build": {
      "description": "Default coding mode with only Opencode tools.",
      "tools": {
        "read": true,
        "write": true,
        "edit": true,
        "bash": true,
        "grep": true,
        "glob": true,
        "list": true,
        "webfetch": true,
        "patch": true,
        "todoread": true,
        "todowrite": true
      },
      "prompt": "{file:./AGENTS.md}"
    }
  },
  "instructions": ["AGENTS.md"]
}

Quer usar o GPT-OSS 120B mais poderoso? Substitua as seções provider e model por:

"provider": {
  "ollama": {
    "npm": "@ai-sdk/openai-compatible",
    "name": "Ollama (local)",
    "options": {
      "baseURL": "http://localhost:11434/v1"
    },
    "models": {
      "gpt-oss:120b": { "name": "gpt-oss 120B (local)" }
    }
  }
},
"model": "ollama/gpt-oss:120b"

Nota: Salve AGENTS.md e opencode.json em opencode-vibekanban-project. Esses arquivos informam ao Opencode para usar o GPT-OSS e seguir regras específicas de ferramentas.

Passo 3: Instalar e Executar o GPT-OSS com Ollama

O GPT-OSS roda localmente via Ollama, uma ferramenta leve para gerenciar LLMs. Você precisará de uma máquina decente (16GB+ de RAM para 20B, 64GB+ para 120B).

  1. Instalar o Ollama:

2. Baixar o Modelo GPT-OSS:

ollama pull gpt-oss:20b

ollama pull gpt-oss:120b
modelo gpt-oss no ollama

3. Executar o Modelo:

ollama run gpt-oss:20b

ou

ollama run gpt-oss:120b

Dica Profissional: Certifique-se de que o Ollama esteja em execução antes de iniciar o Opencode, ou você receberá erros de conexão.

Passo 4: Executar o Opencode para Seu Projeto

Agora, vamos iniciar o Opencode na sua pasta de projeto:

  1. Navegar para o Projeto:
cd opencode-vibekanban-project

2. Executar Opencode:

opencode .

<caminho-para-opencode>/opencode.exe .

3. Verificar Configuração:

configurar opencode com modelo gpt-oss

Passo 5: Criar um Site de Portfólio com o Opencode

Vamos usar o Opencode e o GPT-OSS para construir uma página de destino de portfólio simples para um desenvolvedor chamado John Doe, usando React com Vite.

Inserir o Prompt:

Create a simple portfolio landing page for a developer called John Doe in React with Vite.

Executar o Site:

npm install
npm run dev
site de portfólio simples

Enviar para o GitHub:

git init
git add .
git commit -m "Initial portfolio website"
git remote add origin https://github.com/your-username/john-doe-portfolio.git
git push -u origin main

Dica Profissional: Use a ferramenta webfetch do Opencode para buscar inspiração em sites de portfólio existentes, se necessário.

Passo 6: Configurar o Vibe Kanban para Gerenciamento de Projetos

Agora, vamos integrar o Vibe Kanban para gerenciar e aprimorar o projeto do portfólio com agentes de IA.

Instalar o Vibe Kanban:

npx vibe-kanban

Configurar o Vibe Kanban:

vincular vibe kanban com github

Criar um Novo Projeto:

criar um novo projeto

Passo 7: Adicionar Tarefas com o Vibe Kanban

Vamos usar o Vibe Kanban para aprimorar o portfólio adicionando um novo recurso, como um formulário de contato.

Criar uma Tarefa:

criar uma tarefa

Selecionar Agente:

selecionar opencode como seu agente

Revisar e Aprovar:

git add .
git commit -m "Added contact form"
git push

Dica Profissional: Use o Vibe Kanban para enfileirar várias tarefas (ex: “Adicionar modo escuro”, “Otimizar imagens”) e deixe o Opencode lidar com elas sequencialmente.

Solução de Problemas Comuns

Por Que Esta Pilha é Incrível

A combinação GPT-OSS, Opencode, Vibe Kanban é o sonho de todo desenvolvedor:

Os usuários adoram essa configuração: “O Opencode com GPT-OSS construiu meu site em minutos, e o Vibe Kanban o manteve organizado!” Experimente e veja por quê.

Conclusão

Você acabou de construir um ambiente de codificação de IA local e gratuito com GPT-OSS, Opencode e Vibe Kanban! Desde a criação de um site de portfólio até o gerenciamento de tarefas com agentes de IA, você está pronto para codificar de forma mais inteligente. Experimente novos recursos, contribua para os repositórios e compartilhe seus projetos nos comentários. Vamos manter a revolução da codificação de IA em andamento!

💡
Quer uma ótima ferramenta de Teste de API que gera uma linda Documentação de API?

Quer uma plataforma integrada e completa para sua Equipe de Desenvolvedores trabalhar em conjunto com máxima produtividade?

Apidog entrega todas as suas demandas e substitui o Postman por um preço muito mais acessível!
button

Pratique o design de API no Apidog

Descubra uma forma mais fácil de construir e usar APIs

Cadastre-se gratuitamenteBaixar