跳转到主内容

安装与使用 OpenCode

OpenCode 是一个具备代理能力的编码工具。该工具可作为终端应用、桌面应用与 IDE 扩展使用。

AI-Corporate 建议开发者、管理员及其他高级用户使用 OpenCode。OpenCode 能独立修改文件并完成任务，因此请始终检查建议的更改。

更多信息，请访问 OpenCode 官方网站 OpenCode website 以及 OpenCode 官方文档。

安装​

按 OpenCode 文档 的简单安装方式是：

curl -fsSL https://opencode.ai/install | bash

你也可以用 Node.js 安装 OpenCode：

npm install -g opencode-ai

或在 macOS 与 Linux 上使用 Homebrew：

brew install anomalyco/tap/opencode

连接到 Coderen​

OpenCode 支持 自定义的 OpenAI 兼容提供者。在项目目录中创建一个 opencode.json 文件。

在其中使用 Coderen endpoint 及允许的模型：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-corporate-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Corporate Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_CORPORATE_CODEREN_API_KEY}"
      },
      "models": {
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        }
      }
    }
  },
  "model": "ai-corporate-coderen/gpt-5.6-luna",
  "small_model": "ai-corporate-coderen/gpt-5.6-luna"
}

之后将 API 密钥设置为环境变量。

macOS 与 Linux​

export AI_CORPORATE_CODEREN_API_KEY="aic.你的-api-密钥"

Windows​

setx AI_CORPORATE_CODEREN_API_KEY "aic.你的-api-密钥"

然后在新的终端中打开 OpenCode。

启动 OpenCode​

进入项目目录：

cd 路径/到/你的/项目

启动 OpenCode：

opencode

在 OpenCode 中选择模型，以将 AI-Corporate Coderen 模型设为默认，若尚未自动选择。

使用 OpenCode 的安全注意事项​

由于 OpenCode 是具备代理能力的工具，检查变更十分重要。

推荐的工作流程：

  1. 在一个 git 仓库中工作。
  2. 从小任务开始。
  3. 使用代码前先检查差异（diff）。
  4. 修改后测试应用。
  5. 只提交你理解的变更。

环境变量与 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