Configuración de clave API de OpenCode

Configuración de clave API de OpenCode: URL base, proveedor y modelos

OpenCode con una API de terceros necesita tres cosas: una clave API, una base_url y una configuración de proveedor.

Pago por uso para Claude, Kimi, GLM y más: obtén una clave API, configura base_url y provider en opencode.json, luego confirma con un mensaje de prueba.

OpenCode está instalado: configúralo Aún no está instalado: comienza con la instalación

Ejemplo de opencode.jsonJSON

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "aicodewith-anthropic/claude-opus-5-5",
  "provider": {
    "aicodewith-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Code With Anthropic",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "your-aicodewith-api-key"
      },
      "models": {
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        }
      }
    }
  }
}

OpenCode not installed?

This page configures the OpenCode terminal CLI. If opencode --version already prints a version, skip ahead to the quick setup.

Open the official OpenCode download page Already installed: continue

Comando de instalación básico

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

Or install globally with npm (this exact command is commonly searched)

npm install -g opencode-ai@latest

Installation succeeds when opencode --version prints a version number.

Continue with AI Code With Read the official installation docs

Configuración rápida segura

Elige un modelo, copia la configuración, guarda el archivo y verifica la conexión en unos 3 minutos.

1. Elige un modelo

El catálogo actual contiene 47 modelos.

2. Copia la configuración

Proveedor: aicodewith-anthropic
Adaptador npm: @ai-sdk/anthropic
URL base: https://api.aicodewith.ai/v1
ID de modelo: claude-opus-5-5

{
  "$schema": "https://opencode.ai/config.json",
  "model": "aicodewith-anthropic/claude-opus-5-5",
  "provider": {
    "aicodewith-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Code With Anthropic",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "your-aicodewith-api-key"
      },
      "models": {
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        }
      }
    }
  }
}

Siguiente: guardar la configuración

3. Guarda opencode.json y configura la clave API

Haz una copia de seguridad de un opencode.json existente, luego fusiona tanto el modelo como el proveedor del contenido generado. Conserva otros proveedores y guarda la clave real solo en una variable de entorno local.

Abrir la página de clave API

Guardar el archivo de configuración

1. Abre la terminal de tu sistema
2. Ejecuta el comando de abajo para abrir el archivo de configuración (se crea automáticamente si no existe):
```
notepad "$env:USERPROFILE\.config\opencode\opencode.json"
```
3. Pega la configuración copiada en el paso 2 y guárdala
Pulsa Ctrl+S en Windows/Linux, Cmd+S en macOS.

Configura la clave API (reemplaza tu-clave con tu clave real)

Abre una nueva terminal o recarga la configuración de tu shell, luego reinicia OpenCode.

4. Reinicia y verifica

Ejecutar en la terminal de tu sistemaopencode
Escribir dentro de OpenCode/models confirma que el ID de proveedor y modelo coinciden con la selección de la página
Enviar en el chatReply with exactly: connection successful
confirma que OpenCode muestra una respuesta y coincide su hora y modelo en los registros de uso de AI Code With

Los registros de uso confirman que una solicitud llegó a AI Code With. Determina el éxito a partir del estado, el contenido de la respuesta y la respuesta realmente mostrada en OpenCode.

La configuración no se cargó: solucionar problemas

¿Cómo se conecta OpenCode a una API de terceros?

OpenCode utiliza un Provider personalizado para enviar solicitudes al servicio API que elijas: el Provider es el espacio de nombres que le dice a OpenCode qué servicio llamar, la clave API maneja la autenticación, la Base URL es el endpoint de la API de terceros, y el Model ID selecciona el modelo real.

Una vez guardado, las solicitudes fluyen a lo largo de OpenCode → Provider → Base URL → API del modelo. Después de una verificación con /models y un breve mensaje de prueba, puedes comparar la solicitud con tus registros de uso por tiempo y modelo.

Si la configuración falla, revisa estas 4 cosas primero

Cada elemento enlaza a un artículo de solución de problemas dedicado con pasos detallados.

401 No autorizado
Ver solución de problemas detallada →
Por lo general, la clave API no es válida, está mal escrita o no se lee correctamente. Verifica que AICODEWITH_API_KEY esté configurada sin espacios adicionales y que OpenCode se inicie desde la misma terminal.
Modelo no encontrado
Ver solución de problemas detallada →
El Model ID no coincide con la configuración del Provider, o el canal no admite el modelo. Compara el Model ID generado y el par de Provider carácter por carácter.
Base URL / 404
Ver solución de problemas detallada →
Por lo general, la Base URL es incorrecta. Copia el valor generado en esta página y no añadas /v1, /v1beta, ni inventes una ruta de endpoint.
Configuración no aplicada / Provider faltante
Ver solución de problemas detallada →
Verifica la ruta del archivo de configuración, que el JSON sea válido y que OpenCode haya recargado el archivo. Vuelve a abrir OpenCode después de guardar, luego ejecuta /models.

Preguntas frecuentes

¿Cuál debería ser la Base URL?

Copia la Base URL generada por la configuración rápida de arriba. No añadas /v1 o /v1beta manualmente.

¿Dónde está el archivo de configuración de OpenCode?

Esta página genera ~/.config/opencode/opencode.json. Las rutas pueden variar según el método de instalación y la versión, así que compáralo con la documentación actual de OpenCode.

¿Cómo confirmo que la configuración funciona?

Ejecuta /models para seleccionar el modelo, envía un mensaje corto, luego compara la solicitud por tiempo y modelo en los registros de uso de AI Code With.

¿Qué modelos son compatibles?

Claude, GPT, Gemini, DeepSeek, GLM, Kimi y Grok, entre otros. Haz clic en "Ver todos los modelos" para explorar el catálogo completo.

¿Necesitas documentación completa de instalación o solución de problemas?

Consulta la documentación de configuración de OpenCode para guías de instalación completas, cada parámetro de configuración, la lista completa de modelos y solución de problemas.

Abrir la documentación de configuración de OpenCode