Codificar con claves API

Con una clave API Coderen puedes usar herramientas de programación que trabajan con una API compatible con OpenAI. La herramienta envía solicitudes a AI-School. AI-School verifica la clave, el presupuesto, el periodo de validez y los modelos permitidos.

Luego AI-School procesa la solicitud a través del enlace técnico del entorno.

¿Qué necesitas?

Necesitas tres datos:

Dato	¿Dónde encontrarlo?
Clave API	La obtienes de un administrador o docente
Endpoint	https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Nombre del modelo	Por ejemplo, gpt-5.4-mini, gpt-5.4 o gpt-5.5

La clave API empieza con ais.. Trata esta clave como una contraseña.

¿Qué modelo eliges?

Para la mayoría de los estudiantes, GPT-5.4 mini es el mejor inicio. Este modelo es más económico y adecuado para ayuda de programación en clase.

Para docentes o estudiantes avanzados, puede ser mejor GPT-5.4 o GPT-5.5, por ejemplo para proyectos más grandes o código más complejo.

¿Qué herramienta eliges?

AI-School recomienda dos herramientas:

Herramienta	Recomendado para	Por qué
Aider	Estudiantes y codificación en clase	Funciona de forma explícita, clara y menos orientada a la agencia
OpenCode	Docentes y usuarios avanzados	Herramienta CLI orientada a agentes con una aplicación de escritorio

Aider para estudiantes

Aider funciona como una herramienta de pair-programming en la terminal. El usuario solicita ayuda, ve cambios y se mantiene relativamente cerca del código. Eso encaja bien con aprender a programar: el estudiante recibe apoyo, pero sigue involucrado en lo que ocurre.

Ver también la documentación oficial de Aider.

OpenCode para uso avanzado

OpenCode es más orientado a agentes. La herramienta puede ejecutar pasos de forma independiente, editar archivos y desarrollar tareas. Es potente, pero también requiere más comprensión de código, git y entornos de desarrollo locales.

Ver también la documentación oficial de OpenCode.

Manejo seguro de claves

No compartas tu clave API públicamente y no la coloques en código que compartas.

Usa preferentemente:

• variables de entorno
• un .env local que no se envíe a Git
• la configuración integrada de la herramienta

Para OpenCode, por ejemplo, puedes usar un .env en la carpeta del proyecto:

AI_SCHOOL_CODEREN_API_KEY=ais.tu-clave-api

Asegúrate de que la herramienta cargue realmente este .env. En PowerShell también puedes establecer la variable temporalmente para la terminal actual:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.tu-clave-api"

Atención

Nunca pongas claves API en un repositorio público, chat de Teams, documento compartido o captura de pantalla.

Si la clave no funciona

Verifica entonces:

• si Coderen está activado para el entorno
• si tu clave sigue activa
• si el presupuesto no se agotó
• si la clave está dentro del periodo de validez configurado
• si estás usando un modelo permitido
• si el endpoint está configurado correctamente
• si la herramienta envía la clave API como Authorization: Bearer ...
• si la herramienta no envía parámetros específicos del proveedor que AI-School Coderen no soporta

En caso de dudas, consulta a un administrador o docente para que verifiquen la clave.