> ## Documentation Index
> Fetch the complete documentation index at: https://liaobots.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 接入 OpenCode

<img src="https://mintcdn.com/liaobots/2YSbWJrVbDrSSK35/images/API/OpenCode/opencode-icon.png?fit=max&auto=format&n=2YSbWJrVbDrSSK35&q=85&s=9e8f7a828c61e998162f933899b42eac" alt="OpenCode" width="1194" height="600" data-path="images/API/OpenCode/opencode-icon.png" />

## 准备工作

参照[官方文档](https://github.com/anomalyco/opencode)安装命令行版本或[桌面版本](https://opencode.ai/download)的 OpenCode。支持macOS, Windows, Linux。

GPT(CodeX) 和其他模型价格比例请参考 [模型与价格](/Aggregation/Model-Price)，API 地址与备用地址请参考 [API 调用示例](/Getting-Started/cn/API)

## 找到 OpenCode 配置文件

**macOS / Linux:**
`~/.config/opencode/opencode.json`

**Windows:**
`%APPDATA%\opencode\opencode.json`
或者
`<用户目录>\.config\opencode\opencode.json`

## 配置 GPT / CodeX 系列模型

参考下图修改`opencode.json`：

<img src="https://mintcdn.com/liaobots/2YSbWJrVbDrSSK35/images/API/OpenCode/codex.png?fit=max&auto=format&n=2YSbWJrVbDrSSK35&q=85&s=06dd52e9ddf108d11aaf98fdf4edcbe9" alt="CodeX" width="825" height="495" data-path="images/API/OpenCode/codex.png" />

修改 OpenAI provider：

```json theme={null}
    "openai": {
      "options": {
        "baseURL": "https://ai.liaobots.work/codex/v1",
        "apiKey": "您的登录码"
      },
    }
```

调整 opencode 的默认 GPT 模型选单为下图所示：

<img src="https://mintcdn.com/liaobots/2YSbWJrVbDrSSK35/images/API/OpenCode/gpt-models.png?fit=max&auto=format&n=2YSbWJrVbDrSSK35&q=85&s=7785cf9340eaee40bd1387a9ecae6191" alt="gpt-models" width="1047" height="822" data-path="images/API/OpenCode/gpt-models.png" />

## 配置 Claude 系列模型

<img src="https://mintcdn.com/liaobots/2YSbWJrVbDrSSK35/images/API/OpenCode/claude.png?fit=max&auto=format&n=2YSbWJrVbDrSSK35&q=85&s=b37f1fd6ace672bf07ae0b00cb1dc3be" alt="Claude" width="816" height="942" data-path="images/API/OpenCode/claude.png" />

添加自定义 Claude Provider：

```json theme={null}
    "liao-claude": {
      "name": "Liao Claude",
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://ai.liaobots.work/v1",
        "apiKey": "您的登录码"
      },
      "models": {
        "claude-sonnet-4-5-20250929": {
          "name": "Claude Sonnet 4.5"
        },
        "claude-opus-4-5-20251101": {
          "name": "Claude Opus 4.5"
        },
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        },
      }
    }
```

## 配置 Gemini 系列模型

<img src="https://mintcdn.com/liaobots/2YSbWJrVbDrSSK35/images/API/OpenCode/gemini.png?fit=max&auto=format&n=2YSbWJrVbDrSSK35&q=85&s=cd72e04aa50ada6ee514f9083f32c409" alt="Gemini" width="662" height="603" data-path="images/API/OpenCode/gemini.png" />

添加自定义 Provider：

```json theme={null}
    "liao-gemini": {
      "name": "Liao Gemini",
      "npm": "@ai-sdk/google",
      "options": {
        "baseURL": "https://ai.liaobots.work/v1beta",
        "apiKey": "您的登录码",
      },
      "models": {
        "gemini-3-pro-preview": {
          "name": "Gemini 3 Pro"
        },
        "gemini-3-flash-preview": {
          "name": "Gemini 3 Flash"
        },
        "gemini-3-pro-preview-studio": {
          "name": "Gemini 3 Pro Studio"
        },
      }
    }
```

## 配置其他 OpenAI 格式兼容模型

添加自定义 Provider：

```json theme={null}
    "liao-xxx": {
      "name": "Liao xxx",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://ai.liaobots.work/v1",
        "apiKey": "您的登录码",
      },
      "models": {
        "xxx": {
          "name": "xxx"
        }
      }
    }
```
