使用 API 密钥进行编码
使用 Coding API 密钥可以使用与 OpenAI 兼容的 API 的编程工具。该工具向 AI-School 发送请求。AI-School 会检查密钥、预算、有效期和允许的模型。
随后 AI-School 通过环境的技术对接处理请求。
你需要什么？
你需要三项信息：
| 信息 | 在哪里可以找到 |
|---|---|
| API 密钥 | 由管理员或教师提供 |
| 端点 (Endpoint) | https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 |
| 模型名称 | 例如 gpt-5.6-luna、gpt-5.6-terra 或 gpt-5.6-sol |
API 密钥以 ais. 开头。请将此密钥视为密码。
选择哪个模型？
对大多数学生来说，GPT-5.6 Luna 是一个不错的起点。这个快速模型适合课堂中的编程帮助和日常的代码问题。
对于教师或更高级的学生，GPT-5.6 Terra 非常适合更大的项目和更复杂的代码。对于需要大量分析、规划或推理的最具挑战性任务，选择 GPT-5.6 Sol。
选择哪种工具？
AI-School 提供两种工具的建议：
| 工具 | 适合对象 | 原因 |
|---|---|---|
| Aider | 学生和课堂编程 | 使用明确、直观、较少的“代理性” |
| OpenCode | 教师和高级用户 | 指令式 CLI 工具，同时也有桌面应用 |
面向学生的 Aider
Aider 在终端中作为对等编程工具工作。用户请求帮助、查看变更并保持对代码的较高参与度。这符合编程学习的方式：学生获得支持，但仍然参与正在发生的过程。
参见 Aider 官方文档。
面向高级使用的 OpenCode
OpenCode 更具代理性。该工具可以独立执行步骤、修改文件并进一步完成任务。这很强大，但也需要对代码、git 和本地开发环境有更高的理解。
参见 OpenCode 官方文档。
小心处理密钥
请勿将 API 密钥公开分享，也不要将其放在你分享的代码中。
优先使用：
- 环境变量
- 本地
.env，不要随代码提交到 git - 工具的内置配置
例如，在项目文件夹中为 OpenCode 使用 .env：
AI_SCHOOL_CODEREN_API_KEY=ais.你的-api-密钥
确保工具确实加载了这个 .env。在 PowerShell 中，你也可以临时将变量设置为当前终端的会话：
$env:AI_SCHOOL_CODEREN_API_KEY="ais.你的-api-密钥"
注意
请勿在公共仓库、 Teams 聊天、共享文档或截图中放置 API 密钥。
如果密钥无法工作
请检查：
- 是否为该环境开启了 Coding 功能
- 密钥是否仍然有效
- 预算是否已用尽
- 密钥是否落在设定的有效期内
- 是否使用了允许的模型
- 端点是否正确设置
- 工具是否将 API 密钥作为
Authorization: Bearer ...发送 - 工具是否发送了 AI-School Coding 不支持的提供商特定参数
如有疑问，请向管理员或教师请求检查密钥。
