
Codex CLI
El agente de codificación open-source de OpenAI para tu terminal
Conectar con TokenMix CLI
El TokenMix CLI oficial lo configura todo con un solo comando — sin variables de entorno manuales:
npx tokenmix codex
Gestiona el inicio de sesión y apunta Codex a TokenMix por ti. ¿Prefieres configurarlo a mano? Los pasos completos están a continuación.
Introducción
Codex CLI es el agente de codificación open-source de OpenAI para la terminal. Lee tus archivos, escribe código, ejecuta comandos shell en un sandbox e itera hasta completar la tarea. A diferencia de las herramientas basadas en navegador, Codex se ejecuta completamente en tu máquina. Al configurarlo con TokenMix, puedes usar modelos potentes como gpt-5.5 y gpt-5.4 a los precios de TokenMix.
Requisitos previos
- macOS, Linux o Windows (se recomienda WSL)
- Node.js 22 o posterior — ejecuta
node -vpara confirmar - Una cuenta TokenMix con una clave API que comience con
sk-tm-→ Regístrate en tokenmix.ai → Panel de control → API Keys
Pasos de configuración
1. Instalar Codex CLI
npm install -g @openai/codex
Verificación:
codex --version
2. Crear el archivo de configuración
Codex lee su configuración de proveedor desde ~/.codex/config.toml. Crea el directorio y el archivo:
mkdir -p ~/.codex
Abre ~/.codex/config.toml en tu editor y agrega:
model = "gpt-5.5"
model_provider = "tokenmix"
[model_providers.tokenmix]
name = "TokenMix"
base_url = "https://api.tokenmix.ai/v1"
env_key = "TOKENMIX_API_KEY"
wire_api = "responses"
3. Establecer tu clave API
Agrega la variable de entorno a tu perfil de shell (~/.zshrc o ~/.bashrc):
export TOKENMIX_API_KEY="sk-tm-tu-clave-aquí"
Recarga:
source ~/.zshrc
4. Iniciar Codex
cd ~/tu-proyecto
codex
Para usar un modelo diferente:
codex --model gpt-5.4
Modelos TokenMix disponibles: gpt-5.5, gpt-5.4
Verificación
codex -q "¿Qué archivos hay en el directorio actual?"
Codex debería listar el contenido del directorio. Si ves un error de autenticación, verifica que TOKENMIX_API_KEY esté exportado en tu shell actual.
Preguntas frecuentes
P: ¿Qué significa wire_api = "responses"?
Le dice a Codex que use el formato Responses API de OpenAI, que es el único formato compatible con Codex. TokenMix es totalmente compatible con este formato.
P: ¿Puedo usar modelos Claude con Codex? Codex está diseñado alrededor de la Responses API, optimizada para modelos GPT. Para modelos Claude, usa Claude Code o Cline.
P: El nombre del modelo no se reconoce — ¿qué hago?
Asegúrate de que el campo model en config.toml coincida con un short_id disponible en tu cuenta TokenMix. Puedes listar los modelos disponibles en tokenmix.ai/models.