Codificación con claves API
Con una clave API de Coderen puedes usar herramientas de programación que funcionen 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.
Después, AI-School procesa la solicitud a través del puente técnico del entorno.
¿Qué necesitas?
Necesitas tres datos:
| Dato | ¿Dónde puedes encontrarlo? |
|---|---|
| Clave API | La obtienes de un administrador o profesor |
| Endpoint | https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 |
| Nombre del modelo | Por ejemplo gpt-5.6-luna, gpt-5.6-terra o gpt-5.6-sol |
La clave API empieza con ais.. Trátala como una contraseña.
¿Qué modelo eliges?
Para la mayoría de los estudiantes, GPT-5.6 Luna es un buen punto de partida. Este modelo rápido es adecuado para ayuda de programación durante la clase y preguntas de código cotidianas.
Para docentes o estudiantes avanzados, encaja bien GPT-5.6 Terra para proyectos más grandes y código más complejo. Elige GPT-5.6 Sol para tareas más exigentes con mucho análisis, planificación o razonamiento.
¿Qué herramienta eliges?
AI-School recomienda dos herramientas:
| Herramienta | Recomendado para | Por qué |
|---|---|---|
| Aider | Estudiantes y programación en clase | Funciona de forma explícita, clara y menos “agente” |
| OpenCode | Docentes y usuarios avanzados | CLI agentic con una aplicación de escritorio |
Aider para estudiantes
Aider funciona como una herramienta de programación en pareja en la terminal. El usuario solicita ayuda, ve cambios y se mantiene relativamente cercano al código. Eso encaja bien con aprender a programar: el estudiante recibe apoyo, pero sigue participando en lo que ocurre.
Consulta también la documentación oficial de Aider.
OpenCode para uso avanzado
OpenCode es más agentic. La herramienta puede realizar pasos de forma autónoma, editar archivos y desarrollar tareas. Eso es poderoso, pero también requiere más comprensión de código, git y entornos de desarrollo locales.
Consulta también la documentación oficial de OpenCode.
Manejo seguro de claves
No compartas tu clave API públicamente y no la pongas en código que compartas.
Usa preferiblemente:
- variables de entorno
- un archivo local
.envque 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"
Nunca coloques claves API en un repositorio público, en Teams, en documentos compartidos o capturas 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 establecido
- 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 admite
Si tienes dudas, solicita a un administrador o docente que verifique la clave.