¡Invita a amigos y gana tokens gratuitos!Saber más

Integrando OpenCode con modelos personalizados de CodingPlanX

Utilice OpenCode, el asistente de programación de IA de terminal de código abierto, junto con la API de CodingPlanX para crear la experiencia de desarrollo de línea de comandos definitiva.

🌟 Introducción al proyecto

OpenCode es un asistente de programación de IA de terminal 100% de código abierto. Su diseño es similar a Claude Code, pero ofrece extrema flexibilidad y capacidades de personalización. No está vinculado a ningún proveedor de servicios de IA específico, admite el cambio perfecto entre múltiples modelos, cuenta con integración nativa de LSP (Protocolo de servidor de lenguaje) y cuenta con una TUI (interfaz de usuario de terminal) amigable para geeks.

Captura de pantalla de OpenCode

1. Características principales de OpenCode

OpenCode es un agente de programación de IA de código abierto desarrollado por el equipo de SST, creado específicamente para geeks y usuarios intensivos de terminales:

  • 🔓 100% Código abierto: Basado en la licencia MIT, el código es completamente transparente.
  • 🧠 Soporte multimodelo: Puede configurar y cambiar sin problemas entre Claude, OpenAI, Google Gemini y más.
  • ⚡ Soporte nativo LSP: El Protocolo de servidor de lenguaje integrado proporciona un análisis de código inteligente y una navegación increíblemente rápidos y precisos.
  • 🖥️ TUI primero: Diseñado para usuarios de terminales por usuarios veteranos de Neovim, totalmente operable con el teclado.
  • 🌐 Arquitectura C/S: Admite la conducción remota; ejecute el servidor localmente y contrólelo de forma remota a través del móvil u otra PC.
  • 🔄 Agentes duales integrados: Incluye build (acceso completo de lectura/escritura para el desarrollo principal) y plan (solo lectura para análisis y planificación) de forma predeterminada.

2. oh-my-opencode (Mejora recomendada)

oh-my-opencode es el complemento de mejora definitivo para OpenCode, conocido en la comunidad como "OpenCode con esteroides". Proporciona una experiencia de programación de IA profesional lista para usar.

Interfaz de oh-my-opencode

Características de mejora principales:

  • Subagentes asíncronos: Capacidades de procesamiento de tareas en paralelo similares a Claude Code, mejorando significativamente la eficiencia para tareas complejas.
  • Configuraciones de agentes seleccionadas: Preconfigurado con múltiples roles de agentes profesionales (por ejemplo, Arquitecto, Bibliotecario, Explorador).
  • Herramientas AST avanzadas: Admite refactorización inteligente, análisis profundo de código, búsqueda de símbolos y otras funciones avanzadas.
  • Modo Ultrawork: Simplemente agregue ultrawork a su prompt para habilitar automáticamente el modo de procesamiento paralelo definitivo.

Descripción general de los roles de agentes integrados:

Nombre del agenteModelo recomendadoPropósito principal
👑 SisyphusClaude Opus 4.6Agente de orquestación principal, responsable de la planificación global y la delegación de tareas paralelas en segundo plano
🔮 OracleGPT 5.2Diseño de arquitectura, revisión profunda de código, análisis de estrategia técnica
📚 LibrarianClaude Sonnet 4.6Análisis de múltiples repositorios, búsqueda de documentación oficial, búsqueda de ejemplos de implementación de código abierto
🗺️ ExploreGrok Code / HaikuEscaneo rápido de código, exploración de repositorios y coincidencia de patrones
🎨 FrontendGemini 3 ProEspecialista en frontend, excelente en la creación de UI/UX hermosas e intuitivas

🚀 Instalación y configuración

Paso 1: Instalar el programa principal OpenCode

OpenCode itera muy rápidamente, por lo que se recomienda usar el script oficial para instalar la última versión (Documentos oficiales):

# Instalación rápida usando curl (Recomendado)
curl -fsSL https://opencode.ai/install | bash

# O usar administradores de paquetes de Node.js
npm install -g opencode  # bun / pnpm / yarn también funcionan

# Los usuarios de macOS también pueden usar Homebrew
brew install opencode

Paso 2: Instalar oh-my-opencode (Altamente recomendado)

oh-my-opencode proporciona plantillas de configuración profesionales listas para usar, lo que le ahorra un ajuste manual tedioso:

bunx oh-my-opencode install

💡 Consejo: El proceso de instalación entrará en un asistente interactivo preguntando qué suscripciones de IA tiene (ej., Claude, ChatGPT). Marque las casillas de acuerdo a su situación real.

Paso 3: Configurar endpoints y modelos de la API de CodingPlanX

¡Este es el paso más crucial! Utilice un editor de texto para crear o modificar el archivo de configuración: ~/.config/opencode/opencode.json.

