OpenCode

OpenCode 是一个开源的终端 AI 编程助手。通过 iCreat 的 OpenAI 兼容接口，可以在 OpenCode 中使用已授权的模型。

前提条件

已在 iCreat 创建 API Key
API Key 已授权目标模型，例如 gpt-5.5（可在模型广场查阅模型 ID）
已安装 OpenCode
网络可访问 https://api.icreat.ai

安装 OpenCode

macOS / Linux

推荐使用官方安装脚本：

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

也可以使用 npm：

npm install -g opencode-ai

macOS 还可以使用 Homebrew：

brew install anomalyco/tap/opencode

Windows

OpenCode 官方推荐在 WSL 中使用。也可以使用以下方式安装：

npm install -g opencode-ai

验证安装：

opencode --version

配置 OpenCode

OpenCode 支持项目级和全局配置：

项目级：项目根目录下的 opencode.json 或 opencode.jsonc
全局：macOS / Linux 的 ~/.config/opencode/opencode.json
Windows：%USERPROFILE%\.config\opencode\opencode.json

推荐使用全局配置，这样所有项目都可以复用；使用项目级配置时，请勿把 API Key 直接提交到代码仓库。

配置文件

将以下内容保存为 opencode.json 或 opencode.jsonc：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "icreat/gpt-5.5",
  "provider": {
    "icreat": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "iCreat AI",
      "options": {
        "baseURL": "https://api.icreat.ai/llm/openai/v1",
        "apiKey": "{env:ICREAT_API_KEY}"
      },
      "models": {
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}

其中：

配置项	说明
`provider.icreat`	自定义 provider 标识，可保持不变
`npm`	OpenCode 使用 OpenAI 兼容协议连接 iCreat
`baseURL`	iCreat OpenAI 兼容接口地址，必须包含末尾的 `/v1`
`apiKey`	从环境变量 `ICREAT_API_KEY` 读取 API Key
`model`	默认模型，格式为 `icreat/<模型编码>`
`models`	可在 OpenCode 模型选择器中使用的模型列表；模型 ID 须与 iCreat 用户模型编码一致

注意

baseURL 应使用 https://api.icreat.ai/llm/openai/v1，不要使用旧的分组路径，也不要省略末尾的 /v1。OpenCode 会在该地址后追加 /chat/completions 等 OpenAI 兼容路径。

设置 API Key

macOS / Linux

export ICREAT_API_KEY="<sk-your-token>"

如果希望每次打开终端都生效，将这行加入 ~/.zshrc 或 ~/.bashrc，然后执行：

source ~/.zshrc

Windows PowerShell

$env:ICREAT_API_KEY = "<sk-your-token>"

如需持久保存环境变量，可在 Windows 系统环境变量中新增 ICREAT_API_KEY，然后重新打开终端。

启动使用

进入项目目录并启动 OpenCode：

cd your-project-folder
opencode

首次使用时，可以执行：

/models

选择 iCreat AI 下的 gpt-5.5，或直接使用配置文件中的默认模型。

OpenCode 也支持通过 /connect 管理 provider 凭证，但 iCreat 的自定义 provider 推荐使用 ICREAT_API_KEY 环境变量，配置更直观，也不会把密钥写入 OpenCode 的凭证文件。

验证连接

在 OpenCode 中发送：

请回复：OpenCode 已成功连接到 iCreat AI。

如果正常收到回复，说明配置成功。

也可以在终端检查配置是否能被 OpenCode 读取：

opencode debug config

常见问题

OpenCode 找不到模型

请检查：

models 中的模型 ID 是否为 iCreat 的用户模型编码
model 是否使用了正确的 provider 前缀，例如 icreat/gpt-5.5
API Key 是否已授权该模型

返回 401 或 Unauthorized

请检查当前终端是否设置了 API Key：