Búsqueda rápida
Claves y cupo
Clave incorrecta o truncada
El problema más común no es una clave rota sino unos pocos caracteres perdidos al seleccionar texto con el ratón. Usa siempre el botón Copy en la página de canje. Pega la clave en la página de verificación: si dice válida, la clave está bien y el problema está en la configuración de la app.Clave expirada
Cada paquete tiene un período de validez contado desde el canje (impreso en el producto). Después de la expiración, cada solicitud devuelve 401 incluso si queda cupo. La página de verificación muestra la fecha de expiración. Los tokens no utilizados no se transfieren a un nuevo código.Cupo agotado
Todo funcionaba, y de repente todas las solicitudes fallan con insufficient quota. Comprueba lo que queda en la página de verificación. Un cupo que cae inusualmente rápido suele deberse a un agente que lee todo el repositorio o a una conversación muy larga que se reenvía en cada turno.Clave perdida
Canjea el mismo código CDK de nuevo en redeem.teamsoclo.site; la página mostrará la clave original. Los códigos no se vuelven a emitir con una clave nueva.Cuántas máquinas por clave
No hay límite de dispositivos, pero el límite de solicitudes por minuto es compartido por todas las máquinas que usan la clave. Compartir una clave significa que los usuarios compiten por el mismo límite y llegan al 429 antes.Conexión
Falta /v1
La Base URL correcta eshttps://gpt.teamsoclo.site/v1. Sin /v1 las solicitudes llegan al sitio web en lugar de a la API y la app reporta 404 o “no se pudo conectar”.
Llamar al modelo del otro paquete
No available channel for model gpt-astra under group default significa que una clave GPT está llamando al modelo Astra (o al revés). Cada clave solo puede llamar al modelo de su propio paquete. Verifica con:
429 Too Many Requests
Cada clave tiene un número máximo de solicitudes exitosas por minuto fijado por su paquete. Por encima de ese límite recibes 429 con un mensaje de “límite de solicitudes alcanzado”. Espera al siguiente minuto. Para scripts por lotes añade un retraso entre llamadas, o compra otro código para distribuir la carga.Respuestá cortada a mitad
Para preguntas que requieren mucho razonamiento, una solicitud sin streaming puede descartarse antes del primer token. Activastream: true. La mayoría de las apps de chat ya lo hacen; añádelo cuando llames desde código.
Unsupported parameter: reasoning_effort
Solo Chat Completions acepta reasoning_effort en el nivel superior. Con la Responses API usa "reasoning": {"effort": "high"}. Codex lo maneja por sí solo.
Codex
codex: command not found después de instalar
npm terminó pero la terminal actual no ha recargado PATH. Abre una nueva terminal. Si sigue fallando, comprueba que la carpeta bin de npm esté en PATH:
/bin debe estar en $PATH.
Codex sigue pidiendo inicio de sesión en OpenAI
La variableTEAMSOCLO_API_KEY no ha llegado al proceso de Codex:
- Terminal: abre una nueva pestaña, comprueba
echo $TEAMSOCLO_API_KEY. - VS Code en macOS: cierra con
Cmd + Qy vuelve a abrir. El comando de instalación configuró la variable para apps GUI mediantelaunchctl. - VS Code en Linux: inicia VS Code desde una terminal (
code .), o cierra sesión y vuelve a iniciarla. - Windows: abre una nueva PowerShell o VS Code después de
setx.
config.toml tenga requires_openai_auth = false y env_key = "TEAMSOCLO_API_KEY".
Edité config.toml pero Codex no cambia
La configuración se lee solo al inicio del proceso. Reload Window no es suficiente; cierra VS Code completamente (macOSCmd + Q, Windows cierra todas las ventanas y procesos en segúndo plano). Está es la pregunta más frecuente sobre Codex.
EACCES: permission denied al instalar con npm
Node se instaló con privilegios del sistema, común en Linux. Cambia el prefijo de npm:
export a ~/.bashrc o ~/.zshrc. A largo plazo, instala Node mediante nvm, ver Primeros pasos.
Windows: running scripts is disabled on this system
PowerShell bloquea los archivos .ps1, y codex / npm escritos en PowerShell pasan por los shims .ps1 de npm. Ejecuta una vez:
codex.cmd, npm.cmd en su lugar.
Windows: EBUSY: resource busy or locked
Codex está ejecutándose (CLI, extensión o app) por lo que npm no puede sobreescribir codex.exe. Cierra todo lo que esté ejecutando Codex y vuelve a ejecutar el comando de instalación. La configuración ya se escribió antes de este paso; solo se omitió la actualización de la CLI.
Windows: error de codificación del archivo de configuración
Editar con PowerShell 5.1 ySet-Content -Encoding UTF8 añade un BOM que Codex no puede leer. Usa el comando de instalación de nuevo (escribe UTF-8 sin BOM), o guarda el archivo en VS Code como UTF-8 (no UTF-8 con BOM).
Restaurar la configuración anterior
Cada ejecución del comando de instalación respalda la configuración antigua junto a la nueva:Preguntas frecuentes
Cómo cambio las claves
Vuelve a ejecutar el comando de instalación de Codex con la nueva clave, o vuelve a ejecutar la herramienta. Para Cursor, Cline y Chatbox, edita el campo API Key en Configuración.¿Es seguro ejecutar el comando de instalación varias veces?
Sí. Está diseñado para ejecutarse de nuevo: la configuración antigua se guarda como.bak.<timestamp>, se actualiza la CLI y la línea de clave antigua en tu rc de shell se reemplaza.
¿El comando envía mi clave a algún lugar?
No. Pegas la clave en el comando en tu propia máquina; solo escribe una variable de entorno y un archivo de configuración local. El comando completo se muestra en la página, lee cada línea antes de ejecutar.Eliminar todo
Ver Desinstalar en la página de Codex. Para otras apps, simplemente elimina la clave en la Configuración de la app.Sigue sin funcionar
1
¿La clave está activa?
Pégala en la página de verificación. Un error aquí significa que el problema es la clave (incorrecta, expirada, sin cupo), no la app.
2
Llama a la API directamente con cURL
3
Revisa tres cosas en la app
La Base URL termina con
/v1, la clave está completa, el modelo coincide con tu paquete. Estos causan casi todos los problemas.4
Contactar soporte
Envía una captura de pantalla del error y los últimos 4 caracteres de tu clave a t.me/teamsoclo. Nunca envíes la clave completa.