OpenCode 接入

OpenCode 是一款开源 AI 编程工具。它支持自定义 Provider，可以通过 OpenAI Responses 或 OpenAI 兼容接口调用 LikeAI 平台模型。

1. 安装 OpenCode

macOS 或 Linux 可以使用官方安装脚本：

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

也可以使用 npm、pnpm 或 Homebrew：

npm install -g opencode-ai
# 或
pnpm install -g opencode-ai
# 或
brew install anomalyco/tap/opencode

安装完成后检查命令：

opencode --version

2. 保存 LikeAI API Key

启动 OpenCode：

opencode

在 OpenCode 中输入：

/connect

然后按照下面的顺序操作：

1. 在 Provider 列表中选择 Other。
2. Provider ID 输入 likeai。
3. 粘贴在 LikeAI“API 密钥”页面创建的 sk-...。

WARNING

不要把 API Key 直接写进会提交到 Git 的配置文件。/connect 会将凭据保存在 OpenCode 的本地凭据存储中。

3. 配置 Responses 模型

GPT 和 Codex 类模型优先使用 OpenAI Responses 接口。在项目根目录创建 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "likeai/your-model-name",
  "provider": {
    "likeai": {
      "npm": "@ai-sdk/openai",
      "name": "LikeAI",
      "options": {
        "baseURL": "https://api.likeai520.cc"
      },
      "models": {
        "your-model-name": {
          "name": "LikeAI Model"
        }
      }
    }
  }
}

将两处 your-model-name 替换为平台实际开放的模型名。model 的完整格式是 Provider ID/模型名，例如 likeai/gpt-example。

TIP

如果想让所有项目共用同一份配置，可以把配置写到 ~/.config/opencode/opencode.json。项目根目录中的 opencode.json 优先级更高。

4. 配置 Chat Completions 模型

如果某个模型只通过 /v1/chat/completions 接入，将 Provider 的 npm 改为 @ai-sdk/openai-compatible：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "likeai-chat": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LikeAI Compatible",
      "options": {
        "baseURL": "https://api.likeai520.cc/v1",
        "apiKey": "{env:LIKEAI_API_KEY}"
      },
      "models": {
        "your-model-name": {
          "name": "LikeAI Compatible Model"
        }
      }
    }
  }
}

这种写法从环境变量读取 Key。启动 OpenCode 前设置：

export LIKEAI_API_KEY="sk-your-key"
opencode

Windows PowerShell：

$env:LIKEAI_API_KEY = "sk-your-key"
opencode

5. 选择模型并测试

重新启动 OpenCode，然后输入：

/models

选择 LikeAI 下的模型，再发起一个轻量任务：

请阅读当前项目目录，并用三句话总结项目用途。

如果 LikeAI 后台能看到请求记录，说明接入成功。

常见问题

/models 中没有 LikeAI

检查 opencode.json 是否位于当前项目根目录，JSON 格式是否正确，Provider ID 是否与 /connect 时填写的 likeai 一致。

401 或鉴权失败

重新执行 /connect，选择 Other，并使用相同的 Provider ID 更新 Key。如果使用环境变量，检查 LIKEAI_API_KEY 是否已在启动 OpenCode 的同一个终端中设置。

404 或 model not found

模型名必须和 LikeAI 平台开放的名称完全一致。同时确认 model 使用 likeai/模型名 的完整格式。

Responses 接口不兼容

将 npm 从 @ai-sdk/openai 改为 @ai-sdk/openai-compatible，改用 Chat Completions 接口。如果不确定模型应使用哪种方式，请联系平台管理员。

参考链接

• OpenCode 官方文档：https://opencode.ai/docs/
• OpenCode Provider 配置：https://opencode.ai/docs/providers/
• OpenCode 配置文件：https://opencode.ai/docs/config/