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

Hola a todos, soy Cang He.

Desde que CodexGuide se publicó anteayer, el backend explotó.

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

Para ser sincero, entiendo este dolor.

Suscribirse a Plus tiene sus propias barreras y tienes que ingeniártelas con los 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 fiables.

Los comparto todos hoy con vosotros, solo seguid los pasos.

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

Teniendo en cuenta lo mucho que trabajé en esto, dadle 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 pasa nada, solo sigue los pasos a continuación.

Cómo Elegir entre los Tres Esquemas

Aquí tienes una tabla para que encuentres el que más te convenga:

Sinceramente, si eres principiante, mira el Esquema 2; es el que menos problemas da.

Si 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 aplicación Codex.

Si quieres usar plugins, salta directamente al Esquema 2.

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

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

Dos Enfoques de Inicio de Sesión

Un consejo: no cambies demasiadas cosas a la vez. Añade solo un proveedor primero, y una vez que funcione, entonces líate con múltiples configuraciones.

Ejemplo de Estado de Inicio de Sesión GPT

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

Paso 1: Modificar el archivo de configuración:

Abre ~/.codex/config.toml y añade la siguiente configuración.

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

Algunos errores comunes:

• model_provider debe ser exactamente igual que 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 solicitar en el formato de Responses API; no lo cambies.
• requires_openai_auth = false significa no usar el estado de inicio de sesión oficial.

Paso 2: Configurar variables de entorno

Abre la terminal e introduce:

Paso 3: Iniciar la aplicación Codex desde la terminal

Aquí hay un detalle: los usuarios de Mac deben iniciar desde la terminal; al hacer clic en el icono directamente, puede que no lea el modelo.

Cierra completamente la aplicación Codex antes de iniciar, luego introduce en la terminal:

Paso 4: Verificar el efecto

Abre la aplicación Codex y verás que el modelo se ha cambiado correctamente:

Buenos cielos, está despegando.

Ejemplo de Inicio de Sesión con API Key

Si estás usando 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 proveedor 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, que 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 modelo:

Cómo Verificar el Éxito de la Configuración

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

1. Sal completamente de Codex y vuelve a abrirlo.
2. Pídele que realice una tarea de solo lectura, como resumir la estructura del directorio actual.
3. Si da error, primero verifica el nombre de model_provider, base_url y las variables de entorno.
4. Si ocurre un error de autenticación, vuelve primero a la configuración de respaldo; no entres en pánico.

Esquema 2: Codex++

Si la configuración manual te parece demasiado complicada, echa un vistazo a Codex++.

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

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

Adecuado para estas personas:

• Aquellos que usan principalmente la aplicación de escritorio Codex.
• Aquellos que no quieren escribir archivos de configuración manualmente.
• Aquellos que quieren volver al modo oficial en cualquier momento.

Pasos de Instalación

1. 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.

1. Abre "Codex++ Management Tool" después de la instalación.

Si aparece este error la primera vez que lo abres, 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, accede a la interfaz de gestión:

Instala la aplicación 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.

1. Añadir configuración de relé.

Selecciona "Provider Configuration" - Add Provider, y rellena 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 relé, habrá muchos modelos para elegir aquí:

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

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

1. 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 modelo personalizado, y el número de modelos disponibles ha aumentado de repente:

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

Tienes que admitirlo, este esquema es el más fluido que he usado hasta ahora; muy recomendado.

¿Y si quiero revertir los cambios?

• Limpia el modo 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á al 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, responsable de la conversión de protocolo y el enrutamiento. Admite varios puntos de entrada como Claude, OpenAI, Codex, Gemini, etc.
• CC Switch: Herramienta de gestión de escritorio, cambio con un clic de diferentes configuraciones de proveedor.

¿Cuándo usar este esquema? Cuando tienes múltiples APIs de modelos nacionales, múltiples servicios de relé, 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: Añadir Canales Upstream

Añade tus canales en la interfaz de gestión de CCX:

1. Selecciona el tipo de servicio upstream.
2. Rellena la API Key y la Base URL.
3. Configura el mapeo de modelos y las reglas de enrutamiento.
4. Usa la función de prueba integrada para confirmar la conectividad.

Aquí hay un punto clave: Codex necesita un punto de entrada de Responses API. Si el upstream solo tiene Chat Completions, CCX te ayudará a realizar la conversión de protocolo, que es la razón principal para usarlo.

Paso 3: Instalar CC Switch

Instalación desde la línea de comandos:

Inicialización:

Durante la inicialización, rellena la dirección de CCX como punto de entrada del relé.

Paso 4: Cambiar la Configuración e Iniciar

Comando de una línea para cambiar de proveedor:

Luego reinicia Codex para que surta efecto.

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

• ¿Es model_provider el que acabas de seleccionar?
• ¿Apunta base_url a CCX?
• ¿Has escrito accidentalmente la Key en un repositorio público (esto es muy importante)?

Resumen de Problemas Comunes

Por último, aquí tienes una tabla de solución de problemas; revísala primero si encuentras problemas:

Para ser sincero, he ejecutado con éxito los tres esquemas, pero en el día a día uso más el Esquema 2, Codex++, es el que menos problemas da.

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

Bueno, eso es todo por hoy.

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

Si tienes preguntas, pregunta directamente en la sección de comentarios; responderé a todas las que vea.