Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

Guía de despliegue de Codex

Explica la instalación de la herramienta CLI, la conexión con la API y la configuración del entorno de desarrollo.

📋 Requisitos previos (primer paso) Completa primero la instalación del entorno de Node.js y asegúrate de que Node.js 18+ esté instalado correctamente. Durante la configuración, recuerda abrir las opciones avanzadas de ccs; podrás chatear después de añadir el modelo.


🎯 Navegación rápida

Codex es un asistente de programación inteligente de nueva generación basado en la arquitectura GPT-5, que ofrece a los desarrolladores excelentes capacidades de generación y optimización de código.

Ruta de despliegue: configuración del entorno del sistema ➜ instalación de la herramienta CLI ➜ integración de la API ➜ entorno de desarrollo preparado

🚀 Configuración rápida con CC-Switch (recomendado)

⚠️ Requisito previo

Antes de configurar Codex con CC-Switch, asegúrate de haber instalado globalmente la herramienta Codex mediante npm:

npm install -g @openai/codex@latest
下载压缩包 下载压缩包

Comprueba la instalación: codex --version

Se recomienda utilizar la herramienta de configuración rápida CC-Switch, que ofrece una configuración gráfica sencilla y rápida sin necesidad de usar la línea de comandos.

Pasos de configuración

  1. Inicia CC-Switch y cambia a la pestaña Codex.

La imagen muestra la interfaz de la aplicación CC-Switch. En la parte superior aparecen varias pestañas y una flecha roja señala y resalta la pestaña «Codex». Corresponde a los pasos de configuración de la sección «Configuración rápida con CC-Switch (recomendado)» e indica que, después de iniciar CC-Switch y cambiar a la pestaña Codex, hay que pulsar «Codex» en la parte superior para continuar. Es un paso esencial de la configuración con CC-Switch.La imagen muestra la interfaz de la aplicación CC-Switch. En la parte su…

  1. Abre la aplicación CC-Switch.
  2. Haz clic en la pestaña «Codex» de la parte superior.
  3. Haz clic en el botón «+» naranja de la esquina superior derecha para añadir una configuración nueva.
  4. Rellena la configuración del proveedor de Codex.
  5. Nombre del proveedor: un nombre personalizado (por ejemplo, «gpt-agent»).
  6. Base URL: introduce https://api.llm-token.cn/v1
  7. API Key: pega tu API Key.
  8. Model: selecciona gpt-5.4 (el modelo más reciente en el momento de redactar el documento es 5.4).
  9. Otros ajustes: configura según tus necesidades la intensidad del razonamiento, el acceso a la red y otros parámetros.
  10. Haz clic en «Guardar».

La imagen muestra la interfaz para añadir una configuración nueva en la aplicación CC-Switch. En la parte superior aparecen las pestañas «Proveedor de Codex» y «Proveedor unificado»; la primera está seleccionada. Debajo aparecen «Configuración personalizada» y varios proveedores predefinidos, como OpenAI Official y Shengsuanyun. En la parte inferior hay campos para el nombre del proveedor y las observaciones, junto con los botones «Cancelar» y «Añadir». La imagen está estrechamente relacionada con el contexto: es la interfaz que aparece tras pulsar el botón «+» naranja de la esquina superior derecha y ayuda al usuario a realizar la configuración personalizada.La imagen muestra la interfaz para añadir una configuración nueva en la…

Esta es la interfaz de edición de la configuración de un proveedor en CC-Switch. En la parte superior aparece el icono de la herramienta y hay varios campos de configuración: el nombre del proveedor contiene «Guizhou Cloud Computing», en el campo del sitio web se ve parte de «https:///», la API Key aparece enmascarada y la dirección de solicitud de la API es «https://api.llm-token.cn/v1». En la parte inferior, un aviso amarillo indica que debe introducirse la dirección de un endpoint de servicio compatible con el formato OpenAI Response. En la esquina inferior derecha hay un botón azul «Guardar». La interfaz coincide con los requisitos para rellenar la configuración del proveedor descritos en la guía de despliegue de Codex.Esta es la interfaz de edición de la configuración de un proveedor en CC…

💡 Consejo

  • CC-Switch crea automáticamente los archivos ~/.codex/config.toml y auth.json.
  • Puedes añadir varias configuraciones de proveedor y cambiar entre ellas en cualquier momento.
  • Después de cambiar de configuración, cierra y reinicia Codex para aplicar los cambios.
  1. Activa y usa la configuración.
  2. Busca en la lista la configuración que acabas de crear.
  3. Haz clic en el botón «En uso» situado a la derecha de la configuración.
  4. La configuración quedará marcada como «En uso» con una etiqueta verde.
  5. Reinicia Codex para aplicar la configuración nueva.
  6. Cambio rápido desde la bandeja del sistema.