🎯 Sobre la selección de modelos: La plantilla de configuración a continuación utiliza los modelos de la serie Claude y la serie GPT Codex proporcionados por CodingPlanX. Tienen el mejor rendimiento en varios puntos de referencia de programación autorizados y son el dúo dorado para los desarrolladores.

Copie el siguiente contenido JSON en su totalidad y sobrescriba su opencode.json:

<details open=""> <summary><b>Haz clic para expandir el código de configuración completo de opencode.json</b></summary> 
{
  "$schema": "https://opencode.ai/config.json",

  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.codingplanx.ai/v1"
      }
    },
    "openai": {
      "options": {
        "baseURL": "https://api.codingplanx.ai"
      }
    }
  },

  "model": "anthropic/claude-opus-4-5-20251101",
  "small_model": "anthropic/claude-haiku-4-5-20251001",
  "default_agent": "build",

  "permission": {
    "read": "allow", "list": "allow", "glob": "allow", "grep": "allow",
    "codesearch": "allow", "lsp": "allow",
    "edit": "ask", "bash": "ask", "webfetch": "ask", "websearch": "ask",
    "external_directory": "deny", "doom_loop": "ask"
  },

  "agent": {
    "plan": {
      "mode": "primary",
      "description": "Planificación/Desglose/Especificación técnica (Solo lectura para evitar cambios accidentales en el código)",
      "model": "anthropic/claude-opus-4-5-20251101",
      "temperature": 0.1,
      "prompt": "Eres un líder técnico senior. Objetivo: Desglosar los requisitos en pasos procesables (incluyendo criterios de aceptación/riesgos/reversiones). Por defecto es solo lectura; no modifiques archivos ni ejecutes comandos. Si realmente se necesita ejecución, explica por qué y sugiere cambiar a build/codex.",
      "permission": { "edit": "deny", "bash": "deny", "webfetch": "deny", "websearch": "deny", "doom_loop": "deny" }
    },

    "build": {
      "mode": "primary",
      "description": "Desarrollo principal (Implementación integral/depuración/corrección de pruebas) - Claude Opus 4.6",
      "model": "anthropic/claude-opus-4-5-20251101",
      "temperature": 0.2,
      "prompt": "Eres el agente principal de ingeniería de software. Prioridades: Cambios mínimos viables, legibilidad, capacidad de prueba. Explica brevemente tu plan antes de hacer cambios. Después de cambiar, debes proporcionar: puntos clave de diff, cómo verificar localmente (comandos) y posibles casos extremos.",
      "permission": { "edit": "allow", "bash": "allow", "webfetch": "ask", "websearch": "ask", "doom_loop": "ask" }
    },

    "codex": {
      "mode": "primary",
      "description": "Refactorización/Migración/Cambios importantes (Codex) - GPT-5.2",
      "model": "openai/gpt-5.2-2025-12-11",
      "temperature": 0.2,
      "prompt": "Eres un agente de ingeniería estilo Codex, que sobresale en refactorización a gran escala, migraciones, revisiones de código y colaboración en cadenas de herramientas complejas. Prioriza mantener el proyecto ejecutable: commits paso a paso, verificables en cada paso. Agrega salvaguardas y pruebas primero cuando no estés seguro.",
      "permission": { "edit": "allow", "bash": "allow", "webfetch": "ask", "websearch": "ask", "doom_loop": "ask" }
    },

    "review": {
      "mode": "subagent",
      "description": "Revisión de código/Segundo cerebro (Solo lectura) - GPT-5.1-Codex-Max",
      "model": "openai/gpt-5.1-codex-max",
      "temperature": 0.1,
      "prompt": "Eres un estricto revisor de código. Salida: 1) Riesgos clave (errores/seguridad/concurrencia/casos extremos) 2) Sugerencias de mantenibilidad 3) Sugerencias de modificación mínima (pseudo-diff está bien) 4) Puntos de prueba necesarios. Por defecto es solo lectura; no modifiques archivos ni ejecutes comandos.",
      "permission": { "edit": "deny", "bash": "deny", "webfetch": "deny", "websearch": "deny", "doom_loop": "deny" }
    },

    "explore": {
      "mode": "subagent",
      "description": "Escaneo rápido de código/Localización de archivos/Resumen de contexto (Solo lectura) - Claude Haiku 4.5",
      "model": "anthropic/claude-haiku-4-5-20251001",
      "temperature": 0.1,
      "prompt": "Eres un subagente de exploración rápida: Usa pasos mínimos para localizar archivos/funciones/cadenas de llamadas relevantes, proporcionando rutas y resúmenes claros. Por defecto es solo lectura; no modifiques archivos ni ejecutes comandos.",
      "permission": { "edit": "deny", "bash": "deny" }
    },

    "general": {
      "mode": "subagent",
      "description": "Investigación general/Documentación/Comparación de soluciones (Costo medio) - Claude Sonnet 4.6",
      "model": "anthropic/claude-sonnet-4-5-20250929",
      "temperature": 0.2,
      "prompt": "Eres un subagente de análisis general: Enfocado en explicar, sopesar opciones, escribir documentación y comparar soluciones. Por defecto es solo lectura; evita modificar el código si es posible.",
      "permission": { "edit": "deny", "bash": "deny" }
    },

    "think": {
      "mode": "subagent",
      "description": "Pensamiento asistido/Deducción de casos extremos (Solo lectura) - GPT-5.2",
      "model": "openai/gpt-5.2-2025-12-11",
      "temperature": 0.2,
      "prompt": "Eres un subagente de razonamiento y deducción de casos extremos: Proporciona análisis y sugerencias estructuradas sobre el diseño, rutas de excepción, concurrencia/consistencia y cuellos de botella de rendimiento. Por defecto es solo lectura.",
      "permission": { "edit": "deny", "bash": "deny" }
    }
  }
}
</details>

