Capitulo 9: Proveedores Cloud

< Volver al Indice del Tutorial

OpenCode soporta mas de 75 proveedores LLM a traves del AI SDK de Vercel y el catalogo de Models.dev. Esto significa que puedes usar practicamente cualquier modelo de lenguaje disponible en el mercado.

Configurar Proveedores

API Keys con /connect

La forma mas rapida de configurar un proveedor es usando el comando /connect dentro de OpenCode:

# Dentro de una sesion de OpenCode
/connect

Las credenciales se almacenan en:

~/.local/share/opencode/auth.json

Tambien puedes configurar API keys como variables de entorno en tu shell o en el archivo opencode.json.

Proveedores Principales

Anthropic (Claude)

# Variable de entorno
export ANTHROPIC_API_KEY="sk-ant-..."

// opencode.json
{
  "provider": "anthropic",
  "model": "claude-opus-4-6"
}

Modelos disponibles:

Modelo	Uso recomendado
claude-opus-4-6	Desarrollo complejo, arquitectura
claude-sonnet-4-6	Desarrollo general, buen balance
claude-haiku-4.5	Tareas rapidas, bajo costo

OpenAI

export OPENAI_API_KEY="sk-..."

{
  "provider": "openai",
  "model": "gpt-4o"
}

Modelos disponibles:

Modelo	Uso recomendado
gpt-4o	Desarrollo general
o1	Razonamiento complejo
o3	Razonamiento avanzado

Google Vertex AI

Requiere configuracion de proyecto Google Cloud:

export GOOGLE_CLOUD_PROJECT="mi-proyecto-id"
# Autenticacion via gcloud
gcloud auth application-default login

{
  "provider": "google",
  "model": "gemini-3.1-pro"
}

Modelos disponibles:

Modelo	Uso recomendado
gemini-3.1-pro	Desarrollo general, ventana de contexto grande

Amazon Bedrock

Soporta multiples metodos de autenticacion AWS:

# Opcion 1: AWS profiles
export AWS_PROFILE="mi-perfil"

# Opcion 2: Access keys
export AWS_ACCESS_KEY_ID="AKIA..."
export AWS_SECRET_ACCESS_KEY="..."

# Opcion 3: Bearer tokens (SSO)
export AWS_REGION="us-east-1"

{
  "provider": "amazon-bedrock",
  "model": "anthropic.claude-3-5-sonnet-20241022-v2:0"
}

Azure OpenAI

Requiere un endpoint custom de tu recurso Azure:

export AZURE_OPENAI_API_KEY="..."
export AZURE_OPENAI_ENDPOINT="https://mi-recurso.openai.azure.com"

{
  "provider": "azure-openai",
  "model": "gpt-4o"
}

DeepSeek

Modelos economicos con buen rendimiento para codigo:

export DEEPSEEK_API_KEY="sk-..."

{
  "provider": "deepseek",
  "model": "deepseek-chat"
}

xAI (Grok)

export XAI_API_KEY="xai-..."

{
  "provider": "xai",
  "model": "grok-2"
}

OpenRouter

Proxy a multiples proveedores con una sola API key. Ideal para probar diferentes modelos sin configurar cada proveedor:

export OPENROUTER_API_KEY="sk-or-..."

{
  "provider": "openrouter",
  "model": "anthropic/claude-sonnet-4-6"
}

Proveedores Custom (OpenAI-Compatible)

Si tu proveedor expone una API compatible con OpenAI, puedes configurarlo manualmente:

npm install @ai-sdk/openai-compatible

{
  "provider": {
    "type": "openai-compatible",
    "baseURL": "https://mi-servidor.com/v1",
    "apiKey": "mi-api-key",
    "models": ["mi-modelo-custom"]
  }
}

Esto funciona con cualquier servidor que implemente el protocolo de chat completions de OpenAI, incluyendo servidores locales como vLLM, text-generation-inference, o endpoints privados.

Gestionar Proveedores

Listar proveedores configurados

opencode auth list

Deshabilitar proveedores especificos

En opencode.json:

{
  "disabled_providers": ["deepseek", "xai"]
}

Habilitar solo ciertos proveedores

{
  "enabled_providers": ["anthropic", "openai"]
}

Cuando usas enabled_providers, todos los demas proveedores quedan deshabilitados automaticamente.

Tabla Resumen

Proveedor	Modelos destacados	Setup rapido
Anthropic	Claude Opus 4.6, Sonnet 4.6	ANTHROPIC_API_KEY
OpenAI	GPT-4o, o1, o3	OPENAI_API_KEY
Google Vertex	Gemini 3.1	GOOGLE_CLOUD_PROJECT + gcloud
Amazon Bedrock	Claude, Llama	AWS profile o access keys
Azure OpenAI	GPT-4o	Endpoint + API key
DeepSeek	DeepSeek Chat	DEEPSEEK_API_KEY
xAI	Grok 2	XAI_API_KEY
OpenRouter	100+ modelos	OPENROUTER_API_KEY

Consejos Practicos

• Empieza con un proveedor: no intentes configurar todos al inicio
• Usa variables de entorno: mas seguro que poner keys en archivos de configuracion
• OpenRouter es util para experimentar: una sola key te da acceso a docenas de modelos
• Revisa los costos: cada proveedor tiene precios diferentes por token

---

Siguiente: Capitulo 10: Ollama y Modelos Locales —>