# OpenCode 設定指南

> 用 opencode.json 把 OpenCode 設定為 OpenAI 相容供應商，接入 LLMoxy。

網址：[https://opencode.ai（點擊跳轉）](https://opencode.ai)

OpenCode 是開源的終端機 / 編輯器 Agent。自訂供應商請使用 `@ai-sdk/openai-compatible`，不要借用 `google` 這類內建廠商名稱。

開始前請準備一把 [LLMoxy 權杖](https://tw.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://tw.llmoxy.com/docs/code-tutorials/opencode 的 markdown 版本。
