OpenAI no soporta oficialmente decenas de países, incluyendo Rusia, Bielorrusia, Irán y varias otras regiones.
Al intentar ejecutar codex
desde tales ubicaciones, recibirás ya sea un bloqueo directo por geolocalización, una negativa a emitir una clave API,
o una conexión inestable con cortes constantes al realizar tareas en la nube. Esto se soluciona
con un proxy correctamente seleccionado y configurado — pero aquí los matices son importantes: no todos los tipos de proxy
son adecuados para herramientas CLI y procesos de fondo prolongados.
Por qué Codex está bloqueado en tu país
OpenAI aplica geobloqueo en varios niveles simultáneamente. Primero, se verifica la dirección IP
en cada solicitud a la API — si pertenece a un país de la lista no soportada, el servidor devolverá
el error 403 Country, region, or territory not supported.
En segundo lugar, al registrarse en una cuenta y vincular una tarjeta de crédito, el sistema verifica la geolocalización de la IP,
la dirección de facturación de la tarjeta y la zona horaria del dispositivo — las discrepancias aumentan el riesgo de bloqueo de la cuenta.
En tercer lugar, incluso después de un registro exitoso, las sesiones CLI pueden cortarse si la IP cambia repentinamente
de geolocalización en medio de una tarea — esto es típico para IP dinámicas de operadores móviles o
al usar VPN gratuitas con un pool de direcciones inestable.
Para los desarrolladores que utilizan Codex CLI en conjunto con la automatización — escritura de código, revisión de pull requests, generación de pruebas en un pipeline CI — cualquier corte de conexión significa una tarea caída en medio de la ejecución. Por lo tanto, es importante no solo "eludir el bloqueo", sino asegurar una IP estable con la geolocalización correcta durante todo el periodo de trabajo.
Qué tipo de proxy necesitas para Codex CLI
Para trabajar con la API de OpenAI y herramientas CLI basadas en ella, tres parámetros son críticos: estabilidad de la sesión (la IP no debe cambiar en medio de la solicitud), velocidad de respuesta y limpieza de la reputación de la dirección (si no está en listas negras de servicios de abuso). Analicemos las opciones:
| Tipo de proxy | Para Codex CLI | Estabilidad de la sesión | Velocidad |
|---|---|---|---|
| Proxies residenciales | Sí, opción principal | Alta (sesiones sticky) | Media-alta |
| Proxies de centros de datos | Adecuado para CI/CD y scraping | Muy alta (IP fija) | Máxima |
| Proxies móviles | Excesivo para tareas API | Media (rotación de operador) | Media |
Para la mayoría de los escenarios — desarrollo local, CLI personal, solicitudes API irregulares — los proxies residenciales con vinculación a una sola IP por sesión (sticky session) son los más adecuados. Proporcionan IP reales de proveedores locales en el país elegido, lo que reduce el riesgo de ser filtrados por la detección de abuso de OpenAI. Sin embargo, si Codex se ejecuta en un pipeline en la nube con un gran número de tareas paralelas — por ejemplo, revisión automática de decenas de repositorios — es más rentable usar proxies de centros de datos: son más rápidos y estables para mantener conexiones largas sin saltos en la latencia.
Configuración de proxy en Codex CLI a través de variables de entorno
Codex CLI, al igual que la mayoría de las herramientas modernas de Node.js y Python, respeta las variables de entorno estándar
HTTP_PROXY
y HTTPS_PROXY.
Esta es la forma más sencilla de dirigir todo el tráfico CLI a través de un proxy sin modificar las configuraciones de la aplicación.
# Linux / macOS (bash, zsh)
export HTTP_PROXY="http://login:password@proxy_host:port"
export HTTPS_PROXY="http://login:password@proxy_host:port"
export NO_PROXY="localhost,127.0.0.1"
# Verificación antes de ejecutar Codex
curl -x $HTTPS_PROXY https://api.openai.com/v1/models
# Ejecutar CLI
codex "escribe una prueba unitaria para la función validateEmail"
# Windows PowerShell
$env:HTTP_PROXY = "http://login:password@proxy_host:port"
$env:HTTPS_PROXY = "http://login:password@proxy_host:port"
# Verificación de conexión
Invoke-WebRequest -Uri "https://api.openai.com/v1/models" -Proxy $env:HTTPS_PROXY
codex "refactoriza este módulo"
Si el proxy requiere autenticación mediante nombre de usuario y contraseña (la mayoría de los proveedores funcionan así),
indícalos directamente en la URL del proxy en el formato
http://user:pass@host:port.
Para proxies SOCKS5, utiliza el protocolo socks5://
en lugar de http:// —
esto es importante, ya que algunas herramientas CLI diferencian los protocolos y pueden ignorar un esquema incorrectamente
especificado.
Proxy a través de archivo de configuración y envolturas de Python
Si estás escribiendo tus propios scripts alrededor de la API de OpenAI (por ejemplo, procesamiento por lotes de tareas a través de
openai-python
SDK), las variables de entorno pueden no ser suficientes — a veces es más conveniente pasar el proxy explícitamente al cliente.
import httpx
from openai import OpenAI
proxy_url = "http://login:password@proxy_host:port"
client = OpenAI(
api_key="sk-...",
http_client=httpx.Client(proxies=proxy_url, timeout=60.0)
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "Genera una migración de base de datos"}]
)
print(response.choices[0].message.content)
Para envolturas de Node.js (si tu pipeline de Codex está construido en JS) la lógica es similar a través de
https-proxy-agent:
const { HttpsProxyAgent } = require('https-proxy-agent');
const OpenAI = require('openai');
const agent = new HttpsProxyAgent('http://login:password@proxy_host:port');
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
httpAgent: agent,
});
const run = async () => {
const res = await client.chat.completions.create({
model: 'gpt-4o',
messages: [{ role: 'user', content: 'Revisa el código en busca de vulnerabilidades' }],
});
console.log(res.choices[0].message.content);
};
run();
Pasar el proxy explícitamente en el código es útil cuando parte de las solicitudes en tu aplicación deben ir directamente (servicios internos), y parte — a través del proxy (solicitudes a OpenAI). Así no rompes la lógica de red del resto de la aplicación con variables de entorno globales.
Proxy para tareas en la nube: Docker, CI/CD, GitHub Actions
Si Codex se utiliza no localmente, sino en un pipeline automatizado — revisión de código en cada pull request, generación nocturna de documentación, refactorización automática — el proxy debe estar configurado a nivel del entorno de ejecución de la tarea, y no solo en la terminal del desarrollador.
# Dockerfile
FROM node:20-slim
ENV HTTP_PROXY="http://login:password@proxy_host:port"
ENV HTTPS_PROXY="http://login:password@proxy_host:port"
ENV NO_PROXY="localhost,127.0.0.1"
RUN npm install -g @openai/codex
WORKDIR /app
COPY . .
CMD ["codex", "run", "review"]
# .github/workflows/codex-review.yml
name: Revisión de Codex
on: [pull_request]
jobs:
review:
runs-on: ubuntu-latest
env:
HTTPS_PROXY: ${{ secrets.PROXY_URL }}
OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
steps:
- uses: actions/checkout@v4
- name: Instalar Codex
run: npm install -g @openai/codex
- name: Ejecutar revisión de Codex
run: codex review --diff origin/main
Para CI/CD es preferible una IP estática fija — este es precisamente el escenario donde los proxies de centros de datos se desempeñan mejor que los residenciales: la latencia es más baja, la conexión no se corta en trabajos largos, y el costo del tráfico en grandes volúmenes de solicitudes es significativamente menor. Asegúrate de almacenar las credenciales del proxy (nombre de usuario, contraseña, host) en los Secrets del repositorio, y no en el propio archivo de workflow.
Rotación de IP y estabilidad de largas sesiones
El principal error al trabajar con Codex a través de un proxy es usar IP con rotación automática en cada solicitud dentro de una tarea de múltiples pasos. La API de OpenAI soporta respuestas de streaming prolongadas y llamadas secuenciales dentro de un mismo contexto — si entre estas llamadas cambia la IP saliente, el servicio puede considerar esto como actividad sospechosa o simplemente romper la conexión de streaming.
La solución son las sesiones sticky: el proxy mantiene la misma IP fijada a tu conexión durante un periodo determinado (generalmente de 1 a 30 minutos, dependiendo de la configuración del proveedor), tras lo cual la cambia por una nueva. Para Codex CLI, es óptimo establecer el tiempo de sesión no menor que la duración de tu tarea más larga — si la generación de un gran PR toma 5 minutos, la sesión debe durar al menos 10-15 minutos como margen.
# Ejemplo de formación de sesión sticky a través de un parámetro en el login del proxy
# (la sintaxis depende del proveedor, el formato típico es el siguiente)
export HTTPS_PROXY="http://user-session-abc123:password@proxy_host:port"
Si las tareas se ejecutan en paralelo en CI (por ejemplo, revisando 10 pull requests a la vez), a cada trabajo paralelo se le debe asignar un ID de sesión separado — así evitarás la situación en la que varios procesos "tiran" de la misma IP al mismo tiempo y se encuentran con el límite de tasa de la API antes de tiempo.
Errores comunes y cómo solucionarlos
Analicemos los problemas típicos que enfrentan los desarrolladores al configurar proxies para Codex CLI y la API de OpenAI.
| Error | Causa | Solución |
|---|---|---|
403 unsupported_country_region_territory |
El proxy no se activó, la solicitud se envió con la IP real | Verificar las variables de entorno a través de curl -x |
| El stream se corta a mitad de respuesta | La IP cambió en medio de la sesión (no hay modo sticky) | Activar sesión sticky, aumentar el tiempo de vida de la IP |
| Timeout / conexión rechazada | Puerto o protocolo incorrecto (http en lugar de socks5) | Verificar el protocolo y el puerto en la documentación del proveedor de proxy |
| El límite de tasa se alcanza demasiado rápido | Varios procesos utilizan la misma IP al mismo tiempo | Asignar IDs de sesión separados a cada proceso paralelo |
| La cuenta recibió una advertencia sobre actividad sospechosa | La IP del centro de datos fue incluida en una base de abuso | Cambiar a una IP residencial con buena reputación |
Lista de verificación antes de iniciar
Antes de confiar a Codex CLI una tarea en producción a través de un proxy, revisa esta breve lista:
- Verificaste la disponibilidad de
api.openai.coma través decurl -xcon tu proxy - La geolocalización del proxy coincide con el país indicado en la facturación de la cuenta de OpenAI
- Se activó la sesión sticky con un tiempo de vida mayor que la duración de la tarea más larga
- Para CI/CD, las credenciales del proxy se almacenan en Secrets, y no en el código del workflow
- Para tareas paralelas se utilizan diferentes IDs de sesión, y no una IP común
- Los logs de CLI se revisaron en busca de solicitudes directas ocultas que eludan el proxy (por ejemplo, de dependencias externas)
Conclusión
Trabajar con OpenAI Codex CLI desde un país sin soporte oficial requiere no solo eludir el bloqueo de forma puntual, sino una configuración sistemática de la red: el tipo correcto de proxy, sesiones sticky para solicitudes largas y una integración cuidadosa en las variables de entorno o en el código del cliente. Para el desarrollo local y tareas irregulares, los IP residenciales con buena reputación son más adecuados, mientras que para pipelines de CI/CD cargados, los proxies de centros de datos son rápidos y estables.
Si planeas ejecutar Codex y otras herramientas basadas en la API de OpenAI desde una región sin soporte oficial, te recomendamos comenzar con proxies residenciales para un funcionamiento estable de CLI, y para tareas automatizadas a gran escala en la nube — con proxies de centros de datos, que asegurarán baja latencia y costos predecibles en grandes volúmenes de solicitudes a la API.