Saltar al contenido principal

​
Descripción general

OpenCode Interface OpenCode es una herramienta de programación de línea de comandos (CLI) de código abierto basada en Go que proporciona potente asistencia de IA para desarrolladores. Ofrece una interfaz de usuario de terminal (TUI) intuitiva y es compatible con múltiples proveedores de LLM, incluyendo OpenAI, Anthropic, Gemini y más. Al integrar OpenCode con EvoLink API, puedes acceder a los modelos Claude de EvoLink (como Claude 4.5 Opus, Claude 4.5 Sonnet, Claude 4.5 Haiku) a través de una interfaz unificada con una sola clave y una sola URL base.

​
Requisitos previos

Antes de configurar, asegúrate de tener:

​
1. Emulador de terminal

OpenCode requiere un emulador de terminal moderno. Opciones recomendadas:
  • WezTerm (multiplataforma)
  • Alacritty (multiplataforma)
  • Ghostty (Linux y macOS)
  • Kitty (Linux y macOS)
Los usuarios de Windows también pueden usar PowerShell o Windows Terminal. Los usuarios de macOS pueden usar la aplicación Terminal.app integrada o iTerm2. Los usuarios de Linux pueden usar la terminal integrada o GNOME Terminal, Konsole, etc.
  • Inicia sesión en el Panel de EvoLink
  • Busca API Keys en el panel, haz clic en el botón ‘Create New Key’ y luego copia la clave generada
  • La clave API generalmente comienza con sk-

​
Paso 1: Instalar OpenCode

Consejo: Si no sabes cómo abrir una terminal de línea de comandos, consulta Preguntas frecuentes - Cómo abrir la terminal de línea de comandos
La forma más fácil es mediante el script de instalación:
curl -fsSL https://opencode.ai/install | bash
O usando Homebrew:
brew install anomalyco/tap/opencode

​
Verificar la instalación

opencode --version
Indicador de éxito: Muestra la información de la versión. Si prefieres una interfaz gráfica, OpenCode también ofrece una aplicación de escritorio disponible en la Página de descarga de OpenCode.

​
1. Inicializar el proveedor

Después de la instalación, ejecuta el siguiente comando en tu terminal antes de iniciar OpenCode: 
opencode auth login
Select Provider
  1. En la lista de proveedores, selecciona other (al final de la lista, puedes buscarlo)
  2. Introduce el Provider ID: escribe evolink
Enter Provider ID
  1. Introduce el API Key token: puedes introducir cualquier valor (por ejemplo, admin), la clave real se referencia a través del archivo de configuración
Enter API Key Este paso registra un proveedor personalizado en el administrador de credenciales local de OpenCode.

​
2. Editar el archivo de configuración

Abre el directorio de configuración de OpenCode:
Presiona Win + R, pega lo siguiente y luego presiona Enter:
%userprofile%\.config\opencode
Windows Config Directory
Crea o edita opencode.json en este directorio: 
{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "evolink": {
            "npm": "@ai-sdk/anthropic",
            "name": "Evolink",
            "options": {
                "baseURL": "https://code.evolink.ai/v1",
                "apiKey": "your-evolink-api-key"
            },
            "models": {
                "claude-opus-4-5-20251101": {
                    "name": "Claude-4.5-Opus"
                },
                "claude-sonnet-4-5-20250929": {
                    "name": "Claude-4.5-Sonnet"
                },
                "claude-haiku-4-5-20251001": {
                    "name": "Claude-4.5-Haiku"
                }
            }
        }
    }
}
⚠️ Importante:
  • Reemplaza "your-evolink-api-key" con tu clave API real
  • El formato JSON es sensible a los símbolos

​
Paso 3: Comenzar a usar OpenCode

​
1. Iniciar OpenCode

Después de guardar el archivo de configuración, reinicia tu terminal y luego navega a tu directorio de trabajo: 
cd your-working-directory
Inicia OpenCode: 
opencode

​
2. Verificar la configuración

En la interfaz de chat, introduce el comando: 
/models
OpenCode Interface and Model Selection Deberías ver Evolink y sus modelos en la lista de modelos. Selecciona uno y estarás listo para comenzar.

​
Preguntas frecuentes

​
1. ¿Qué es OpenCode y para qué sirve?

OpenCode es un asistente de codificación con IA de código abierto para terminal con una interfaz TUI moderna. Es compatible con la edición de código, operaciones de archivos y ejecución de comandos, ideal para programación asistida por IA en entornos de terminal.

​
2. ¿Cómo verifico la instalación y configuración en el primer uso?

Sigue estos pasos en orden:
  • opencode --version: Confirma que OpenCode está instalado
  • Inicia OpenCode e introduce /models: Confirma que puedes ver los modelos configurados

​
3. ¿Dónde debe colocarse el archivo de configuración?

El archivo de configuración opencode.json debe colocarse en:
  • Windows: C:\Users\{username}\.config\opencode\opencode.json
  • macOS / Linux: ~/.config/opencode/opencode.json

​
4. ¿Qué modelos admite OpenCode?

A través de EvoLink API, OpenCode admite estos modelos Claude:
  • Claude 4.5 Opus: El modelo más potente para tareas complejas
  • Claude 4.5 Sonnet: Rendimiento y velocidad equilibrados
  • Claude 4.5 Haiku: El modelo más rápido para tareas sencillas

​
5. ¿Cómo cambio de modelo?

En la interfaz de OpenCode, introduce el comando /models y luego selecciona el modelo deseado de la lista.

​
6. ¿Por qué no surten efecto mis cambios de configuración?

  • Reinicia OpenCode
  • Verifica la sintaxis de opencode.json (formato JSON)
  • Comprueba que la ruta del archivo de configuración sea correcta

​
7. ¿Qué causa los errores 401/403?

  • Error 401: La clave API no está configurada o no es válida
  • Error 403: Permisos insuficientes o clave expirada
  • Verifica el apiKey en tu archivo de configuración

​
8. ¿OpenCode leerá o subirá automáticamente mis archivos y código locales?

OpenCode solo lee el contenido de los archivos cuando lo autorizas explícitamente. Se recomienda usarlo en una carpeta de proyecto dedicada.

​
9. ¿OpenCode admite entrada y salida en chino?

Sí, es totalmente compatible.

​
10. ¿Para qué escenarios es adecuado OpenCode?

Adecuado para:
  • Escritura, depuración y refactorización de código
  • Programación asistida por IA en entornos de terminal
  • Análisis y procesamiento de contenido de archivos
  • Usuarios que prefieren interfaces TUI modernas
No adecuado para:
  • Interacciones GUI complejas
  • Usuarios no familiarizados con operaciones de terminal

​
11. ¿Cómo abrir la terminal de línea de comandos?

  • Método 1: Presiona Win + R, escribe cmd o powershell y luego presiona Enter
  • Método 2: Busca “Símbolo del sistema” o “PowerShell” en el menú Inicio
  • Método 3: Mantén presionado Shift y haz clic derecho en una carpeta, selecciona “Abrir ventana de PowerShell aquí”

​
Notas

Ejecuta OpenCode en una carpeta de proyecto dedicada. Evita ejecutarlo en directorios sensibles (como carpetas del sistema o directorios que contengan credenciales). OpenCode opera a partir del directorio de trabajo actual.
OpenCode utiliza archivos de configuración en formato JSON. Asegúrate de que la sintaxis de tu archivo de configuración sea correcta. Puedes usar validadores JSON en línea para verificar el formato.