3 pasos para configurar el acceso de OpenCode a la estación de retransmisión de API y desbloquear el cambio libre entre más de 400 modelos de IA

¿Quieres usar OpenCode, este asistente de programación de IA de código abierto, pero te frenan los altos precios de la API oficial o la inestabilidad de la conexión? Un intermediario de API es tu mejor solución. Este artículo te guiará paso a paso para completar la integración de OpenCode con APIYI, OpenRouter y otros servicios de intermediación en solo 3 pasos, permitiéndote acceder a más de 75 modelos de IA líderes como Claude, GPT-4 y Gemini a un costo mucho menor.

Valor central: Al terminar de leer, habrás aprendido a configurar OpenCode para usar cualquier API compatible con OpenAI, logrando total libertad para cambiar de modelo y optimizar costos.

¿Qué es OpenCode? ¿Por qué conectarlo a un intermediario de API?

OpenCode es un asistente de programación de IA de código abierto para la terminal, considerado la alternativa de código abierto a Claude Code. Está desarrollado en Go y ofrece una elegante interfaz TUI, gestión de múltiples sesiones e integración con LSP, entre otras funciones profesionales.

Un vistazo a las características principales de OpenCode

¿Por qué usar un intermediario de API?

El uso directo de las API oficiales puede presentar los siguientes problemas:

🚀 Inicio rápido: Se recomienda usar APIYI apiyi.com como intermediario; ofrece una interfaz compatible con OpenAI lista para usar. Regístrate para obtener crédito de prueba gratuito y completa la configuración de OpenCode en solo 5 minutos.

Puntos clave para integrar OpenCode con un proxy de API

Antes de empezar con la configuración, es importante entender el principio de acceso a la API de OpenCode:

Descripción de la arquitectura de configuración

OpenCode utiliza un sistema de gestión de configuración unificado que admite la superposición de varias capas:

Principio de conexión con el proxy de API

OpenCode admite cualquier API compatible con OpenAI a través del adaptador @ai-sdk/openai-compatible. Los elementos clave de configuración son:

• baseURL: La dirección de la interfaz del proxy de la API.
• apiKey: La clave API proporcionada por el proxy.
• models: Lista de modelos disponibles.

Esto significa que, siempre que el proxy proporcione una interfaz estándar /v1/chat/completions, se podrá integrar directamente con OpenCode.

Configuración rápida de OpenCode

Paso 1: Instalar OpenCode

OpenCode ofrece varios métodos de instalación, elige el que mejor se adapte a ti:

Script de instalación en un clic (recomendado):

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

Instalación con Homebrew (macOS/Linux):

brew install opencode-ai/tap/opencode

Instalación con npm:

npm i -g opencode-ai@latest

Instalación con Go:

go install github.com/opencode-ai/opencode@latest

Verifica que la instalación fue exitosa:

opencode --version

Paso 2: Configurar la clave del proxy de API

OpenCode admite dos métodos de autenticación:

Método 1: Usar el comando /connect (recomendado)

Inicia OpenCode e ingresa el comando /connect:

opencode
# En la interfaz TUI, escribe
/connect

Selecciona Other para añadir un proveedor personalizado e ingresa tu clave API. La clave se guardará de forma segura en ~/.local/share/opencode/auth.json.

Método 2: Configuración mediante variables de entorno

Añade lo siguiente en tu archivo ~/.zshrc o ~/.bashrc:

# Configuración del proxy APIYI
export OPENAI_API_KEY="sk-your-apiyi-key"
export OPENAI_BASE_URL="https://api.apiyi.com/v1"

Aplica los cambios:

source ~/.zshrc

Paso 3: Crear el archivo de configuración opencode.json

Este es el paso más importante: crear el archivo de configuración para especificar el proxy de la API.

Configuración global (se aplica a todos los proyectos):

mkdir -p ~/.config/opencode
touch ~/.config/opencode/opencode.json

Configuración de proyecto (solo para el proyecto actual):

touch opencode.json  # En la raíz del proyecto

Ejemplo de configuración minimalista

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI",
      "options": {
        "baseURL": "https://api.apiyi.com/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-20250514": {
          "name": "Claude Sonnet 4"
        },
        "gpt-4o": {
          "name": "GPT-4o"
        }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514"
}

