Guía de despliegue de Codex

1. Descargar y abrir CC Switch

Con CC Switch configurarás el acceso a la API. Después usarás Codex CLI para conversar desde la terminal. Elige el instalador de CC Switch 4.0.25 que corresponda a tu equipo.

¿Descargaste otro archivo? El archivo v3.12.2-en.md contiene las notas de la versión. Si al descomprimir solo ves CC-SWITC.14, descarga el instalador de tu sistema que aparece arriba. Puedes dejar la extensión tal como está. Encontrarás otras versiones en la página oficial de versiones.

2. Instalar Codex CLI

En Windows, abre el Símbolo del sistema. En macOS o Linux, abre la terminal. Si ya tienes Codex, ejecuta codex --version. Si aparece el número de versión, pasa al paso 3.

Si es tu primera instalación, instala Node.js LTS, vuelve a abrir la terminal y ejecuta estos dos comandos en orden. El segundo debería mostrar codex-cli seguido de la versión.

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

3. Configurar Guishu AI en CC Switch

Selecciona Codex en la barra lateral, abre la pestaña Direct y pulsa Add Provider (+). En la categoría All, selecciona Custom Configuration.

Pulsa Add al pie de la página. De nuevo en la pestaña Direct, busca la tarjeta «Guishu AI» y pulsa Switch. Si estabas usando el modo de enrutamiento o agregación, el botón se llama Back to direct and use. Cuando la tarjeta muestre In use, abre Codex.

4. Comprobar la primera respuesta en la terminal

Si Codex está abierto, cierra la sesión. Desde la terminal, entra en la carpeta de tu proyecto y ejecuta codex. Si aún no tienes un proyecto, puedes empezar con una carpeta vacía:

mkdir my-codex-project
cd my-codex-project
codex

Escribe en Codex «Responde solo con OK». Si recibes la respuesta, la solicitud se ha completado. Esta prueba consume parte del saldo de tu clave.

¿No recibes respuesta? Si ves el error 401, vuelve a pegar la clave API y comprueba que esté activa. Si el modelo no está disponible, revisa su ID y los permisos de la clave. Si no se encuentra el endpoint, comprueba que la URL termine en /v1 y que Upstream Format esté configurado como OpenAI Responses en las opciones avanzadas.

Opcional: editar los archivos de configuración a mano

Si ya recibiste una respuesta con CC Switch, has terminado. Para configurarlo a mano, edita los dos archivos siguientes en %USERPROFILE%\.codex\ en Windows o en ~/.codex/ en macOS y Linux. Crea la carpeta si aún no existe. Si ya tienes archivos de configuración, haz una copia de seguridad y conserva los demás ajustes.

config.toml — Indica el proveedor, la URL de la API y un modelo al que tenga acceso tu clave.

model_provider = "gpt-agent"
model = "gpt-6.1-terra"

[model_providers.gpt-agent]
name = "LLM API Gateway"
base_url = "https://api.llm-token.cn/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json — Sustituye el valor de ejemplo por tu clave API de Guishu AI, guarda el archivo y vuelve a abrir Codex como en el paso 4.

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}