Tutorial nivel niñera: Cómo usar Codex sin problemas en China, probado y efectivo

¡Hola a todos, soy Cang He!

Justo anteayer, cuando CodexGuide se puso en línea, explotó el backend.

La pregunta más frecuente es: ¿cómo usar Codex en China? ¿Puedo usarlo sin una suscripción a Plus?

Para ser honesto, entiendo ese dolor.

Suscribirse a Plus tiene sus propias barreras, y además tienes que averiguar métodos de pago; es agotador.

Así que pasé dos días probando todas las soluciones que encontré en línea, me topé con muchos problemas y finalmente resumí los tres métodos de acceso más confiables.

Hoy los comparto todos con ustedes — solo sigan los pasos.

El tutorial también está disponible en CodexGuide para consultarlo en cualquier momento.

Considerando lo mucho que trabajé en esto, denle una estrella, jajaja.

Primero, un requisito previo: la forma más estable de usar Codex sigue siendo iniciar sesión con una cuenta oficial de GPT.

Conectarse a una API de terceros es una operación avanzada; necesitas saber qué son config.toml, API Key y Base URL.

Si no lo sabes, no importa — solo sigue los pasos a continuación.

Cómo elegir entre los tres esquemas

Aquí tienes una tabla para que encuentres el que mejor se adapte a ti:

Esquema	Adecuado para	Ventajas	Nota
Configuración manual	Quienes quieren entender los principios subyacentes	Transparente, controlable, fácil de solucionar problemas	Debes mantener `config.toml` tú mismo; si hay errores, no funciona
Codex++	Usuarios de app de escritorio que quieren gestión con GUI	Tiene interfaz de gestión, configuración con un clic	Herramienta de terceros, puede necesitar actualizaciones tras cambios en Codex
CCX + CC Switch	Quienes tienen múltiples proveedores y necesitan conversión de protocolo	Enrutamiento de puerta de enlace + cambio de proveedor con un clic	Muchos componentes, requiere entender puertos y cadenas de proxy

Honestamente, si eres principiante, solo mira el Esquema 2; es el más libre de preocupaciones.

Si recién estás empezando a aprender Codex, te sugiero que veas mi tutorial anterior para principiantes de Codex antes de meterte con APIs de terceros.

Esquema 1: Configuración manual

Este método tiene una desventaja: no puedes usar la función de plugins de la app de Codex.

Si quieres usar plugins, salta directamente al Esquema 2.

El núcleo de la configuración manual es modificar un archivo:

Antes de modificarlo, haz una copia de seguridad — adquiere buenos hábitos:

Dos enfoques de inicio de sesión

Enfoque	Cómo entenderlo	Escenario adecuado
Inicio de sesión con GPT	Mantener el estado de inicio de sesión oficial, solo cambiar la dirección de reenvío de solicitudes	Quieres conservar las capacidades de la cuenta oficial mientras usas un relay
Inicio de sesión con API Key	Usar la Key en variables de entorno, solicitar directamente a un tercero	Usar OpenAI API Key o un servicio compatible propio

Un consejo: no cambies demasiadas cosas a la vez. Agrega solo un proveedor primero, y cuando funcione, luego métete con configuraciones múltiples.

Ejemplo de inicio de sesión con estado GPT

Esto significa que tu Codex primero debe haber iniciado sesión en una cuenta de GPT.

Paso 1: Modificar el archivo de configuración:

Abre ~/.codex/config.toml y agrega la siguiente configuración.

Nota: completa los campos y valores según tu servicio real:

Algunos errores comunes:

model_provider debe ser exactamente igual a xxx en [model_providers.xxx]; ni una letra de diferencia.
base_url solo debe llegar hasta /v1; no incluyas todo el segmento /v1/responses.
wire_api = "responses" significa hacer solicitudes en formato Responses API; no lo cambies.
requires_openai_auth = false significa que no se usa el estado de inicio de sesión oficial.

Paso 2: Configurar variables de entorno

Abre la terminal e ingresa:

Paso 3: Iniciar la app de Codex desde la terminal

Aquí hay un detalle: los usuarios de Mac deben iniciar desde la terminal; hacer clic en el icono directamente podría no leer el modelo.

Cierra completamente la app de Codex antes de iniciar, luego ingresa en la terminal:

Paso 4: Verificar el efecto

Abre la app de Codex y verás que el modelo se ha cambiado con éxito:

Cielos, está despegando.

Ejemplo de inicio de sesión con API Key

Si usas el método de API Key, recuerda un principio: pon la clave secreta en variables de entorno, no la codifiques directamente en el archivo de configuración.

Configuración correspondiente de config.toml:

Una cosa a tener en cuenta: si tu upstream solo admite Chat Completions y no Responses API, solo cambiar la configuración no funcionará; necesitas usar una puerta de enlace como CCX para la conversión de protocolo, lo cual se tratará en el Esquema 3.

Modificar el archivo de autenticación

Abre ~/.codex/auth.json y cambia OPENAI_API_KEY por la Key de tu proveedor de modelos:

Cómo verificar que la configuración fue exitosa

No te apresures después de configurar; primero verifica:

Sal completamente de Codex y vuélvelo a abrir.
Haz que realice una tarea de solo lectura, por ejemplo, resumir la estructura actual del directorio.
Si da error, primero revisa el nombre de model_provider, base_url y las variables de entorno.
Si ocurre un error de autenticación, primero vuelve a la configuración de respaldo; no entres en pánico.

Esquema 2: Codex++

Si te parece que la configuración manual es demasiado complicada, échale un vistazo a Codex++.

