Skip to content

🧠 Configuración de IA y Perfiles

En esta sección se detallan a fondo los comandos para la gestión de modelos de IA, cambio de proveedores de red, auditoría de cuotas financieras y aislamiento seguro del entorno.


⚙️ /config (Panel Global de Configuración)

Abre un menú de configuración interactivo y robusto directamente en tu terminal.

  • Sintaxis:
    text
    /config
  • Opciones del Panel:
    • API Keys: Configurar de forma visual las credenciales para OpenAI, Claude, Gemini, DeepSeek o Groq.
    • Configuración de Red: Habilitar proxies corporativos (SOCKS5/HTTP) para entornos seguros o restringidos.
    • Directivas globales: Definir el modelo predeterminado de arranque de tus sesiones de desarrollo.

🤖 /model (Selector Interactivo de Modelos)

Permite alternar en caliente el modelo de Inteligencia Artificial que atiende la conversación.

  • Sintaxis:
    text
    /model [nombre_modelo]
  • Selector Dinámico: Si ejecutas /model sin parámetros, cargará una interfaz interactiva tipo lista para seleccionar con las flechas del teclado.
  • Modelos soportados nativamente:
    • claude-3-5-sonnet (Recomendado para codificación pesada).
    • gpt-4o (Altamente veloz y preciso).
    • deepseek-coder (Excelente rendimiento técnico).
    • gemini-1.5-pro (Ventana de contexto ultra masiva).

🔌 /provider (Selector de Proveedor de Inferencia)

Cambia en caliente el proveedor de inferencia activo (alias: /proveedor, /proveedores). El cambio persiste en ~/.context/provider-state.sqlite3 y se aplica sin reiniciar la sesión ni cerrar tu cuenta.

  • Sintaxis:
    text
    /provider                                   # abre selector interactivo
    /provider list                              # lista proveedores y estado
    /provider current                           # muestra el proveedor activo
    /provider <nombre> [perfil]                 # cambia a <nombre> con perfil opcional
    /provider <nombre> baseURL <url>            # fija un endpoint personalizado
    /provider <nombre> clear                    # elimina el endpoint personalizado
  • Proveedores soportados: claude, openai, openrouter, ollama, ollama-cloud, gemini-api, gemini-google, zai, minimax, nvidia, deepseek.
  • Detalle técnico:
    • Cada proveedor usa el cliente correcto: Anthropic SDK para claude/minimax (endpoint Anthropic-compatible), flujo OpenAI HTTP responses para los demás OpenAI-compatibles, OAuth Codex para openai.
    • Los backends corporativos AWS Bedrock, Google Vertex y Microsoft Foundry no se eligen con /provider: se activan con las variables CONTEXT_CODE_USE_BEDROCK, CONTEXT_CODE_USE_VERTEX o CONTEXT_CODE_USE_FOUNDRY y se enrutan automáticamente por encima del proveedor.

TIP

Si recibes errores token_invalidated al cambiar de proveedor, revisa que el perfil activo del proveedor (/profile current) tenga la baseURL correcta. Por ejemplo, MiniMax requiere https://api.minimax.io/anthropic.


📂 /profile (Perfiles por Proveedor)

Gestiona perfiles aislados de configuración por cada proveedor (alias: /profiles, /perfil, /perfiles). Cada perfil guarda su propia baseURL, último modelo y nombre de agente, persistidos en SQLite (~/.context/provider-state.sqlite3). No se generan archivos .profile.json en el repositorio.

  • Sintaxis:
    text
    /profile                                              # abre el panel interactivo
    /profile list                                         # lista todos los perfiles
    /profile current                                      # muestra el perfil activo
    /profile migrate                                      # migra datos legacy al esquema nuevo
    /profile create <proveedor> <nombre>                  # crea un perfil nuevo
    /profile use <proveedor> <nombre>                     # activa un perfil existente
    /profile rename <proveedor> <actual> <nuevo>          # renombra un perfil
    /profile remove <proveedor> <nombre>                  # elimina un perfil
    /profile remove all                                   # elimina todos los perfiles
    /profile model <proveedor> <perfil> <modelo|clear>    # fija/limpia el modelo del perfil
  • Caso de uso: mantener dos perfiles en MiniMax (main con MiniMax-M2.7 para producción y demo con MiniMax-M2-Lite para pruebas), o tener varias API keys de OpenRouter — cambias con /profile use openrouter trabajo y /profile use openrouter personal sin tocar variables de entorno.
  • Detalle técnico: cuando creas el primer perfil para un proveedor con baseURL por defecto conocida (ej. openrouter, ollama, zai, minimax, deepseek), Context Code la rellena automáticamente desde DEFAULT_PROFILE_BASE_URLS. Puedes sobrescribirla luego con /provider <prov> baseURL <url>.

