如何在 OpenCode 中使用 Corion AI

将来自 api.corion.ai 的 Corion 模型作为自定义 Provider 接入 OpenCode。

1. 前置条件

OpenCode 已安装且可正常运行
从控制台获取的 Corion API 密钥
账户上确切的模型 ID——Corion 目前提供 kimi-k3、deepseek-v4-pro-0813 和 deepseek-v4-flash-0731

2. 获取 API 密钥

3. 配置 OpenCode

创建或编辑 ~/.config/opencode/opencode.json(全局) 或项目中的 opencode.json (项目范围):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "corion": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Corion AI",
      "options": {
        "baseURL": "https://api.corion.ai/v1",
        "apiKey": "{env:CORION_API_KEY}"
      },
      "models": {
        "kimi-k3": {
          "name": "Kimi K3",
          "reasoning": true,
          "tool_call": true,
          "attachment": true,
          "interleaved": { "field": "reasoning_content" },
          "limit": { "context": 1048576, "output": 131072 }
        },
        "deepseek-v4-pro-0813": {
          "name": "DeepSeek V4 Pro 0813",
          "reasoning": true,
          "tool_call": true,
          "attachment": false,
          "interleaved": { "field": "reasoning_content" },
          "limit": { "context": 1048576, "output": 384000 }
        },
        "deepseek-v4-flash-0731": {
          "name": "DeepSeek V4 Flash 0731",
          "reasoning": true,
          "tool_call": true,
          "attachment": false,
          "interleaved": { "field": "reasoning_content" },
          "limit": { "context": 1048576, "output": 65536 }
        }
      }
    }
  }
}

说明:

npm: "@ai-sdk/openai-compatible" 是正确的包——Corion 支持 /v1/chat/completions 接口。
所有 Corion 模型都通过 reasoning_content 流式输出推理过程，因此需要显式设置 interleaved.field（OpenCode 的 Poolside 示例也使用了相同的字段名）。
limit 用于 OpenCode 的剩余上下文指示器。每个想使用的模型添加一个条目；模型 ID 必须与 GET /v1/models 完全一致。

4. 存储 API 密钥

不要将密钥直接写在配置文件中。设置环境变量，然后重启终端:

PowerShell: setx CORION_API_KEY "your-key-here"
cmd: setx CORION_API_KEY "your-key-here"
macOS / Linux: echo 'export CORION_API_KEY="your-key-here"' >> ~/.bashrc && source ~/.bashrc

启动 OpenCode 前，确认密钥能正常列出模型:

curl https://api.corion.ai/v1/models -H "Authorization: Bearer your-key-here"

5. 重启并使用

退出并重启 OpenCode——配置仅在启动时读取。然后运行:

/models

选择 corion/kimi-k3、corion/deepseek-v4-pro-0813 或 corion/deepseek-v4-flash-0731。要在配置中设置默认模型，添加一个顶层键:

{
  "model": "corion/kimi-k3"
}

完成配置后的首个任务应为只读操作——例如“总结这个目录”——以便在允许编辑前确认响应和工具调用是否正常。

故障排查

Provider 未出现在 /models 列表中 —— 配置文件未重新加载；完全退出并重新启动 OpenCode。
401 Unauthorized —— 环境变量缺失或密钥不完整。运行 opencode auth list 确认凭据是否生效，或重新设置变量并重启终端。
模型 ID 被拒绝 —— 检查 ID 是否完全匹配；Corion 的 ID 没有厂商前缀 (kimi-k3, 而非 moonshot/kimi-k3)。

其他请求错误，请参阅错误与重试。

来源: OpenCode providers — custom provider