Blog

Cómo Crear una Alternativa Local y Gratuita a Claude con gpt-oss-20b

Ashley Goolam

Ashley Goolam

15 August 2025

Cómo Crear una Alternativa Local y Gratuita a Claude con gpt-oss-20b

¡Hola, programadores! ¿Quieren potenciar su flujo de trabajo de desarrollo con una configuración de codificación de IA local y gratuita? ¡Están en el lugar correcto! Hoy, nos sumergiremos en cómo crear un entorno de codificación de IA potente y de código abierto utilizando GPT-OSS, Opencode y Vibe Kanban. Estas herramientas les permiten codificar de manera más inteligente, automatizar tareas y gestionar proyectos, todo sin gastar una fortuna. En esta guía, les guiaremos a través de la configuración de Opencode con el modelo GPT-OSS para construir un sitio web de portafolio, y luego usaremos Vibe Kanban para gestionarlo y mejorarlo. Al final, tendrán una central de codificación local impulsada por IA. ¡A codificar con GPT-OSS, Opencode, Vibe Kanban!

💡
¿Quieres una excelente herramienta de prueba de API que genere hermosa documentación de API?

¿Quieres una plataforma integrada y todo en uno para que tu equipo de desarrolladores trabaje en conjunto con la máxima productividad?

¡Apidog cumple con todas tus demandas y reemplaza a Postman a un precio mucho más asequible!
botón

¿Qué son GPT-OSS, Opencode y Vibe Kanban?

Antes de sumergirnos, conozcamos a las estrellas de nuestro trío de codificación de IA:

Juntas, estas herramientas crean un entorno local y gratuito donde GPT-OSS impulsa la IA, Opencode maneja las tareas de codificación y Vibe Kanban organiza sus proyectos. ¡Vamos a configurarlo!

gpt-oss model

Paso 1: Instalar Opencode

Primero, necesitamos instalar Opencode, la columna vertebral de nuestro entorno de codificación de IA. Es súper fácil en macOS/Linux, con una opción manual para Windows.

Para macOS/Linux

Ejecuten uno de estos comandos en su terminal:

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

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

Para Windows

  1. Visiten github.com/sst/opencode/releases (por ejemplo, v0.3.112 a partir de agosto de 2025).
  2. Descarguen el binario más reciente opencode.exe.
  3. Guárdenlo en un directorio (por ejemplo, C:\opencode).

Probar la instalación

Verifiquen que Opencode funcione:

Consejo Pro: Para Windows, agreguen la carpeta del binario a su PATH para un acceso más fácil.

opencode agent

Paso 2: Configurar su proyecto Opencode

Creemos una nueva carpeta de proyecto para construir un sitio web de portafolio usando Opencode y GPT-OSS. Lo configuraremos con ajustes personalizados.

Crear carpeta de proyecto:

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

Agregar AGENTS.md:
Creen un archivo llamado AGENTS.md con:

# 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.

Esto define reglas para el agente de IA de Opencode, asegurando que use las herramientas correctas.

Agregar opencode.json:
Creen opencode.json para configurar 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"]
}

¿Quieren usar el GPT-OSS 120B más potente? Reemplacen las secciones provider y model con:

"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: Guarden AGENTS.md y opencode.json en opencode-vibekanban-project. Estos archivos le indican a Opencode que use GPT-OSS y siga reglas de herramientas específicas.

Paso 3: Instalar y ejecutar GPT-OSS con Ollama

GPT-OSS se ejecuta localmente a través de Ollama, una herramienta ligera para gestionar LLM. Necesitarán una máquina decente (16GB+ de RAM para 20B, 64GB+ para 120B).

  1. Instalar Ollama:

2. Extraer modelo GPT-OSS:

ollama pull gpt-oss:20b

ollama pull gpt-oss:120b
gpt-oss model on ollama

3. Ejecutar el modelo:

ollama run gpt-oss:20b

o

ollama run gpt-oss:120b

Consejo Pro: Asegúrense de que Ollama esté ejecutándose antes de iniciar Opencode, o recibirán errores de conexión.

Paso 4: Ejecutar Opencode para su proyecto

Ahora, vamos a iniciar Opencode en su carpeta de proyecto:

  1. Navegar al proyecto:
cd opencode-vibekanban-project

2. Ejecutar Opencode:

opencode .

<ruta-a-opencode>/opencode.exe .

3. Verificar la configuración:

configure opencode with gpt-oss model

Paso 5: Crear un sitio web de portafolio con Opencode

Usemos Opencode y GPT-OSS para construir una página de inicio de portafolio simple para un desarrollador llamado John Doe, usando React con Vite.

Introducir el Prompt:

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

Ejecutar el sitio web:

npm install
npm run dev
simple portfolio website

Subir a 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

Consejo Pro: Usen la herramienta webfetch de Opencode para inspirarse en sitios de portafolio existentes si es necesario.

Paso 6: Configurar Vibe Kanban para la gestión de proyectos

Ahora, integremos Vibe Kanban para gestionar y mejorar el proyecto de portafolio con agentes de IA.

Instalar Vibe Kanban:

npx vibe-kanban

Configurar Vibe Kanban:

link vibe kanban with github

Crear un nuevo proyecto:

create a new project

Paso 7: Añadir tareas con Vibe Kanban

Usemos Vibe Kanban para mejorar el portafolio añadiendo una nueva característica, como un formulario de contacto.

Crear una tarea:

create a task

Seleccionar agente:

select opencode as your agent

Revisar y aprobar:

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

Consejo Pro: Usen Vibe Kanban para poner en cola múltiples tareas (por ejemplo, “Añadir modo oscuro”, “Optimizar imágenes”) y dejen que Opencode las maneje secuencialmente.

Resolución de problemas comunes

Por qué esta pila es genial

La combinación GPT-OSS, Opencode, Vibe Kanban es el sueño de todo desarrollador:

A los usuarios les encanta esta configuración: “¡Opencode con GPT-OSS construyó mi sitio en minutos, y Vibe Kanban lo mantuvo organizado!” Pruébenlo y vean por qué.

Conclusión

¡Acaban de construir un entorno de codificación de IA local y gratuito con GPT-OSS, Opencode y Vibe Kanban! Desde la creación de un sitio de portafolio hasta la gestión de tareas con agentes de IA, están listos para codificar de manera más inteligente. Experimenten con nuevas características, contribuyan a los repositorios y compartan sus proyectos en los comentarios. ¡Mantengamos la revolución de la codificación de IA en marcha!

💡
¿Quieres una excelente herramienta de prueba de API que genere hermosa documentación de API?

¿Quieres una plataforma integrada y todo en uno para que tu equipo de desarrolladores trabaje en conjunto con la máxima productividad?

¡Apidog cumple con todas tus demandas y reemplaza a Postman a un precio mucho más asequible!
botón

Practica el diseño de API en Apidog

Descubre una forma más fácil de construir y usar APIs

Registrarse gratisDescargar