📊 /limites (Auditoría Financiera y Cuotas)

Muestra estadísticas minuciosas sobre el consumo monetario y volumen de tokens consumidos en la sesión activa.

  • Sintaxis:
    text
    /limites
  • Métricas mostradas:
    • Coste acumulado en USD en la terminal.
    • Tokens de entrada (Input), tokens de salida (Output) y tokens recuperados de la caché de contexto (Caché Hits).
  • /reset-limits: Comando hermano que permite reiniciar el contador financiero local para auditorías semanales.

⏱️ /rate-limit-options (Gestión de Cuellos de Botella)

Configura y modula el comportamiento del agente cuando se enfrenta a avisos de "Rate Limit exceeded" (HTTP 429) por parte de los proveedores de IA.

  • Sintaxis:
    text
    /rate-limit-options
  • Opciones disponibles: Configurar el máximo de reintentos exponenciales automáticos y tiempos de espera pasivos de CPU antes de reanudar una tarea de /objetivo.

🔒 /env y /remote-env (Variables de Entorno)

Permite gestionar, editar y encriptar en memoria variables de entorno locales del proyecto y de la nube.

  • Sintaxis:
    text
    /env [clave] [valor]
    /remote-env [clave] [valor]
  • Caso de uso: Pasar API keys o tokens de bases de datos al agente de forma segura sin exponerlas en tu archivo .bashrc o en los repositorios de Git.

🛡️ /sandbox-toggle (Aislamiento Seguro)

Activa o desactiva la ejecución aislada en sandbox seguro para la ejecución de comandos y scripts de terminal recomendados por el agente.

  • Sintaxis:
    text
    /sandbox-toggle
  • Garantía de Seguridad: Al estar activado, evita que scripts externos ejecuten llamadas destructivas fuera de las carpetas de tu proyecto.

/fast (Modo Rápido)

Activa o desactiva el modo rápido (alias: /rapido), que fuerza el uso de Claude Opus 4.6 con salida acelerada — mismo modelo Opus, sin downgrade a un modelo menor.

  • Sintaxis:
    text
    /fast            # alterna on/off
    /fast on
    /fast off
  • Disponibilidad: solo en cuentas Claude.ai (suscriptores Consumer) y Console. El comando queda oculto si el modo no está disponible para tu cuenta.
  • Caso de uso: sesiones largas donde priorizas latencia sobre razonamiento extendido (refactors mecánicos, generación de tests repetitivos). Para problemas de concurrencia o diseño complejo, desactívalo para recuperar la cadena de pensamiento normal.

🔐 /login-openai (Sesión OpenAI / Codex)

Inicia sesión con OpenAI (Codex OAuth) sin cerrar tu sesión activa de Context (alias: /iniciar-sesion-openai). Útil cuando ya estás autenticado con Claude o MiniMax y solo necesitas habilitar /provider openai adicionalmente.

  • Sintaxis:
    text
    /login-openai
  • Detalle técnico: abre el flujo OAuth en navegador, captura el JWT de Codex y lo guarda en secure-storage.key bajo providerProfileOauth. A diferencia de /login (que cambia la cuenta activa de Context), este comando sólo añade credenciales OpenAI al almacén — la sesión Claude/MiniMax actual sigue intacta.
  • Nota: si tu JWT de Codex caduca verás errores token_invalidated al usar /provider openai. Vuelve a ejecutar /login-openai para refrescarlo.

Desarrollado con pasión e Inteligencia Artificial.