代码管理
通过 编码（Coderen），管理员可以为编程工具（如 Aider 和 OpenCode）创建受控的 API 密钥。用户无需使用自己的 OpenAI 密钥，而是使用由 AI-School 管理的密钥。
这使得编码适用于编程课程、项目和想在本地开发环境中获得 AI 助力的高级用户。
为什么要受控的 API 密钥？
普通的 API 密钥通常对外部 AI 平台有较宽泛的访问权限。而在 Coderen 中，使用经过 AI-School 的处理。因此，管理、成本和报告均由学校掌控。
主要优点：
- 成本可控：为每个密钥设定预算。
- 使用可追溯：消耗、成本和聊天记录与用户绑定。
- 集中管理：在管理界面创建、限制和撤销密钥。
- 适合课堂使用：一次性为一个学习小组创建密钥。
启用编码
编码在环境级别开启。可由管理员执行。
- 转到 管理环境 → 编码。
- 点击 启用编码。
- 阅读关于订阅成本和 API 成本的警告。
- 点击 同意并启用。
启用后，AI-School 将在后台处理技术连接。管理员无需管理外部项目设置。
开启编码可能涉及额外订阅费用。API 成本将以附加费计费。如有疑问，请联系 AI-School。
为学校赋予访问权限
启用后，您可以确定哪些学校可以使用编码。
- 打开标签页 管理。
- 选择允许使用编码的学校。
- 点击 保存访问权限。
学校管理员仅能看到被允许使用编码且具备管理员权限的学校。对于学校管理员，冗余的学校面板将被隐藏。
选择模型
在 管理 标签中，选择哪些 OpenAI 模型可用于编码。
AI-School 使用的模型包括：
| 模型 | 用途 |
|---|---|
| GPT-5.6 Luna | 适用于学生和日常编程帮助的快速多功能模型 |
| GPT-5.6 Terra | 适用于教师、进阶学生和复杂编程任务的强大模型 |
| GPT-5.6 Sol | 面向高要求的编程工作和专业用途的最先进模型 |
在课堂使用时，GPT-5.6 Luna 是快速且易于上手的起点。需要更多分析、推理或独立编程步骤时，请选择 Terra 或 Sol。
兼容的编码工具
编码适用于可使用 OpenAI 兼容端点的工具。用户需要三项信息：
- 编码 API 密钥
- AI-School 编码端点 URL:
https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 - 允许的模型，例如
gpt-5.6-luna
AI-School 建议在大多数情况下使用以下两种工具：
| 工具 | 适用对象 | 备注 |
|---|---|---|
| Aider | 学生和课堂编程 | 终端中的明确对等编程工具。较少的代理性，因此更适合学习编程。 |
| OpenCode | 教师和进阶学生 | 针对终端、桌面与 IDE 的代理编程工具。功能更强大，但需要更多经验。 |
此外，还有其他编码工具也能通过 OpenAI 兼容端点工作：
| 工具 | 类型 | 注意事项 |
|---|---|---|
| Continue | VS Code 与 JetBrains 的 IDE 助手 | 支持带自定义 apiBase 的 OpenAI 配置。适合在 IDE 中工作时使用。 |
| Cline | VS Code 扩展与 CLI | 选择提供商 OpenAI Compatible，并填写基础 URL、API 密钥和模型。强代理性；对初学者在没有指导时不太友好。 |
| Roo Code | VS Code 扩展 | 可以与 OpenAI 兼容提供商一起工作。请仔细检查代理执行的操作。 |
| Sourcegraph Cody Enterprise | 企业级编码助手 | 主要面向拥有 Sourcegraph Enterprise 的组织。支持在组织层面的 openaicompatible 模型配置。 |
只有在你能设置自己的 OpenAI 兼容基础 URL 时，工具才适用。因此 Claude Code 与 Codex CLI 可能不适用于编码：Claude Code 不使用 OpenAI 兼容 API，Codex CLI 也不提供适用于特定编码端点的配置。此外，Cursor 或 Windsurf 等工具只有在所用版本提供可自由设置的 OpenAI 兼容基础 URL 时才有用。
初学者先使用 Aider。只有当用户在终端、Git、差异比较和本地文件管理方面具备充分经验时，才添加像 OpenCode、Cline 或 Roo Code 这样的代理工具。
报告
标签页 报告 显示所选时期的使用情况与成本。默认显示最近 7 天。
报告包含：
- 总请求数
- 总成本
- 令牌数量
- 按组的细分
- 按用户的细分
学校管理员仅能看到在其许可范围内的报告。管理者可见整个平台的报告。
关闭编码
你可以通过工具栏中的按钮临时关闭编码。
若编码处于关闭状态：
- 现有的 API 密钥将不能使用
- 报告与历史数据将被保留
- 以后可以重新启用编码
关闭不会删除现有报告。