Nota de configuración: La sintaxis {env:OPENAI_API_KEY} leerá automáticamente la variable de entorno, evitando dejar la clave escrita en el archivo. Las claves API obtenidas a través de APIYI (apiyi.com) son compatibles con el formato de OpenAI y pueden usarse directamente.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI (Recomendado)",
      "options": {
        "baseURL": "https://api.apiyi.com/v1",
        "apiKey": "{env:APIYI_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-20250514": {
          "name": "Claude Sonnet 4",
          "limit": {
            "context": 200000,
            "output": 65536
          }
        },
        "claude-opus-4-20250514": {
          "name": "Claude Opus 4",
          "limit": {
            "context": 200000,
            "output": 32000
          }
        },
        "gpt-4o": {
          "name": "GPT-4o",
          "limit": {
            "context": 128000,
            "output": 16384
          }
        },
        "gpt-4o-mini": {
          "name": "GPT-4o Mini",
          "limit": {
            "context": 128000,
            "output": 16384
          }
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro",
          "limit": {
            "context": 1000000,
            "output": 65536
          }
        },
        "deepseek-chat": {
          "name": "DeepSeek V3",
          "limit": {
            "context": 64000,
            "output": 8192
          }
        }
      }
    },
    "openrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenRouter",
      "options": {
        "baseURL": "https://openrouter.ai/api/v1",
        "apiKey": "{env:OPENROUTER_API_KEY}",
        "headers": {
          "HTTP-Referer": "https://your-site.com",
          "X-Title": "OpenCode Client"
        }
      },
      "models": {
        "anthropic/claude-sonnet-4": {
          "name": "Claude Sonnet 4 (OpenRouter)"
        },
        "openai/gpt-4o": {
          "name": "GPT-4o (OpenRouter)"
        }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514",
  "small_model": "apiyi/gpt-4o-mini",
  "agent": {
    "coder": {
      "model": "apiyi/claude-sonnet-4-20250514",
      "maxTokens": 8000
    },
    "planner": {
      "model": "apiyi/gpt-4o",
      "maxTokens": 4000
    }
  },
  "tools": {
    "write": true,
    "bash": true,
    "glob": true,
    "grep": true
  }
}

Comparativa de proveedores de API compatibles con OpenCode

Parámetros de configuración de proveedores principales

Detalles de configuración de APIYI

APIYI es una plataforma intermediaria de API de IA optimizada específicamente para desarrolladores que buscan un acceso estable y económico, ofreciendo:

• Interfaz unificada compatible con OpenAI.
• Soporte para modelos principales como Claude, GPT, Gemini y DeepSeek.
• Pago por uso, sin cuotas mensuales obligatorias.
• Crédito de prueba gratuito al iniciar.
• Soporte al cliente en idioma local.

{
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI",
      "options": {
        "baseURL": "https://api.apiyi.com/v1"
      },
      "models": {
        "claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" },
        "claude-opus-4-20250514": { "name": "Claude Opus 4" },
        "gpt-4o": { "name": "GPT-4o" },
        "gpt-4o-mini": { "name": "GPT-4o Mini" },
        "gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
        "deepseek-chat": { "name": "DeepSeek V3" }
      }
    }
  }
}

Detalles de configuración de OpenRouter

OpenRouter agrega más de 400 modelos de IA, siendo ideal para quienes necesitan experimentar con las últimas novedades:

{
  "provider": {
    "openrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenRouter",
      "options": {
        "baseURL": "https://openrouter.ai/api/v1",
        "apiKey": "{env:OPENROUTER_API_KEY}",
        "headers": {
          "HTTP-Referer": "https://your-app.com",
          "X-Title": "My OpenCode App"
        }
      },
      "models": {
        "anthropic/claude-sonnet-4": {
          "name": "Claude Sonnet 4"
        },
        "google/gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro"
        },
        "meta-llama/llama-3.1-405b": {
          "name": "Llama 3.1 405B"
        }
      }
    }
  }
}

