Gerenciar Coderen
Com o Coderen os administradores podem criar chaves de API controladas para ferramentas de programação, como Aider e OpenCode. Usuários então não trabalham com uma chave OpenAI própria, mas com uma chave gerenciada pela AI-School.
Isso torna o Coderen adequado para aulas de programação, projetos e usuários avançados que desejam usar assistência de IA em um ambiente de desenvolvimento local.
Por que chaves de API controladas?
Uma chave de API comum costuma oferecer acesso amplo a uma plataforma externa de IA. No Coderen, o uso passa pela AI-School. Assim, a gestão, custos e relatórios ficam com a escola.
Vantagens importantes:
- Custos sob controle: defina um orçamento por chave.
- Uso reidentificado: consumo, custos e chats vinculados ao usuário.
- Gestão centralizada: crie, imponha limitações e revogue chaves a partir do ambiente de administração.
- Adequado para turmas: crie chaves de uma vez para um grupo de alunos.
Ativar Coderen
O Coderen é ativado no nível do ambiente. Isso pode ser feito por um administrador.
- Vá para Ambiente de Administração → Coderen.
- Clique em Ativar Coderen.
- Leia o aviso sobre custos de assinatura e custos de API.
- Clique em Concordo e Ativar.
Após a ativação, a AI-School processa a ligação técnica em segundo plano. Administradores não precisam gerenciar configurações de projeto externas.
O Coderen pode ter custos de assinatura adicionais. Custos de API são repassados com uma margem. Em caso de dúvidas, entre em contato com a AI-School.
Conceder acesso às escolas
Após a ativação, você decide quais escolas podem usar o Coderen.
- Abra a aba Administração.
- Selecione as escolas que podem usar o Coderen.
- Clique em Salvar Acesso.
Um administrador da escola verá apenas as escolas para as quais o Coderen é permitido e para as quais tem direitos de admin. Para um admin da escola, painéis desnecessários da escola ficam ocultos.
Escolher modelos
Na aba Administração escolha quais modelos OpenAI estarão disponíveis para o Coderen.
A AI-School usa estes modelos:
| Modelo | Uso |
|---|---|
| GPT-5.4 mini | Modelo padrão e econômico, adequado para alunos e assistência de programação comum |
| GPT-5.4 | Modelo mais forte para docentes, alunos avançados e tarefas de programação mais complexas |
| GPT-5.5 | Modelo superior para trabalhos pesados de programação e uso profissional |
Para uso em sala de aula, geralmente é aconselhável começar com o GPT-5.4 mini.
Ferramentas de codificação compatíveis
Coderen funciona com ferramentas que podem usar um endpoint compatível com OpenAI. O usuário terá então três dados necessários:
- a chave de API Coderen
- a URL do endpoint AI-School Coderen:
https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 - um modelo permitido, por exemplo,
gpt-5.4-mini
A AI-School recomenda para a maioria das situações estas duas ferramentas:
| Ferramenta | Recomendado para | Observação |
|---|---|---|
| Aider | Alunos e codificação em grupo | Ferramenta explícita de pair-programming no terminal. Menos agentic e, portanto, mais adequada para aprender a programar. |
| OpenCode | Docentes e alunos avançados | Ferramenta de codificação agentic para terminal, desktop e IDE. Mais poderosa, mas requer mais experiência. |
Além disso, existem outras ferramentas de codificação que podem trabalhar tecnicamente com um endpoint compatível com OpenAI:
| Ferramenta | Tipo | Observação |
|---|---|---|
| Continue | Assistente de IDE para VS Code e JetBrains | Suporta configuração OpenAI com um apiBase personalizado. Útil quando usuários preferem trabalhar a partir da IDE. |
| Cline | Extensão VS Code e CLI | Selecione a provedora OpenAI Compatible e preencha a URL base, chave de API e modelo. Forte agentic; menos adequado para iniciantes sem orientação. |
| Roo Code | Extensão VS Code | Pode trabalhar com um provedor compatível com OpenAI. Verifique bem quais ações o agente executa. |
| Sourcegraph Cody Enterprise | Assistente de codificação corporativo | Relevante principalmente para organizações com Sourcegraph Enterprise. Suporta configuração de modelo openaicompatible em nível organizacional. |
Uma ferramenta é adequada apenas se você puder configurar um URL base OpenAI-compatible próprio. Ferramentas como Claude Code e Codex CLI não são adequadas para Coderen: Claude Code não usa uma API compatível com OpenAI e Codex CLI não oferece configuração adequada para um endpoint Coderen específico. Também ferramentas como Cursor ou Windsurf são apenas utilizáveis se a versão utilizada suportar uma URL base OpenAI-compatible configurável.
Use Aider para alunos inicialmente. Adicione apenas ferramentas agentic como OpenCode, Cline ou Roo Code quando os usuários tiverem experiência suficiente com terminal, git, diffs e gerenciamento local de arquivos.
Relatórios
A aba Relatórios mostra uso e custos para o período escolhido. Por padrão, os últimos 7 dias são exibidos.
O relatório inclui:
- total de solicitações
- custos totais
- número de tokens
- divisão por grupo
- divisão por usuário
Um admin da escola vê apenas relatórios dentro do próprio escopo permitido. Um admin da diretoria vê os relatórios para todo o ambiente.
Desativar Coderen
Você pode desativar o Coderen temporariamente através do botão na barra de ferramentas.
Quando o Coderen estiver desativado:
- chaves de API existentes não podem ser usadas
- relatórios e dados históricos permanecem
- o Coderen pode ser reativado posteriormente
Desativar não remove relatórios existentes.