Gerenciar Codar

Com o Codar, os administradores podem criar chaves de API controladas para ferramentas de programação, como Aider e OpenCode. Os usuários não trabalham com uma chave OpenAI própria, mas com uma chave gerida pela AI-School.

Isso torna o Codar adequado para aulas de programação, projetos e usuários avançados que desejam usar ajuda de IA em um ambiente de desenvolvimento local.

Por que chaves de API controladas?

Uma chave de API comum muitas vezes concede acesso amplo a uma plataforma externa de IA. No Codar, 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 rastreável: consumo, custos e conversas vinculados ao usuário.
• Gestão central: crie, restrinja e revogue chaves a partir do ambiente de gestão.
• Adequado para turmas: crie chaves de uma só vez para um grupo de alunos.

Ativar Codar

Codar é ativado ao nível do ambiente. Isso pode ser feito por um administrador.

1. Acesse Ambiente de Gestão → Codar.
2. Clique em Ativar Codar.
3. Leia o aviso sobre custos de assinatura e custos de API.
4. Clique em Concordo e Ativar.

Após a ativação, a AI-School processa a integração técnica em segundo plano. Administradores não precisam gerenciar configurações de projeto externas.

Custos

Pode haver custos adicionais de assinatura para Codar. Custos de API são repassados com um fator de multiplicação. Em caso de dúvidas, entre em contato com a AI-School.

Conceder acesso às escolas

Após a ativação, determine quais escolas podem usar o Codar.

1. Abra a aba Gestão.
2. Selecione as escolas que podem usar o Codar.
3. Clique em Salvar Acesso.

Um admin escolar vê apenas as escolas onde o Codar está permitido e para as quais ele tem direitos. Para um admin escolar, painéis escolares desnecessários ficam ocultos.

Escolher modelos

Na aba Gestão, escolha quais modelos OpenAI estarão disponíveis para o Codar.

A AI-School usa estes modelos:

Modelo	Uso
GPT-5.6 Luna	Modelo rápido e versátil para alunos e ajuda de programação diária
GPT-5.6 Terra	Modelo poderoso para docentes, alunos avançados e tarefas de programação complexas
GPT-5.6 Sol	Modelo mais avançado para trabalhos de programação exigentes e uso profissional

Para uso em sala de aula, GPT-5.6 Luna é uma opção rápida e acessível. Escolha Terra ou Sol quando uma tarefa exigir mais análise, raciocínio ou passos independentes de programação.

Ferramentas de codificação compatíveis

Codar funciona com ferramentas que possam usar um endpoint compatível com OpenAI. O usuário precisará de três informações:

• a chave API do Codar
• a URL do endpoint AI-School Codar: https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
• um modelo permitido, por exemplo, gpt-5.6-luna

A AI-School recomenda, para a maioria das situações, estas duas ferramentas:

Ferramenta	Recomendado para	Observação
Aider	Alunos e codificação em sala	Ferramenta explícita de pair-programming no terminal. Menos centrada em agente e, portanto, mais adequada para aprender programação.
OpenCode	Docentes e alunos avançados	Ferramenta de codificação centrada em agente para terminal, desktop e IDE. Mais poderosa, mas exige mais experiência.

Além disso, há outras ferramentas de codificação que podem trabalhar tecnicamente com um endpoint compatível com OpenAI:

Ferramenta	Tipo	Ponto de atenção
Continue	Assistente de IDE para VS Code e JetBrains	Suporta configuração OpenAI com um apiBase personalizado. Útil quando usuários desejam trabalhar principalmente a partir da IDE.
Cline	Extensão VS Code e CLI	Selecione provedor OpenAI Compatible e preencha URL base, chave API e modelo. Forte em agente; menos adequado para iniciantes sem orientação.
Roo Code	Extensão VS Code	Pode funcionar com um provedor compatível com OpenAI. Verifique bem quais ações o agente executa.
Sourcegraph Cody Enterprise	Assistente de codificação empresarial	Relevante principalmente para organizações com Sourcegraph Enterprise. Suporta configuração de modelo openaicompatible em nível organizacional.

Nem todas as ferramentas de codificação são automaticamente adequadas

Uma ferramenta é adequada apenas se você puder configurar uma URL base compatível com OpenAI. Ferramentas como Claude Code e Codex CLI não são adequadas para Codar: Claude Code não usa API compatível com OpenAI e Codex CLI não oferece configuração adequada para um endpoint específico de Codar. Também ferramentas como Cursor ou Windsurf só são úteis se a versão utilizada oferecer uma URL base compatível com OpenAI configurável.

Dicas para escolas

Use Aider para alunos primeiro. Adicione ferramentas centradas em agente como OpenCode, Cline ou Roo Code apenas 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
• total de tokens
• detalhes por grupo
• detalhes por usuário

Um admin escolar vê apenas relatórios dentro do escopo permitido. Um admin da gestão vê relatórios para todo o ambiente.

Desativar Codar

Você pode desativar o Codar temporariamente através do botão na barra de ferramentas.

Quando o Codar estiver desativado:

• chaves de API existentes não podem ser usadas
• relatórios e dados históricos permanecem
• o Codar pode ser ativado novamente posteriormente

Desativar não exclui relatórios existentes.