跳转到主内容

使用 API 密钥进行编码

使用 Coderen API 密钥可以让你使用与 OpenAI 兼容的 API 的编码工具。该工具向 AI-Corporate 发送请求。AI-Corporate 会检查密钥、预算、有效期和允许的模型。

随后 AI-Corporate 通过环境的技术接口处理申请。

你需要什么？​

你需要三项信息：

信息在哪里可以找到
API 密钥由管理员提供
端点（Endpoint）https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
模型名称例如 gpt-5.6-luna、gpt-5.6-terra 或 gpt-5.6-sol

API 密钥以 aic. 开头。请将此密钥视为密码。

你该选择哪个工具？​

AI-Corporate 建议大多数用户使用 OpenCode。OpenCode 是一个面向终端、桌面和 IDE 的具备代理能力的编码工具。该工具可以独立执行步骤、编辑文件并进一步展开任务。

Aider 在技术上与 OpenAI 兼容的端点兼容，但在企业环境中通常不被推荐为默认工具。

另请参阅 官方 OpenCode 文档。

安全管理密钥​

不要在公开场合分享你的 API 密钥，也不要将其放在与你共享的代码中。

优先使用：

  • 环境变量
  • 不被提交到 Git 的本地 .env
  • 工具的内置配置
注意

切勿将 API 密钥放在公开的代码库、聊天记录、共享文档或截图中。

如果密钥无法工作​

请检查：

  • 是否为该环境开启了 Coderen
  • 密钥是否仍然有效
  • 预算是否已用尽
  • 密钥是否落在设定的有效期内
  • 是否使用了被允许的模型
  • 端点是否设置正确

如有疑问，请让管理员检查密钥。

环境变量与 OpenCode​

对于 OpenCode，你可以将 Coderen API 密钥保存在本地项目目录中的 .env 文件中：

AI_SCHOOL_CODEREN_API_KEY=ais.你的-api-密钥

确保 OpenCode 确实加载了这个环境变量。在 PowerShell 中，你也可以临时将变量设置在当前终端：

$env:AI_SCHOOL_CODEREN_API_KEY="ais.你的-api-密钥"

如果出现 Authorization header with Bearer token is required，则表示工具没有将密钥放在 Authorization: Bearer ... 中。若出现 Unknown parameter，请删除不被 AI-Corporate 的 Coderen 端点支持的提供商特定设置。

WhatsApp