Saltar al contenido principal
OpenCode es un agente de programación con IA (Coding Agent) de código abierto orientado a desarrolladores, centrado en una experiencia “nativa de terminal”: permite completar flujos de trabajo como discusión de requisitos, generación de código, refactorización, explicación y depuración directamente desde la línea de comandos mediante TUI/CLI. Hace énfasis en ser “independiente del modelo”, por lo que puede conectarse a servicios de modelos como Claude, GPT y Gemini, y también admite interfaces locales o compatibles con OpenAI, lo que facilita elegir libremente entre costo, rendimiento y privacidad. OpenCode también ofrece un sistema extensible de plugins/herramientas y configuración, capaz de incorporar el contexto del proyecto, la ejecución de comandos y otras capacidades en flujos automatizados. Es adecuado para usuarios intensivos de terminal y equipos que desean personalizar sus flujos de trabajo de programación con IA.

Instalación e integración

Instalación

curl -fsSL https://opencode.ai/install | bash
Para otros métodos de instalación, consulta el sitio web oficial de OpenCode: https://opencode.ai/docs/#install

Iniciar OpenCode

cd /path/to/project  # Entrar en la ruta del proyecto

opencode  # Iniciar OpenCode

Integrar JieKou API

  • Configuración global: ~/.config/opencode/opencode.json
  • Configuración del proyecto: opencode.json en el directorio raíz del proyecto
(Si no existe opencode.json, puedes crearlo manualmente) La configuración es la siguiente:
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "JieKou",
      "options": {
        "baseURL": "https://api.highwayapi.ai/openai/v1"
      },
      "models": {
        "claude-sonnet-4-5-20250929": {
          "name": "claude-sonnet-4-5-20250929"
        },
        "gpt-5.2": {
          "name": "gpt-5.2"
        },
      }
    }
  }
}
Al configurar proveedores de terceros, debes elegir el paquete npm correcto:
Paquete npmTipo de APIEscenario de uso
@ai-sdk/openai-compatibleChat Completion APILa mayoría de los modelos, como GPT y Claude
@ai-sdk/openaiResponse APIModelos de la serie Codex
Nota: Los modelos Codex (como gpt-5.1-codex) deben usar @ai-sdk/openai (Response API); los demás modelos deben usar @ai-sdk/openai-compatible (Chat Completion API).

Configurar KEY

Entra en opencode, usa /connect para seleccionar el proveedor, introduce la API KEY y confirma con enter. opencode_input_api_key

Empezar a usar

Después de conectar el proveedor, puedes usar el comando /models para seleccionar el modelo. opencode_choose_model

Otros usos

Ejemplo: configuración local de MCP (tomando un MCP de cálculo como ejemplo)

  1. Usa python + MCP SDK para escribir el código del mcp server de calculadora y guárdalo en una ruta local.
import asyncio
import math
from mcp.server import Server
from mcp.server.stdio import stdio_server
from mcp.types import Tool, TextContent

# Create server instance
server = Server("calculator")

@server.list_tools()
async def list_tools() -> list[Tool]:
    """List available calculator tools."""
    return [
        Tool(
            name="add",
            description="Add two numbers",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "First number"},
                    "b": {"type": "number", "description": "Second number"},
                },
                "required": ["a", "b"],
            },
        ),
        Tool(
            name="subtract",
            description="Subtract second number from first number",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "First number"},
                    "b": {"type": "number", "description": "Second number to subtract"},
                },
                "required": ["a", "b"],
            },
        ),
        Tool(
            name="multiply",
            description="Multiply two numbers",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "First number"},
                    "b": {"type": "number", "description": "Second number"},
                },
                "required": ["a", "b"],
            },
        ),
        Tool(
            name="divide",
            description="Divide first number by second number",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "Dividend"},
                    "b": {"type": "number", "description": "Divisor"},
                },
                "required": ["a", "b"],
            },
        ),
        Tool(
            name="power",
            description="Raise a number to a power",
            inputSchema={
                "type": "object",
                "properties": {
                    "base": {"type": "number", "description": "Base number"},
                    "exponent": {"type": "number", "description": "Exponent"},
                },
                "required": ["base", "exponent"],
            },
        ),
        Tool(
            name="sqrt",
            description="Calculate square root of a number",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "Number to calculate square root of"},
                },
                "required": ["a"],
            },
        ),
        Tool(
            name="modulo",
            description="Calculate remainder of division",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "Dividend"},
                    "b": {"type": "number", "description": "Divisor"},
                },
                "required": ["a", "b"],
            },
        ),
    ]

@server.call_tool()
async def call_tool(name: str, arguments: dict) -> list[TextContent]:
    """Handle tool calls for calculator operations."""
    try:
        if name == "add":
            result = arguments["a"] + arguments["b"]
        elif name == "subtract":
            result = arguments["a"] - arguments["b"]
        elif name == "multiply":
            result = arguments["a"] * arguments["b"]
        elif name == "divide":
            if arguments["b"] == 0:
                return [TextContent(type="text", text="Error: Division by zero")]
            result = arguments["a"] / arguments["b"]
        elif name == "power":
            result = math.pow(arguments["base"], arguments["exponent"])
        elif name == "sqrt":
            if arguments["a"] < 0:
                return [TextContent(type="text", text="Error: Cannot calculate square root of negative number")]
            result = math.sqrt(arguments["a"])
        elif name == "modulo":
            if arguments["b"] == 0:
                return [TextContent(type="text", text="Error: Modulo by zero")]
            result = arguments["a"] % arguments["b"]
        else:
            return [TextContent(type="text", text=f"Error: Unknown tool '{name}'")]

        return [TextContent(type="text", text=str(result))]

    except Exception as e:
        return [TextContent(type="text", text=f"Error: {str(e)}")]

async def main():
    """Run the calculator MCP server."""
    async with stdio_server() as (read_stream, write_stream):
        await server.run(read_stream, write_stream, server.create_initialization_options())

if __name__ == "__main__":
    asyncio.run(main())

  1. Añade el mcp local en opencode.json.
{
  "mcp": {
    "calc_mcp": {
      "type": "local",
      "command": ["python3", "{your_local_path}/calc_mcp.py"],
      "enabled": true
    }
  }
}
  1. Usa /mcps para ver el estado de conexión del mcp. Cuando esté en estado Enabled, puedes hacer que opencode lo invoque.
opencode_mcp