💡 Sugerencia de selección: Si utilizas principalmente las series Claude y GPT, te recomendamos APIYI (apiyi.com) por sus precios más competitivos y rapidez de respuesta. Si necesitas acceso a modelos de código abierto o de nicho, OpenRouter ofrece la mayor cobertura.

Técnicas de configuración avanzada de OpenCode

Estrategia de asignación de modelos de Agent

OpenCode incluye dos agentes integrados, Coder y Planner, y puedes asignarles diferentes modelos:

{
  "agent": {
    "coder": {
      "model": "apiyi/claude-sonnet-4-20250514",
      "maxTokens": 8000,
      "description": "主要编码任务,使用强模型"
    },
    "planner": {
      "model": "apiyi/gpt-4o-mini",
      "maxTokens": 4000,
      "description": "规划分析,使用轻量模型节省成本"
    }
  }
}

Cambio entre múltiples Providers

Después de configurar varios proveedores (Providers), puedes usar el comando /models en OpenCode para cambiar de uno a otro en cualquier momento:

# Iniciar OpenCode
opencode

# Cambiar de modelo en la TUI
/models
# Seleccionar apiyi/claude-sonnet-4-20250514 u otro modelo

Mejores prácticas para variables de entorno

Se recomienda gestionar tus claves API en un archivo .env:

# Archivo .env
APIYI_API_KEY=sk-your-apiyi-key
OPENROUTER_API_KEY=sk-or-your-openrouter-key

Luego, haz referencia a ellas en tu opencode.json:

{
  "provider": {
    "apiyi": {
      "options": {
        "apiKey": "{env:APIYI_API_KEY}"
      }
    }
  }
}

Configuración de límites de tokens

Define límites de contexto y de salida para el modelo para evitar errores por exceder el límite permitido:

{
  "models": {
    "claude-sonnet-4-20250514": {
      "name": "Claude Sonnet 4",
      "limit": {
        "context": 200000,
        "output": 65536
      }
    }
  }
}

Resolución de problemas comunes en OpenCode

Aquí tienes algunos problemas que podrías encontrar durante la configuración y sus soluciones:

"baseURL": "https://api.apiyi.com/v1"

"baseURL": "https://api.apiyi.com/v1/chat/completions"

{
  "provider": {
    "apiyi": {
      "models": {
        "claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514"
}

# Ver la información de autenticación configurada
opencode auth list

# Ver los modelos disponibles
opencode
/models

# Probar con un diálogo sencillo
opencode -p "Hola, responde en español, por favor"

opencode
/models
# Simplemente selecciona el modelo bajo el Provider que desees

{
  "model": "apiyi/claude-sonnet-4-20250514"
}

OpenCode vs Claude Code: Comparativa de acceso a la API

🎯 Sugerencia técnica: La mayor ventaja de OpenCode es su flexibilidad de modelos. Si lo combinas con el intermediario APIYI (apiyi.com), podrás alternar entre Claude, GPT-4, Gemini y muchos otros modelos usando la misma configuración, permitiéndote encontrar siempre la opción con mejor relación calidad-precio.

Referencias

Aquí tienes algunos recursos útiles para configurar OpenCode:

Resumen

Con este método de configuración de 3 pasos, ya dominas cómo:

1. Instalar OpenCode: utiliza el script de un solo clic o un gestor de paquetes para una instalación rápida.
2. Configurar la clave API: establece la autenticación mediante el comando /connect o variables de entorno.
3. Crear el archivo de configuración: escribe el archivo opencode.json para especificar el servidor intermediario y el modelo.

OpenCode, como asistente de programación por IA de código abierto para la terminal, ofrece una experiencia comparable a Claude Code cuando se usa con un intermediario de API, manteniendo los costes bajo control y la flexibilidad en la elección de modelos.

Te recomendamos usar APIYI (apiyi.com) para obtener rápidamente tus claves API y empezar las pruebas. La plataforma ofrece una cuota gratuita y es compatible con los principales modelos como Claude, GPT y Gemini; su formato de interfaz unificado simplifica enormemente la configuración.

📝 Autor: Equipo técnico de APIYI | APIYI apiyi.com – Simplificando las llamadas a las API de IA.