OpenCode

适用边界

OpenCode 适合作为终端 AI 编程工具接入 Ling.AI。推荐用 @ai-sdk/openai-compatible 定义 provider，并把 Base URL 指向 https://api.lingyuncx.com/v1。项目级配置放在仓库根目录的 opencode.json 或 opencode.jsonc，全局配置通常放在 ~/.config/opencode/opencode.json。

准备

• 安装 OpenCode，确认终端中 opencode 命令可用。
• 在 Ling.AI 控制台创建 API Key，并确认 Key、余额、套餐和模型授权可用。
• 请求 GET https://api.lingyuncx.com/v1/models，复制一个当前启用的模型 ID。
• 如果用 CC Switch 统一管理工具 provider，先安装并启动 CC Switch。

直接配置

1. 进入项目目录。 在需要使用 OpenCode 的仓库根目录运行 opencode。
2. 保存凭据。 在 OpenCode TUI 中执行 /connect，选择 Other 或自定义 provider，provider id 建议填 lingai，粘贴 Ling.AI API Key。OpenCode 的凭据通常保存到 ~/.local/share/opencode/auth.json。
3. 创建项目配置。 在项目根目录创建或更新 opencode.json。如果是团队共享配置，文件里只写 provider 和模型，不写真实 API Key。
4. 选择模型。 进入 OpenCode 后执行 /models，选择 lingai/your-model-id。

配置示例

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "lingai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ling.AI",
      "options": {
        "baseURL": "https://api.lingyuncx.com/v1"
      },
      "models": {
        "your-model-id-from-v1-models": {
          "name": "your-model-id-from-v1-models"
        }
      }
    }
  }
}

CC Switch 配置

CC Switch 支持 OpenCode app-specific provider。用它配置 Ling.AI 时，仍然选择 OpenAI Compatible 方向，Base URL 填 https://api.lingyuncx.com/v1。

1. 进入 OpenCode 工具页。 启动 CC Switch，选择 OpenCode。
2. 新增 provider。 点击加号或 Add Provider。
3. 填写名称。 Provider Name 建议填 Ling.AI。
4. 填写 Base URL。 输入 https://api.lingyuncx.com/v1。
5. 填写 API Key。 粘贴 Ling.AI API Key，或使用 CC Switch 支持的本机密钥方式。
6. 填写模型。 Model ID 填 /v1/models 当前返回的真实模型 ID。
7. 启用并验证。 保存后 Enable / Switch，重启 OpenCode，执行 /models 选择 Ling.AI 模型。

验证

1. 运行 opencode，执行 /models，选择 Ling.AI provider 下的模型。
2. 发送只读请求，例如“总结当前仓库的目录结构”。
3. 确认 OpenCode 返回结果。
4. 到 Ling.AI 控制台核对请求状态、模型 ID、usage 和钱包扣费。

参考资料

• OpenCode Providers 文档
• OpenCode Config 文档
• CC Switch 官方仓库