Skip to main content
Codex es el agente de programación de OpenAI y viene en tres formas: Codex CLI en el terminal, la extensión de Codex en VS Code y la app de Codex. Los tres leen la misma carpeta ~/.codex, por lo que una sola configuración cubre los tres.

​
Instalación con un solo comando

Reemplaza sk-xxx con tu clave, abre una terminal, pega y presiona Enter. El script verifica la clave, lista todos los modelos que la clave puede llamar y te permite elegir (Enter = recomendado: gpt-astra para Astra, gpt-5.6-sol para GPT, claude-opus-5 para Claude), instala Codex CLI y escribe la configuración.
El script primero pregunta por un idioma (1 = vietnamita, 2 = inglés; omite con --lang en o --lang vi). Sin --key solicita la clave. Para forzar un modelo añade --model gpt-astra o --model gpt-5.6-sol.
Lee el código fuente antes de ejecutar si lo deseas: codex.sh, codex.ps1. El script solo se ejecuta en tu máquina y envía la clave únicamente a gpt.teamsoclo.site para verificación.

​
Qué hace el script

  1. Verifica la clave con el gateway y elige el modelo para tu paquete; una clave incorrecta se detiene aquí sin tocar tu máquina.
  2. Respalda tu config.toml existente, si lo hay, como config.toml.bak.<timestamp>.
  3. Escribe ~/.codex/config.toml: modelo gpt-5.6-sol, el gateway de TeamSocLo, Responses API.
  4. Almacena la clave en la variable de entorno TEAMSOCLO_API_KEY (en ~/.zshrc / ~/.bashrc, o como variable de usuario en Windows). La clave no está en el archivo de configuración, por lo que puedes compartir config.toml sin filtrarla.
  5. Instala o actualiza Codex CLI con npm install -g @openai/codex.
Ejecútalo de nuevo en cualquier momento para cambiar claves o paquetes; la configuración anterior siempre se respalda primero.
¿Prefieres no usar el terminal? TeamSocLo Key Tool es una app para Windows y macOS: pega tu clave una vez para configurar Codex, Claude Code y más de 20 herramientas.

​
Después de instalar

1

Abre una nueva terminal, ejecuta codex

La terminal antigua no ha cargado la nueva variable; abre una nueva pestaña. Pregunta cualquier cosa a Codex para verificar.
2

VS Code: instala la extensión, cierra completamente, vuelve a abrir

VS Code → Extensiones → busca Codex (el agente de programación de OpenAI) → Instalar. Luego cierra VS Code completamente: macOS Cmd + Q, Windows cierra todas las ventanas. Reload Window no es suficiente; la extensión lee la configuración solo al inicio del proceso.
3

App de Codex

Vuelve a abrir la app después de ejecutar el comando. En macOS el comando configuró la variable para apps GUI mediante launchctl; en Windows setx aplica a las apps que se inicien después.
No se necesita inicio de sesión en OpenAI. requires_openai_auth = false le dice a Codex que use la clave del gateway desde la variable de entorno.

​
Configuración manual

Si prefieres editarlo tú mismo, ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml) debe contener exactamente:
y la variable de entorno TEAMSOCLO_API_KEY debe contener tu clave.
Mantén wire_api = "responses". Codex usa la Responses API; cambiar a chat lo rompe.
Abre la carpeta de configuración rápidamente:

​
Cambiar el modelo

El paquete GPT Astra usa gpt-astra. Edita la primera línea de config.toml y reinicia Codex:
Una clave GPT que llama a gpt-astra obtiene “no available channel”, y viceversa. El modelo sigue el paquete que compraste, ver Modelos y paquetes.

​
Desinstalar

Para mantener Codex pero volver a tu configuración anterior, copia config.toml.bak.<timestamp> sobre config.toml.

​
Si no funciona

  • Abriste una nueva terminal o cerraste VS Code completamente después de instalar.
  • echo $TEAMSOCLO_API_KEY (Windows: echo %TEAMSOCLO_API_KEY% en cmd) muestra la clave completa.
  • base_url termina con /v1, wire_api es responses.
  • La clave sigue siendo válida y tiene cupo: verificar aquí.
  • De lo contrario, ver Solución de problemas, que tiene una sección de Codex.