安装与使用 OpenCode

OpenCode 是一个具备代理式编码能力的工具。该工具可用作终端应用、桌面应用和集成开发环境插件。

AI-Public 建议开发者、运维以及其他高级用户使用 OpenCode。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 端点和允许的模型：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-public-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Public Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-public-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_PUBLIC_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-public-coderen/gpt-5.6-luna",
  "small_model": "ai-public-coderen/gpt-5.6-luna"
}

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

macOS 与 Linux

export AI_PUBLIC_CODEREN_API_KEY="aip.你的-api-key"

Windows

setx AI_PUBLIC_CODEREN_API_KEY "aip.你的-api-key"

然后再打开一个新的终端。

启动 OpenCode

进入项目目录：

cd 路径/到/你的/项目

启动 OpenCode：

opencode

在 OpenCode 中使用模型选择来选择 AI-Public Coderen 模型（若尚未自动选择）。

使用 OpenCode 的安全工作方式

由于 OpenCode 是代理式工作，检查变更非常重要。

推荐工作流程：

使用 git 仓库。
从小任务开始。
在使用代码前检查差异（diff）。
修改后测试应用。
仅提交你理解的修改。

环境变量与 OpenCode

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

AI_PUBLIC_CODEREN_API_KEY=aip.你的-api-key

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

$env:AI_PUBLIC_CODEREN_API_KEY="aip.你的-api-key"

如果看到 Authorization header with Bearer token is required，则表示工具未将密钥作为 Authorization: Bearer ... 发送。若看到 Unknown parameter，请删除 AI-Public 不支持的提供者特定设置。

安装​

与 Coderen 连接​

macOS 与 Linux​

Windows​

启动 OpenCode​

使用 OpenCode 的安全工作方式​

环境变量与 OpenCode​

安装