Lo que estás configurando
Los asistentes de codificación en VS Code se comunican con un modelo a través de HTTP. La mayoría usa el formato de API de OpenAI, lo que significa que aceptan una URL base y una clave personalizadas en lugar de la configuración predeterminada del proveedor. Este servicio es compatible con OpenAI, por lo que se integra en cualquier herramienta que ofrezca esa opción.
Ten claro qué hay en el otro extremo. Es un modelo de pesos abiertos ejecutado por un proveedor independiente, ajustado para responder sin rechazos de contenido para uso adulto legal. No es el modelo Codex de OpenAI ni la API oficial de ningún otro proveedor. Solo es texto, con una ventana de 100.000 tokens, llamadas a funciones y modo JSON. Si quieres los detalles de las rutas al estilo de OpenAI, lee la documentación; si solo necesitas la dirección, consulta la página sobre la URL base de la API de Codex.
Aquí tienes los tres valores que debes usar en todas partes:
| Ajuste | Valor |
|---|---|
| URL base | https://api.getcodexapi.com/v1 |
| Modelo | uncensored |
| Cabecera | Authorization: Bearer YOUR_KEY |
Obtén una clave y pruébala primero
Crea una cuenta en la página de claves de API con Google o con correo electrónico y contraseña. Los nuevos usuarios pueden reclamar $0,50 de crédito de prueba con un solo clic, válido durante 7 días, sin necesidad de tarjeta. Luego prueba la clave en un terminal antes de tocar VS Code. Una llamada curl que funcione demuestra que la clave y la URL son correctas, por lo que los errores posteriores se deben a la extensión.
# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"
# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
-H "Authorization: Bearer $CODEX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'La respuesta es un JSON de chat completions y la respuesta incluye el encabezado X-Balance-USD con tu crédito restante. Guarda la clave en una variable de entorno o en el almacenamiento de secretos de la extensión, nunca en un repositorio.
Extensión y CLI de Codex: archivo de configuración
Las herramientas de Codex de OpenAI admiten proveedores de modelos personalizados mediante un archivo de configuración TOML en tu directorio principal, y la documentación de la extensión de VS Code indica que comparte esa configuración con la CLI. Verifica esto con la documentación actual de Codex para tu versión, ya que el formato ha evolucionado.
# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"
[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"Puntos a verificar:
base_urltermina en/v1, sin/chat/completions.env_keyes el nombre de la variable de entorno, no la clave en sí.wire_apiselecciona el formato de la petición. Este servicio acepta tantoPOST /v1/chat/completionscomoPOST /v1/responses. Prueba primero con "chat"; usa "responses" si tu versión de Codex lo requiere.- Inicia VS Code desde un shell con la variable configurada, o reinícialo después de agregar la variable a tu perfil. Un inicio desde la interfaz gráfica en macOS a menudo no ve las exportaciones del shell.
Las herramientas de estilo agente dependen de las llamadas a funciones. Esto es compatible aquí, incluyendo las llamadas a funciones en streaming, pero la calidad varía según el modelo, así que ejecuta una tarea pequeña primero. La página relacionada sobre el uso de la API en Cursor cubre una configuración similar en otro editor.
Continue, Cline y otras extensiones
Las extensiones de terceros tienen su propia pantalla, pero el patrón es constante: elige un proveedor "OpenAI" o "Compatible con OpenAI", luego completa la URL base, la clave y el modelo. Continue utiliza una configuración YAML:
# Continue (config.yaml), model entry
models:
- name: Hosted uncensored
provider: openai
model: uncensored
apiBase: https://api.getcodexapi.com/v1
apiKey: YOUR_KEYCline y Roo Code ofrecen un proveedor "Compatible con OpenAI" en su panel de configuración con los mismos tres campos. Los nombres y menús cambian con frecuencia, así que busca en la documentación propia de la extensión "Compatible con OpenAI" o "URL base personalizada". Si una extensión no tiene un campo para la URL base, no puede usar este endpoint.
Consejos que ahorran tiempo:
- Desactiva la autocompletación de pestañas contra el modelo alojado a menos que quieras una petición en cada pausa. Las acciones de chat y edición son más económicas.
- Establece una ventana de contexto más pequeña en la extensión para ediciones cotidianas. Enviar repositorios completos al modelo cuesta tokens de entrada cada vez.
- Usa una clave diferente por herramienta para saber cuál está usando tu crédito.
Qué tareas del editor se adaptan a este modelo
Un modelo de texto general con una ventana grande es una buena opción para varias tareas cotidianas: explicar código desconocido, escribir pruebas unitarias para una función, convertir un script entre lenguajes, redactar docstrings y expresiones regulares, y reescribir un módulo cuando pegas el archivo completo. La ventana de 100.000 tokens permite que unos pocos archivos medianos más tus instrucciones quepan en una petición, y la generación puede usar lo que quede.
Sé realista con el resto. No es un modelo de codificación especializado con entrenamiento consciente del editor, por lo que las ejecuciones de agentes de varios archivos pueden necesitar más orientación y más verificación de lo que le darías a una herramienta creada para ello. Pide diffs en lugar de archivos completos, revisa cada cambio antes de aceptarlo y ejecuta tus pruebas. Si una tarea necesita contenido que un asistente filtrado rechaza, como la redacción de andamiaje para ficción para adultos o texto de investigación de seguridad para uso legal, un endpoint sin rechazos de contenido es la razón para usar este.
Cuánto cuesta en un editor
Los precios son $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida. Las herramientas de código envían mucho contexto, así que revisa primero los tokens de entrada.
Ejemplo: una petición de edición con 8.000 tokens de contexto de archivo y una respuesta de 600 tokens cuesta 8.000 x $0,15 / 1M + 600 x $0,50 / 1M = $0,0012 + $0,0003 = $0,0015. Un día de 150 de estas peticiones cuesta 150 x $0,0015 = $0,225. Veinte días laborables: $4,50.
Un agente que lee muchos archivos puede enviar 40.000 tokens por paso. A ese tamaño, un paso cuesta $0,006 más la salida, por lo que 100 pasos cuestan unos $0,60 más la salida. Vigila los bucles de agentes. Las peticiones fallidas o rechazadas no se cobran, y el crédito no caduca. Las recargas de $20 a $500 se pueden pagar con tarjeta (Visa, Mastercard, Apple Pay, Google Pay) o cripto. Los planes actuales se enumeran en la página de precios.
Solución de problemas
401 No autorizado
Falta la clave, tiene un espacio extraño o la variable de entorno no es visible para VS Code. Reinicia el editor desde un terminal que tenga la variable.
404 o "modelo no encontrado"
Usa el modelo exacto uncensored y la URL base con /v1 al final.
Errores 429
Una clave completa permite 8 peticiones simultáneas y 300 por minuto; la clave de prueba permite 2 y 60. Una extensión que dispara varias peticiones simultáneas, como autocompletado más chat, puede alcanzar el límite de concurrencia. El código de error es concurrency para demasiadas a la vez y rate_limited para los límites por minuto. Un encabezado Retry-After: 5 significa sobrecarga temporal.
El streaming se detiene
Algunos proxies corporativos almacenan en caché los eventos enviados por el servidor. Prueba desde una red diferente o desactiva el streaming en la extensión.
Las respuestas difieren de lo que viste con otro asistente
Es de esperar. Este es un modelo diferente con sus propias fortalezas. Dale instrucciones claras y específicas y pruébalo con código de tu propio proyecto.