CC-Switch permite cambiar rápidamente la configuración de Codex desde la bandeja del sistema:

  • Haz clic con el botón derecho en el icono de CC-Switch de la bandeja del sistema.
  • Selecciona la categoría Codex en el menú.
  • Elige directamente la configuración que quieras usar.
  • La configuración se aplica de inmediato, sin abrir la interfaz principal.

⚠️ Notas

  • Después de cambiar de configuración, debes reiniciar Codex para que se aplique.
  • Puedes probar la velocidad del endpoint de la API en CC-Switch.

⌨️ Configuración manual desde la línea de comandos

Si no usas CC-Switch, puedes configurar Codex manualmente siguiendo estos pasos.

🖥️ Windows

Primer paso: desplegar la herramienta de línea de comandos Codex

Abre el símbolo del sistema o PowerShell como administrador y ejecuta:

npm install -g @openai/codex@latestcodex --version

Crea el archivo de configuración config.toml:

model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = true

Crea el archivo de autenticación auth.json:

{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}

Tercer paso: inicializar el espacio de trabajo

mkdir my-codex-projectcd my-codex-projectcodex

🍏 macOS

Desplegar la herramienta Codex

npm install -g @openai/codex@latestcodex --version

Integrar el servicio de API

Crea el directorio de configuración:

mkdir -p ~/.codexcd ~/.codex

Crea la configuración config.toml:

cat > config.toml << 'EOF'model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = trueEOF

Crea la configuración de autenticación auth.json:

cat > auth.json << 'EOF'{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}EOF

Inicializar el espacio de trabajo

mkdir my-codex-projectcd my-codex-projectcodex

🐧 Linux

Desplegar la herramienta Codex

sudo npm install -g @openai/codex@latestcodex --version

1 2

Integrar el servicio de API

Crea el directorio de configuración:

mkdir -p ~/.codexcd ~/.codex

Crea la configuración config.toml:

cat > config.toml << 'EOF'model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = trueEOF

Crea la configuración de autenticación auth.json:

cat > auth.json << 'EOF'{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}EOF

Inicializar el espacio de trabajo

mkdir my-codex-projectcd my-codex-projectcodex

¿Dónde se encuentran los archivos de configuración?

  • Windows: %USERPROFILE%\.codex\
  • macOS/Linux: ~/.codex/

¿No puedes chatear después de configurar el servicio?

Prueba lo siguiente; si aun así no funciona, contacta con el servicio de atención al cliente.

La imagen muestra la interfaz de CC Switch. En la parte superior aparecen el título «CC Switch» y varios iconos. La fila «Guizhou Cloud Computing» tiene un fondo verde, un icono de tres puntos a la izquierda y el estado «Error de consulta» a la derecha. Una flecha roja señala el icono de engranaje de la izquierda. Este icono corresponde a la sección «¿No puedes chatear después de configurar el servicio? Prueba lo siguiente; si aun así no funciona, contacta con el servicio de atención al cliente» y probablemente indica que hay que pulsarlo para realizar la configuración correspondiente.La imagen muestra la interfaz de CC Switch. En la parte superior aparece…

Esta es una captura de la interfaz de ajustes de CC Switch. Varias flechas rojas señalan la pestaña «Proxy» de la parte superior y el estado «En ejecución» dentro de la sección «Proxy local». El módulo permite controlar el servicio de proxy y consultar su estado y la información del puerto; «En ejecución» indica que el servicio de proxy del programa funciona correctamente.Esta es una captura de la interfaz de ajustes de CC Switch. Varias flech…

La imagen muestra la configuración relacionada con el proxy en la página de ajustes de la guía de despliegue de Codex. En la parte superior aparecen las pestañas «General», «Proxy» y «Registros», y «Proxy» está seleccionada. Se muestran el interruptor general del proxy y el control de eco de activación; cuando este está activo, aparecen debajo las opciones Codex y Gemini, y una flecha roja señala Codex. La página también muestra la dirección del servidor proxy, el puerto, el tipo, las capacidades y la configuración del registro de la aplicación, incluido su interruptor. La imagen está relacionada con la solución para cuando no es posible chatear después de configurar el servicio y explica el estado de la configuración del proxy.La imagen muestra la configuración relacionada con el proxy en la página…