Paso 4: Configurar Claves API

Dado que configuramos dos proveedores (Anthropic y OpenAI), debes vincular las Claves API que obtuviste de CodingPlanX dentro de OpenCode.

  1. Escribe opencode en la terminal para iniciar el programa.
  2. En el cuadro de diálogo, escribe el comando /connect.
  3. Configurar Claude:
    • Selecciona Anthropic -> Selecciona Manually enter API Key (Ingresar Clave API manualmente).
    • Pega tu Clave API de CodingPlanX y presiona Enter para guardar.
  4. Configurar OpenAI:
    • Escribe /connect de nuevo.
    • Selecciona OpenAI -> Selecciona Manually enter API Key.
    • Pega tu Clave API de CodingPlanX y presiona Enter para guardar.
  5. Escribe /exit para salir, luego reinicia opencode para que la configuración surta efecto.

🔐 Nota: Tus Claves API se guardan de forma segura localmente en el archivo ~/.local/share/opencode/auth.json.

💡 Consejos de uso avanzado

Después de completar la configuración, escribe opencode en la terminal para comenzar a chatear:

> Hola, lee el package.json en el directorio actual e introduce este proyecto.

1. ⚡ Ultrawork (Modo paralelo definitivo)

Si instalaste oh-my-opencode, simplemente agrega ultrawork (o ulw de forma abreviada) a tu prompt, y OpenCode convocará al agente principal para desglosar la tarea y enviarla a subagentes en segundo plano para el procesamiento en paralelo:

> ultrawork Ayúdame a refactorizar el módulo de autenticación en el directorio src/auth y agrega pruebas unitarias.

2. 🎯 Sintaxis @ para invocar agentes específicos

Puedes usar el símbolo @ para enviar tareas precisas a los agentes profesionales que configuramos en el JSON:

> @review Ayúdame a revisar la lógica de login.ts recién confirmada en busca de vulnerabilidades de seguridad.
> @explore Busca todos los endpoints de API en el proyecto que llaman a getUserInfo.
> @general Ayúdame a comparar si es mejor usar React Context o Redux para el proyecto actual.

3. 🔄 Tecla Tab para cambio rápido de modo

Presiona la tecla Tab en el cuadro de entrada para alternar rápidamente entre los agentes principales:

  • build: Modo principal, con permisos completos de lectura/escritura de archivos y ejecución en terminal.
  • plan: Modo seguro, permisos de solo lectura, utilizado para el desglose inicial de requisitos, análisis de arquitectura y planificación técnica para evitar que la IA modifique accidentalmente el código.

🛠️ Preguntas frecuentes y resolución de problemas

P1: ¿Aparece un error de conexión API o tiempo de espera agotado?

  • Verifica si la URL baseURL en opencode.json es correcta.
  • Verifica si la terminal tiene conflictos de proxy (generalmente el uso de una IP directa omite los problemas de proxy del sistema).

P2: ¿Indica "Model not found" (Modelo no encontrado) o modelo no disponible?

  • Confirma que el ID del modelo en el archivo de configuración (ej., claude-opus-4-5-20251101) coincide exactamente con la lista de modelos proporcionada oficialmente por CodingPlanX. No lo escribas mal.

P3: ¿El complemento oh-my-opencode arroja un error?

  • El complemento se encuentra en una fase de desarrollo de alta velocidad. Si encuentras un error (bug), intenta actualizarlo: bunx oh-my-opencode update.
  • Para más problemas de configuración, consulta la Documentación oficial de oh-my-opencode.

🔗 Lecturas adicionales y próximos pasos