# OpenCode 配置指南

> 用 opencode.json 把 OpenCode 配成 OpenAI 兼容供应商，接入 LLMoxy。

网址：[https://opencode.ai（单击跳转）](https://opencode.ai)

OpenCode 是开源终端 / 编辑器 Agent。自定义供应商用 `@ai-sdk/openai-compatible`，不要借用 `google` 这类内置厂商名。

开始前准备一把 [LLMoxy 令牌](https://llmoxy.com/docs/get-started/get-token)，建议用 **auto** 分组。

## 接入 LLMoxy

在项目根目录或 `~/.config/opencode/opencode.json` 写入：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "llmoxy/grok-4.7",
  "provider": {
    "llmoxy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LLMoxy",
      "options": {
        "baseURL": "https://llmoxy.com/v1",
        "apiKey": "你的LLMoxy API Key"
      },
      "models": {
        "grok-4.7": { "name": "Grok 4.7" },
        "claude-opus-5-5": { "name": "Claude Opus 5.5" }
      }
    }
  }
}
```

| 字段 | 说明 |
| --- | --- |
| `options.baseURL` | `https://llmoxy.com/v1`，不要再拼 `/chat/completions` |
| `options.apiKey` | LLMoxy 令牌；也可改成 `{env:LLMOXY_API_KEY}` |
| `models` 的 key | 必须和 LLMoxy 模型 ID 完全一致 |
| 顶层 `model` | `供应商ID/模型ID`，例如 `llmoxy/grok-4.7` |

启动 OpenCode 后，用 `/models` 选 `LLMoxy` 下的模型。

> **💡 提示**
> 如果曾经 `opencode auth login openai`，内置 `openai` 供应商可能被 OAuth 劫持。自定义供应商请用独立 ID（如 `llmoxy`），不要复用 `openai`。

本文是 https://llmoxy.com/docs/code-tutorials/opencode 的 markdown 版本。
