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

# OpenCode 接入

> 将 OpenCode 接入极鸽，快速开始编码协作

通过以下步骤，你可以将 OpenCode 接入极鸽并开始使用。

## 前置准备

* 你可以访问终端（macOS、Linux 或 Windows）
* 你已有可用的极鸽 API 密钥

## 接入步骤

<Steps>
  <Step title="安装 OpenCode">
    推荐使用官方安装脚本：

    ```bash theme={null}
    curl -fsSL https://opencode.ai/install | bash
    ```

    安装后可用以下命令验证：

    ```bash theme={null}
    opencode --version
    ```
  </Step>

  <Step title="创建极鸽令牌">
    先进入极鸽控制台的**令牌管理**页面，创建新的访问令牌。\
    创建后请保存好令牌，后续将填入配置文件。
  </Step>

  <Step title="配置 OpenCode 提供方">
    编辑 `~/.config/opencode/opencode.json`，填入以下配置：

    ```json theme={null}
    {
      "$schema": "https://opencode.ai/config.json",
      "provider": {
        "jige": {
          "npm": "@ai-sdk/openai",
          "models": {
            "gpt-5.3-codex": {
              "name": "GPT-5.3 Codex",
              "options": {
                "store": false
              },
              "variants": {
                "high": {},
                "low": {},
                "medium": {},
                "xhigh": {}
              }
            }
          },
          "options": {
            "apiKey": "sk-******",
            "baseURL": "https://jige.io/v1"
          }
        }
      },
      "model": "jige/gpt-5.3-codex"
    }
    ```
  </Step>

  <Step title="开始使用 OpenCode">
    在项目目录运行：

    ```bash theme={null}
    opencode
    ```
  </Step>
</Steps>

## 常见问题

### 如何选择 `gpt-5.3-codex high`

在 OpenCode 中先选择模型 `jige/gpt-5.3-codex`，然后按 `Ctrl+T` 循环切换变体，切换到 `high` 即可。\
如果你希望默认就是 `gpt-5.3-codex high`，也可以在该模型配置中设置：

```json theme={null}
"options": {
  "reasoningEffort": "high",
  "store": false
}
```

### 无法连接接口

请检查 `~/.config/opencode/opencode.json` 中 `baseURL` 是否为 `https://jige.io/v1`，并确认当前网络环境可访问极鸽接口。