Es una herramienta de gestión gráfica que te ayuda a manejar las configuraciones de relay con un solo clic, sin tener que escribir archivos toml manualmente.

Además, admite funciones de plugins, algo que el Esquema 1 no puede hacer.

Es adecuado para estas personas:

Quienes usan principalmente la app de escritorio de Codex.
Quienes no quieren escribir archivos de configuración manualmente.
Quienes quieren volver al modo oficial en cualquier momento.

Pasos de instalación

Abre Codex++ Releases y descarga el paquete de instalación.

Verás dos paquetes de instalación: "Codex++ Management Tool" y "Codex++ app"; instala ambos.

Abre "Codex++ Management Tool" después de instalarlo.

Si al abrirlo por primera vez aparece este error, no entres en pánico:

Ve a "Configuración del sistema" - "Privacidad y seguridad", y haz clic en "Abrir de todas formas":

Después de abrirlo, ingresa a la interfaz de gestión:

Instala la app de Codex++ de la misma manera; es correcto si la detección de la herramienta de gestión está toda en verde:

Confirma que se detecta el estado de inicio de sesión de GPT.

Agregar configuración de relay.

Selecciona "Provider Configuration" - Añadir Proveedor, y completa tu Base URL y Key.

Nota: selecciona "Pure API" para el método de acceso:

La lista de modelos se puede obtener automáticamente del upstream; si estás configurando una estación de relay, habrá muchos modelos para elegir aquí:

Básicamente, esta herramienta te ayuda a escribir configuraciones de manera más conveniente, ahorrándote la edición manual de archivos:

Prueba la conectividad después de guardar; si no hay problemas, úsalo directamente:

Iniciar Codex desde el punto de entrada de Codex++.

Nota: inicia desde Codex++, no desde el Codex original:

Después de reiniciar, verás que Codex ya está usando el proveedor de modelos personalizado, y la cantidad de modelos disponibles ha aumentado de repente:

Los plugins también se pueden usar directamente; esta es la experiencia completa:

Hay que admitir que este esquema es el más fluido que he usado hasta ahora; muy recomendado.

¿Qué pasa si quiero revertir?

Limpia el modo de API en la herramienta de gestión y vuelve a la configuración oficial.
Si Codex++ deja de funcionar después de una actualización de Codex, solo espera a que se adapte; no afectará el uso de la versión original.

Esquema 3: CCX + CC Switch

Este esquema es adecuado para usuarios avanzados, separando la "puerta de enlace" y la "herramienta de cambio":

CCX: Puerta de enlace proxy de API, encargada de la conversión de protocolo y enrutamiento. Admite varios puntos de entrada como Claude, OpenAI, Codex, Gemini, etc.
CC Switch: Herramienta de gestión de escritorio, cambio con un solo clic entre diferentes configuraciones de proveedor.

¿Cuándo usar este esquema? Cuando tienes múltiples APIs de modelos nacionales, múltiples servicios de relay, múltiples Keys, o cuando el upstream solo admite Chat Completions y necesita conversión a Responses API.

Paso 1: Desplegar CCX

Usa Docker con un solo comando:

Después de iniciarlo, puedes verlo abriendo el navegador.

Paso 2: Agregar canales upstream

Agrega tus canales en la interfaz de gestión de CCX:

Selecciona el tipo de servicio upstream.
Completa la API Key y Base URL.
Configura el mapeo de modelos y las reglas de enrutamiento.
Usa la función de prueba incorporada para confirmar la conectividad.

Hay un punto clave aquí: Codex necesita un punto de entrada de Responses API. Si el upstream solo tiene Chat Completions, CCX hará la conversión de protocolo por ti, que es la razón principal para usarlo.

Paso 3: Instalar CC Switch

Instalación por línea de comandos:

Inicialización:

Durante la inicialización, completa la dirección de CCX como punto de entrada del relay.

Paso 4: Cambiar configuración e iniciar

Comando de una línea para cambiar de proveedor:

Luego reinicia Codex para que surta efecto.

Después de cambiar, se recomienda abrir ~/.codex/config.toml para verificar:

¿model_provider es el que acabas de seleccionar?
¿base_url apunta a CCX?
¿Accidentalmente escribiste la Key en un repositorio público (esto es muy importante)?

Resumen de errores comunes

Finalmente, aquí tienes una tabla de solución de problemas; revísala primero si te encuentras con problemas:

Fenómeno	¿Qué revisar primero?
No hace efecto después del cambio	Si Codex se reinició completamente, si el nombre de `model_provider` es consistente
Error de autenticación	Si la API Key es válida, si las variables de entorno son heredadas por el shell actual
Error en la ruta de la interfaz	Si `base_url` solo está escrita hasta `/v1`, no repitas `/responses`
Modelo nacional sin respuesta	Si el upstream admite Responses API; si no, debes usar CCX para la conversión
Falta configuración de plugins	Si la herramienta de cambio sobrescribió la configuración; ¿hiciste una copia de seguridad con anticipación?

Para ser honesto, he ejecutado exitosamente los tres esquemas, pero el que más uso en el día a día es el Esquema 2, Codex++; es libre de preocupaciones.

Si eres el tipo de usuario avanzado con varias Keys y varios proveedores, el Esquema 3 es más adecuado para ti.

Bueno, eso es todo por la publicación de hoy.

Si este tutorial te ayudó, dale un like para hacérmelo saber, y seguiré actualizando más contenido práctico de Codex en el futuro.

Si tienes preguntas, pregunta directamente en los comentarios; responderé a todas las que vea.

Cómo elegir entre los tres esquemas